iOS

Ren'Py поддерживает создание iOS-приложений, работающих на устройствах iPhone и iPad. Поскольку для создания iOS-приложения требуются программы, разработанные Apple (например, Xcode IDE), iOS-приложения можно создавать только на компьютерах Macintosh.

Обязательная информация

Некоторые из библиотек, используемых Ren'Py в iOS, лицензируются на условиях GNU Lesser/Library General Public License. Для распространения Ren'Py вам необходимо соблюдать условия этой лицензии. Мы полагаем, что включения следующего текста в описание вашего приложения будет достаточно, но для уверенности проконсультируйтесь с юристом.

This program contains free software licensed under a number of licenses, including the GNU Lesser General Public License. A complete list of software is available at https://www.renpy.org/l/license/.

В разработке

Текущая поддержка iOS в Ren'Py находится в стадии разработки. Хотя она уже использовалась для выпуска игр в Apple App Store, стандартный интерфейс Ren'Py не соответствует рекомендациям Apple, и его необходимо будет изменить.

Пожалуйста, сообщите нам о результатах прохождения вашей игрой процесса утверждения в App Store.

Различия платформ

iOS похожа на Android, но отличается от платформ, поддерживаемых Ren'Py и основанных на использовании мыши. Все различия платформы Android применимы и к iOS.

Список видеоформатов, поддерживаемых iOS, можно найти здесь.

Тестирование и эмуляция

В целях тестирования Ren'Py поддерживает два режима эмуляции iOS. Доступ к ним осуществляется с экрана iOS в лаунчере. Оба режима симулируют работу на сенсорном экране таким образом, что события достигают игры только при нажатой кнопке мыши.

iPhone: Этот режим эмулирует iPhone.
Планшет: Этот режим эмулирует iPad.

Хотя эти эмуляторы можно использовать для быстрого тестирования вашего проекта, лучше всего тестировать и на реальном оборудовании. Эмуляторы не учитывают некоторые человеческие факторы, например, размер пальцев пользователя.

Сборка

Сборка игры Ren'Py для iOS в настоящее время является более сложным процессом по сравнению с другими платформами, поддерживаемыми Ren'Py. В настоящее время мы предполагаем, что у вас есть некоторый опыт создания iOS-приложений или вы можете следовать инструкциям Apple.

Начало работы

Прежде чем вы сможете собрать игру на Ren'Py, вам нужно будет настроить свой Macintosh для создания iOS-приложений. Это означает установку Xcode на ваш Mac, регистрацию в iOS Developer Program и создание профиля обеспечения (provisioning profile), который позволит вашим приложениям запускаться на вашем iOS-устройстве.

Руководство App Distribution Quick Start, написанное Apple, объясняет, как всё это настроить. Мы предлагаем проработать его и даже собрать одно из шаблонных приложений, прежде чем переходить к играм на Ren'Py.

Создание проекта Xcode

Первый шаг в создании вашего iOS-приложения — это создание проекта Xcode. Это делается путём выбора "Create Xcode Project" в меню iOS в лаунчере Ren'Py.

Имя проекта Xcode выбирается автоматически на основе имени, которое отображается в лаунчере. Проект настраивается на основе этого имени, но эти настройки можно отредактировать в Xcode.

Проекты Xcode, созданные таким образом, привязаны к конкретной версии Ren'Py. После обновления Ren'Py вы должны создать новый проект Xcode для вашей игры и повторить настройки проекта.

Сборка проекта

После того как проект создан в Ren'Py, его можно открыть в Xcode, выбрав "Launch Xcode" в лаунчере. Как только проект открыт в Xcode, его можно собрать и установить на устройство iOS.

Обновление проекта

Выбор "Update Xcode Project" скопирует последнюю версию вашего проекта Ren'Py в проект Xcode. Это подходит, когда меняются файлы вашего проекта, но не когда обновляется сам Ren'Py.

Настройка

Большинство настроек выполняется в проекте Xcode. Например, иконка, изображения запуска и ориентации — всё это настраивается в Xcode.

Launch Storyboard

При запуске приложения будет отображаться Launch Storyboard (настраиваемый как часть проекта Xcode, вне Ren'Py), пока Ren'Py не будет готов отобразить пользовательский интерфейс игры.

Как только Ren'Py завершит инициализацию, он либо возобновит текущую игру, либо запустит заставку и главное меню.

Генерация

Для упрощения разработки можно заставить Ren'Py генерировать изображения иконок iOS из файлов.

ios-icon.png: Если этот файл присутствует, он будет масштабирован до различных размеров png-файлов, необходимых для создания иконки iOS.

Pyobjus

В iOS и macOS доступна версия Pyobjus, позволяющая продвинутым разработчикам вызывать системные библиотеки.