A Unreal Engine (UE) usa o Android Studio e as ferramentas de linha de comando do SDK do Android para baixar e instalar os componentes do SDK do Android necessários para desenvolver projetos Android.
Resumo da instalação
Para instalar o SDK do Android, siga estas etapas:
Execute o turnkey para baixar e instalar automaticamente a versão necessária do Android Studio.
Configure a instalação do Android Studio para baixar as ferramentas de linha de comando do SDK do Android.
Feche o Android Studio e deixe o turnkey continuar instalando os componentes necessários do SDK do Android.
Reinicie o computador.
Essas etapas são explicadas em mais detalhes nas seções a seguir.
Se você não instalar as ferramentas de linha de comando do SDK do Android, o turnkey não conseguirá baixar o NDK do Android e outros componentes necessários. Não pule esta etapa!
Versões necessárias
Estes são os componentes de software necessários para desenvolver projetos Android na Unreal Engine:
Desde 31 de agosto de 2024, a Google Play Store exige que os apps sejam direcionados ao Android 14, que exige o nível 34 de API. Para publicar novos apps na Google Play Store, você deve atualizar para a UE 5.4.4 ou mais recente para suporte ao SDK 34. Apps criados com versões anteriores da UE não serão mais enviados com sucesso.
Para obter mais informações, confira a documentação do Android sobre o requisito de nível de API no destino do Google Play.
Versão atual da UE: 5.6
Versão do Android Studio: Koala 2024.1.2 29 de agosto de 2024
SDK do Android:
Recomendado: SDK 34
Mínimo para compilação: SDK 34
SDK no destino padrão para lançamento em dispositivos: 34
Nível mínimo do SDK de instalação: 26
Lojas diferentes têm seus próprios requisitos mínimos de SDK no destino, que podem ser diferentes dos mencionados acima.
Versão do NDK: r27c
Build-tools: 34.0.0
Java Runtime: OpenJDK 21.0.3 2024-04-16
AGDE v23.2.91+ necessário para depuração AGDE.
Configuração necessária
Para usar este guia de instalação, você deve ter instalado a Unreal Engine 5.4 ou versão mais recente. O processo de instalação do turnkey do Android não está disponível na UE 5.3 ou anterior. Para obter instruções de instalação nessas versões, consulte o Guia de configuração avançada do Android Studio.
Execute o turnkey para começar a instalação do Android Studio
A UE usa um código da ferramenta de automação da Unreal chamada Turnkey para distribuir SDKs entre as equipes. Em geral, o Turnkey exige que você coloque os arquivos de instalação do SDK da plataforma em um local em comum para a equipe. No entanto, como o Android Studio está disponível ao público, o Turnkey pode baixá-lo automaticamente e começar a configuração sem etapas adicionais.
Para obter mais informações sobre o Turnkey, consulte a documentação do Turnkey.
Execute o Turnkey no Unreal Editor
Para executar o processo de instalação do Turnkey do Android pelo Unreal Editor, siga estas etapas:
Abra o Unreal Editor.
Clique em Plataformas > Android > Instalar SDK.
Executar Turnkey com base em uma linha de comando
Para executar o processo de instalação do Turnkey do Android com base numa linha de comando, siga estas etapas:
Abra a linha de comando.
Vá até o diretório de instalação da Unreal Engine e execute o seguinte comando:
Linha de comando
C++RunUAT.bat Turnkey -Command=InstallSDK Platform=Android
Configure o Android Studio e as ferramentas de linha de comando do Android
Independentemente do método usado para executar o Turnkey, ele baixa o Android Studio e inicia a instalação automaticamente. No entanto, antes de continuar, você deve seguir o assistente de instalação e baixar as ferramentas de linha de comando do SDK do Android para que Turnkey possa buscar os outros componentes de que a UE precisa. Para concluir a instalação, siga estas etapas:
Quando precisar escolher os componentes, deixe os componentes padrão habilitados.
Quando precisar escolher o diretório de instalação, use o diretório padrão.
Se você não usar o diretório de instalação padrão, o Turnkey não poderá encontrar os arquivos necessários em uma etapa posterior. Recomendamos fortemente manter o diretório padrão. Para usar um diretório separado, confira o Guia de configuração avançada do Android Studio.
Quando a instalação terminar, abra o Android Studio.
Na caixa de diálogo "Boas-vindas ao Android Studio", clique em "Mais ações" e em "SDK Manager".
Isso abre o menu Configurações do Android Studio, em Aparência e comportamento > Configurações do sistema > SDK do Android.
Clique na aba Ferramentas do SDK.
Marque "Ferramentas de linha de comando do SDK do Android (mais recente)" e clique em Aplicar. Isso baixa as ferramentas de linha de comando, necessárias para configurar automaticamente o Android Studio para a UE.
Clique em OK para fechar a janela Configurações e feche a caixa de diálogo "Boas-vindas ao Android Studio".
Feche o Android Studio e retorne ao Unreal Editor ou à linha de comando.
Finalize e verifique a configuração do SDK
Depois que o Android Studio for fechado, a Turnkey retoma o download e a instalação de outros componentes do SDK do Android. Quando o processo for concluído, aparecerá um prompt informando se a instalação foi concluída com êxito.
Para finalizar a instalação do SDK do Android e garantir que ele funcionará corretamente, siga estas etapas:
Feche o Unreal Editor ou a linha de comando.
Para finalizar as variáveis de ambiente do Android, faça logout na máquina e, em seguida, faça login novamente.
Abra o Unreal Editor e clique em Plataformas > Android. A versão permitida e a versão instalada do SDK devem a mesma, e você não verá um botão para instalar ou reparar o SDK do Android.
Solução de problemas
Se você instalou de um sistema novo, as etapas acima devem resultar em uma configuração de SDK funcional. No entanto, podem surgir conflitos com variáveis de ambiente e instalações antigas. Para obter informações sobre como diagnosticar e corrigir problemas específicos que impedem a configuração do SDK do Android, consulte o Guia de configuração avançada do Android Studio.