iOS

Ren’Py支持運行在iPhone和iPad設備上的iOS應用。由於創建一個iOS應用要求蘋果開發程序(比如Xcode IDE)，iOS應用只能在Mac電腦上創建。

語言要求

部分Ren’Py在iOS平台使用的庫需要通過GNU Lesser/Library General Public License的認證。你會需要遵守Ren’Py生成版的認證規則。我們相信下列包含在你app描述裡的語言能夠滿足需求，不過最好能找個律師確認一遍。

這個程序包括一些證書下的自由軟體認證，包括GNU Lesser General Public License。完整的軟體列表參見 https://www.renpy.org/l/license/.

半成品

當前Ren’Py對iOS的支持還是個半成品。儘管已經可以用來向蘋果的AppStore申請發布程序，預設的Ren’Py介面不遵循蘋果的規範，將來會修改。

如果你的遊戲通過了蘋果的AppStore認證流程，請告訴我們。

平台差異

iOS與安卓類似，與Ren’Py支持的基於滑鼠的平台不同。所有關於 安卓平台差異 的內容都適用於iOS。

iOS不支持MultiPersistent。

iOS支持的影片格式列表可以在 這裡 找到。

測試和模擬

處於測試需求，Ren’Py支持兩種iOS模擬模式。這些都通過啟動器的iOS界面接入。兩種模式都模擬了觸控屏，只有在滑鼠按鍵被按下的情況下才會觸發事件消息。

iPhone

這個模式模擬一台iPhone。

Tablet

這個模式模擬一台iPad。

這些模擬器可以用於快速測試項目，當然最好能在真實的硬體上做測試。模擬器不處理那些人為因素導致的事件，比如用戶的“胖手指”。

Packaging

為iOS打包Ren’Py遊戲現在相比其他平台依然是件麻煩的事。我們假設創作者有一些創建iOS應用的經驗，或者能遵守蘋果的規則。

起步

在你打包Ren’Py遊戲之前，你會需要設置你的Mac電腦，用於創建iOS應用程式。這表示在你Mac電腦上安裝Xcode，註冊iOS開發者，並創建讓你的應用能在iOS設備上運行的自動配置文件(provisioning profile)。

由蘋果官方編寫的 App Distribution Quick Start 指導，解釋了如何配置上述內容。我們建議根據官方說明處理，甚至先打包一個模板應用，然後再打包Ren’Py遊戲。

創建Xcode項目

創建iOS應用程式的第一步是創建Xcode項目。在Ren’Py啟動器的iOS菜單中選擇“Create Xcode Project”。

Xcode的項目名會自動選用啟動器中顯示的項目名稱。項目可以基於這個名稱進行訂製，但是那些訂製化可以在Xcode中編輯。

這種方式創建的Xcode項目與特定版本的Ren’Py關聯。在升級Ren’Py後，你必須為遊戲創建一個新的Xcode項目，並重複項目訂製化工作。

建立項目

在Ren’Py中創建項目之後，在啟動器中選擇“Launch Xcode”就能在Xcode中打開了。Xcode打開過的項目，可以生成並安裝在iOS設備上。

更新項目

選擇“Update Xcode Project”，會將你最新版本的Ren’Py項目複製到Xcode項目中。這只適合你的項目文件發生變化的情況，Ren’Py本身的更新並不適用。

訂製化

大多數訂製化都在Xcode項目中實現。例如，圖示、啟動圖片和橫豎屏選項等。

啟動故事板

當應用程式運行時，啟動故事板(Launch Storyboard)會顯示啟動圖片(不是在Ren’Py而是在Xcode項目中配置)，直到Ren’Py準備好顯示遊戲UI。

當Ren’Py完成初始化後，它會恢復當前遊戲，或者運行splash界面和主選單。

生成

為了簡化開發工作，現在Ren’Py可以從文件中生成iOS版本圖示。

ios-icon.png

若文件存在，會自動將圖像縮放為合適的尺寸用作iOS版本圖示。

Pyobjus

在iOS和macOS平台，可以通過 Pyobjus 調用系統庫。