Android로 내보내기

Android로 내보내려면 Godot를 컴파일하는 것보다 요구사항이 적습니다. 다음 단계는 SDK와 엔진을 설정하는데 필요한 것에 대해 설명합니다.

Android SDK 다운로드하기 에서 Android SDK를 다운로드하고 설치하세요

OpenJDK 또는 Oracle JDK 설치하기

OpenJDK 또는 Oracle JDK를 다운로드하고 설치하세요. JDK 8 버전 아래는 작동하지 않을 것입니다; 일부 사용자가 JDK 7에서 jarsigner (APK를 서명하는데 사용됨)와 관련된 이슈를 제보했습니다.

debug.keystore 만들기

Android는 기기에 설치하고 출시하지 않은 APK를 배포하기 위해 디버그 키스토어 파일이 필요합니다. 이전에 SDK를 사용하고 프로젝트를 만든 적이 있다면, ant나 eclipse가 파일이 있을 것입니다 (Linux와 macOS에서, ~/.android 디렉토리에서 찾을 수 있습니다).

찾을 수 없거나 만들어야 하는 경우, 이 용도를 위해 JDK에서 keytool 명령어를 사용할 수 있습니다:

keytool -keyalg RSA -genkeypair -alias androiddebugkey -keypass android -keystore debug.keystore -storepass android -dname "CN=Android Debug,O=Android,C=US" -validity 9999

adb가 있는지 확인하세요

Android Debug Bridge (adb)는 명령줄 도구로 Android 기기와 통신하는데 사용됩니다. SDK와 함께 설치되지만, SDK 디렉토리에 설치하기 위해 Android API 수준에 맞는 것을 설치해야 할 지도 모릅니다.

Godot에서 설정하기

편집기 설정 화면으로 갑니다. 이 화면은 컴퓨터의 사용자 계정을 위한 편집기 설정을 갖고 있습니다 (프로젝트와는 독립된 것입니다).


Android 설정이 있는 섹션까지 내립니다:


이 화면에서 3개의 파일 경로가 설정되어야 합니다:

  • adb 실행 파일 (Windows에서는 adb.exe)
  • jarsigner 실행 파일 (JDK 6 또는 8에서)
  • 디버그 keystore

일단 구성되면, Android에 내보낼 준비가 끝납니다!

구글 플레이 스토어로 내보내기

APK를 구글 플레이 스토어에 업로드 하려면 비 디버그 키스토어 파일을 서명해야합니다; 그러한 파일은 다음과 같이 생성될 수 있습니다:

keytool -v -genkey -v -keystore mygame.keystore -alias mygame -keyalg RSA -validity 10000

이 키스토어와 키는 개발자 ID를 확인하는데 사용됩니다, 암호를 기억하고 안전한 장소에 보관하세요! APK 서명에 대해 더 자세히 배우고 싶다면 구글 Android 개발자 가이드를 사용하세요.

이제 Android 내보내기 프리셋에서 다음 항목을 채우세요:

  • Release: Enter the path to the keystore file you just generated.
  • Release User: Replace with the key alias.
  • Release Password: Key password. Note that the keystore password and the key password currently have to be the same.

Your export_presets.cfg file now contains sensitive information. If you use a version control system, you should remove it from public repositories and add it to your .gitignore file or equivalent.

Don't forget to uncheck the Export With Debug checkbox while choosing the APK's name.


Optimizing the APK size

By default, the APK will contain native libraries for both ARMv7 and ARMv8 architectures. This increases its size significantly. To create a smaller APK, uncheck either Armeabi-v 7a or Arm 64 -v 8a in your project's Android export preset. This will create an APK that only contains a library for a single architecture. Note that applications targeting ARMv7 can also run on ARMv8 devices, but the opposite is not true.

Since August 2019, Google Play requires all applications to be available in 64-bit form. This means you cannot upload an APK that contains just an ARMv7 library. To solve this, you can upload several APKs to Google Play using its Multiple APK support. Each APK should target a single architecture; creating an APK for ARMv7 and ARMv8 is usually sufficient to cover most devices in use today.

You can optimize the size further by compiling an Android export template with only the features you need. See Optimizing a build for size for more information.