이 주제에서는 Godot 프로젝트를 Android 앱으로 내보내는 방법을 설명합니다. Godot은 로컬 기기 테스트용 APK 파일과 Google Play 스토어 제출용 Android App Bundle을 모두 생성할 수 있습니다.
Android 빌드 템플릿 설치
Godot은 빌드 템플릿을 출발점으로 사용하여 Android 앱을 만들고 빌드하는 데 필요한 Gradle 파일과 기타 데이터를 생성합니다. Android 빌드를 내보내기 전에 빌드 템플릿을 Godot 프로젝트로 가져와야 합니다. Godot 버전마다 자체 템플릿이 있습니다. 프로젝트에 Android 빌드 템플릿을 설치하려면 다음 단계를 따르세요.
- Godot 편집기에서 프로젝트를 엽니다.
- 메뉴 바에서 Project -> Install Android Build Template…을 선택합니다.
- Manage Templates… 버튼을 클릭합니다.
- Export Template Manager 창에서 사용 중인 Godot 버전 (현재 버전)의 Download 버튼을 클릭합니다.
- 미러 위치를 선택하여 파일을 다운로드합니다.
- 다운로드가 완료되면 Export Template Manager 창에서 Close 버튼을 클릭합니다.
- 편집기 메뉴 바에서 Project -> Install Android Build Template…을 선택합니다.
- 확인 대화상자가 표시됩니다. Install 버튼을 클릭합니다.
빌드 템플릿 파일은 프로젝트 루트 디렉터리의 상대 android/build 하위 디렉터리에 저장됩니다. 이 하위 디렉터리의 크기로 인해 프로젝트의 버전 제어 범위에서 이 하위 디렉터리를 생략하는 것이 좋습니다.
Android 내보내기 사전 설정 추가
프로젝트에 대해 Android용 내보내기 사전 설정을 만들어야 합니다. 사전 설정을 만들려면 다음 단계를 수행하세요.
- 편집기 메뉴 바에서 Project -> Export…를 선택합니다.
- Export 창에서 Add... 드롭다운 메뉴를 선택한 후 다음과 같이 Android 옵션을 선택합니다.
Android 내보내기 옵션 맞춤설정
프로젝트에 Android 내보내기 사전 설정을 만든 후 Export 창에서 새 사전 설정을 선택하여 내보내기 옵션을 구성할 수 있습니다. 내보내기 옵션은 내보내기 창의 오른쪽에 카테고리별로 그룹화됩니다. 일반적으로 조정할 옵션은 다음과 같습니다.
내보내기 형식 및 맞춤 빌드 사용
Export Format 옵션은 APK 파일로 내보낼지 또는 Android App Bundle(.AAB)로 내보낼지 여부를 나타냅니다. 개발 중에 로컬 기기에서 테스트하는 경우 adb를 사용하여 직접 설치할 수 있으므로 APK 파일이 더 편리합니다. Google Play에 업로드하려는 빌드에는 Android App Bundle을 사용하세요.
Use Custom Build 옵션은 Godot에서 자체 내부 빌드 프로세스를 사용할지 아니면 기존 Gradle 빌드 프로세스를 사용할지 여부를 제어합니다. Use Custom Build가 선택되면 Godot에서 Gradle 빌드를 실행합니다. 다음 조건 중 하나라도 해당하는 경우 Use Custom Build를 선택해야 합니다.
- Export Format은 Android App Bundle로 설정됩니다.
- 프로젝트에서 Godot Android 플러그인 시스템 사용
아키텍처
Architectures 섹션은 빌드에 포함할 CPU 아키텍처를 지정합니다. 여러 아키텍처가 포함된 빌드를 내보내면 내보낸 APK 또는 AAB 파일의 크기가 늘어나므로 기기에 내보내고 배포할 때 반복 시간이 늘어납니다. 개발 중에는 테스트 기기의 아키텍처만 선택하여 반복 시간을 줄일 수 있습니다. Google Play에 제출할 때 프로젝트에서 지원하는 모든 아키텍처를 사용하여 내보내야 합니다.
키 저장소
Keystore 섹션에서는 디버그 및 출시 키 저장소 파일이 구성되어 있습니다. 내보낸 앱에 디지털 서명할 때 사용됩니다. Debug 및 Release 필드는 각 키 저장소 파일의 경로여야 합니다. Debug User 및 Release User 필드는 키 저장소의 별칭 이름으로 설정해야 합니다.
디버그 키 저장소 파일이 전역 Editor Settings -> Export -> Android 섹션에 구성된 경우 프로젝트 내보내기 옵션의 Debug 키 저장소 필드를 비워 둘 수 있으며 전역 디버그 키 저장소 파일이 기본값으로 사용됩니다.
Google Play 스토어에 업로드할 빌드를 만들려면 Android 스튜디오를 사용하여 출시 키 저장소 파일을 만들면 됩니다.
앱의 출시 키 저장소 파일을 만들려면 다음 단계를 따르세요.
- Android 스튜디오를 시작합니다.
- Welcome to Android Studio 창에서 Create New Project를 선택합니다.
- No Activity 템플릿을 선택하고 Next를 클릭합니다.
- Configure Your Project 화면에서 Finish를 클릭하여 프로젝트를 만듭니다.
- 업로드 키 및 키 저장소 생성의 지침을 사용하여 키 저장소 파일을 만듭니다.
- 키 저장소 파일을 만든 후 Android 스튜디오를 종료하고 Godot 편집기로 돌아갑니다.
- 키 저장소 파일을 Release 필드에 추가하고 Release User 및 Release Password 값을 해당 필드에 입력합니다.
버전 및 패키지
버전 및 패키지 섹션은 앱의 버전 코드, 버전 문자열, 패키지 식별자, 패키지 이름을 지정합니다. 고유 이름 필드는 Google Play Console에서 앱이 사용하는 패키지 식별자로 설정해야 합니다.
런처 아이콘
Launcher icons 섹션은 앱의 아이콘으로 사용할 .png 파일을 지정합니다. 아이콘 파일을 지정하지 않으면 Godot에서 기본 아이콘 파일을 사용합니다. Godot은 레거시 애플리케이션 아이콘과 Android 8 이상에서 사용할 수 있는 적응형 아이콘 지정을 모두 지원합니다. 적응형 아이콘 만들기에 관한 도움말은 적응형 아이콘 가이드를 참고하세요.
빌드 내보내기
빌드를 내보내려면 다음 단계를 따르세요.
- Godot 메뉴 바에서 Project -> Export…를 선택합니다.
- 사전 설정 목록에서 Android 내보내기 사전 설정을 선택합니다.
- Export 창 하단에 있는 Export Project 버튼을 클릭합니다.
- Save a File 대화상자에서 내보낸 파일의 이름을 선택합니다.
- Export with Debug 체크박스를 선택 해제하여 출시 빌드를 만듭니다.
- Save를 클릭하여 빌드를 내보냅니다.
내보내기 사전 설정에서 Use Custom Build 옵션이 선택되어 있으면 내보내기 진행 상황 창이 다르게 표시됩니다. 맞춤 빌드는 Gradle 빌드 프로세스의 출력을 표시합니다.