Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Exportando para iOS

Ver também

Esta página descreve como exportar um projeto Godot para iOS. Se você deseja compilar binários de modelo de exportação a partir do código-fonte, leia Compilando para iOS.

Estas são as etapas para carregar um projeto Godot em Xcode. Isso permite que você compile e instale em um dispositivo iOS, compile uma versão para a App Store e faça tudo o que você normalmente pode fazer com xcode.

Atenção

Projects written in C# can be exported to iOS as of Godot 4.2, but support is experimental and some limitations apply.

Requisitos

• Você deve exportar para iOS a partir de um computador executando macOS com Xcode instalado.

• Baixe os modelos de exportação godot. Use o menu Godot: Editor > Gerenciar modelos de exportação

Exportar um projeto Godot para Xcode

No editor do Godot, abra a janela Exportar do menu Projeto Quando a janela de exportação for aberta, clique em Adicionar.. e selecione iOS.

As opções App Store Team ID e (Bundle) Identifier na categoria Aplicação são obrigatórias. Deixá-los em branco fará com que o exportador emita um erro.

Nota

If you encounter an error during export similar to

JSON text did not start with array or object and option to allow fragments not set

then it might be due to a malformated App Store Team ID!

The exporter expects a (10 characters long) code like ABCDE12XYZ and not, e.g., your name as Xcode likes to display in the Signing & Capabilities tab.

You can find the code over at developer.apple.com next to your name in the top right corner.

Depois de clicar em Exportar Projeto, ainda restam duas opções importantes:

• Path é uma pasta vazia que conterá os arquivos do projeto Xcode exportados.

• File será o nome do projeto Xcode e vários arquivos e diretórios específicos do projeto.

Nota

Este tutorial usa exported_xcode_project_name, mas você vai usar o nome do seu projeto. Quando você ver exported_xcode_project_name nos passos seguintes, substitua-o pelo nome que você usou.

Nota

Evite usar espaços ao escolher seu exported_xcode_project_name, pois isso pode corromper seu arquivo de projeto do XCode.

Quando a exportação for concluída, a pasta de saída deverá ficar assim:

Abrindo exported_xcode_project_name.xcodeproj permite você compilar e implementar como qualquer outro aplicativo para iOS.

Considerações de desenvolvimento ativo

O método acima cria um projeto exportado que você possa compilar para lançamento, mas você terá que reexportar toda vez que fizer uma mudança no Godot.

Durante o desenvolvimento, você pode acelerar este processo vinculando seus arquivos de projeto do Godot diretamente no seu aplicativo.

No exemplo a seguir:

• exported_xcode_project_name* é o nome do aplicativo iOS exportado (como acima).

• godot_project_to_export* é o nome do projeto do Godot.

Nota

godot_project_to_export não deve ser igual a exported_xcode_project_name para evitar problemas de assinatura no Xcode.

Etapas para vincular uma pasta de projeto do Godot ao Xcode

1. Comece a partir de um projeto iOS exportado (siga os passos acima).

2. No Finder, arraste a pasta do projeto do Godot para o navegador de arquivos do Xcode.

3. In the dialog, make sure Create folder references is selected. This means you will be able to continue to edit your Godot project in its current location.

4. Veja a pasta godot_project_to_export no navegador de arquivos do Xcode.

5. Exclua exported_xcode_project_name.pck do projeto Xcode.

6. Open exported_xcode_project_name-Info.plist and add a string property named godot_path (this is the real key name) with a value godot_project_to_export (this is the name of your project)

É isso aí! Agora você pode editar seu projeto no editor do Godot e construí-lo no Xcode quando quiser executá-lo em um dispositivo.

Plugins para iOS

Plugins especiais para iOS podem ser usados no Godot. Veja a página Plugins para iOS.

Variáveis de ambiente

You can use the following environment variables to set export options outside of the editor. During the export process, these override the values that you set in the export menu.

iOS export environment variables

Export option	Environment variable
Encryption / Encryption Key	GODOT_SCRIPT_ENCRYPTION_KEY
Options / Application / Provisioning Profile UUID Debug	GODOT_IOS_PROVISIONING_PROFILE_UUID_DEBUG
Options / Application / Provisioning Profile UUID Release	GODOT_IOS_PROVISIONING_PROFILE_UUID_RELEASE

Solução de problemas

xcode-select points at wrong SDK location

xcode-select is a tool that comes with Xcode and among other things points at iOS SDKs on your Mac. If you have Xcode installed, opened it, agreed to the license agreement, and installed the command line tools, xcode-select should point at the right location for the iPhone SDK. If it somehow doesn't, Godot will fail exporting to iOS with an error that may look like this:

MSB3073: The command ""clang" <LOTS OF PATHS AND COMMAND LINE ARGUMENTS HERE>
"/Library/Developer/CommandLineTools/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk"" exited with code 1.

In this case, Godot is trying to find the Platforms folder containing the iPhone SDK inside the /Library/Developer/CommandLineTools/ folder, but the Platforms folder with the iPhone SDK is actually located under /Applications/Xcode.app/Contents/Developer. To verify this, you can open up Terminal and run the following command to see what xcode-select points at:

xcode-select -p

To fix xcode-select pointing at a wrong location, enter this command in Terminal:

sudo xcode-select -switch /Applications/Xcode.app

After running this command, Godot should be able to successfully export to iOS.