Build your application for Android

이 페이지에는 Android용 Unity 애플리케이션을 빌드하는 방법과 빌드 시 알아야 할 고려 사항이 포함되어 있습니다. Android용 빌드 프로세스와 Unity가 사용하는 툴에 대한 자세한 내용은 Unity에서 Android 애플리케이션 빌드 방법을 참조하십시오.

애플리케이션을 빌드하는 대신 Unity 프로젝트를 Gradle 프로젝트로 익스포트하고 이를 Android Studio로 임포트할 수도 있습니다. 이러한 방식은 빌드 파이프라인을 더 많이 제어하거나 Unity가 애플리케이션용으로 생성하는 Android 앱 매니페스트를 확인하거나 수정하고자 하는 경우 또는 Unity로 구동되는 기능을 또 다른 Android 애플리케이션으로 통합하는 경우에 유용합니다. 자세한 내용은 Android 프로젝트 익스포트를 참조하십시오.

Android 애플리케이션을 호스팅하는 몇몇 디지털 배포 서비스에는 빌드 프로세스를 변경할 수 있는 특정 요구 사항이 있습니다. 예를 들어 Google Play는 애플리케이션이 APK가 아닌 Android 앱 번들 (AAB)이어야 합니다. 빌드로 특정 디지털 배포 서비스를 타겟으로 하는 경우 먼저 해당 디지털 배포 서비스에 대한 문서를 참조하여 요구 사항이 다른지 확인하십시오.

Some digital distribution services have a limit on the initial install size of your application. Unity includes multiple methods that you can use to optimize the install size. For more information, see Optimize distribution size.

If you want to build your application for debugging purposes, application patching can help you reduce the time it takes to build your application. For more information, refer to Application patching.

Configure the build

빌드를 생성하기 전에 Unity가 런타임 설정으로 애플리케이션을 빌드하도록 프로젝트를 설정하고 원하는 시스템 프로퍼티를 빌드합니다. 다음과 같이 Unity 빌드를 구성하는 두 가지 설정 세트가 있습니다.

• Player Settings: Configure runtime and build settings for the application.
• Build Settings: Configure build system settings.

퍼블리싱 포맷

Unity는 다음의 퍼블리싱 포맷으로 Android 애플리케이션을 빌드할 수 있습니다.

• APK
• Android 앱 번들 (AAB)

기본적으로 Unity는 APK 퍼블리싱 포맷으로 Android 애플리케이션을 빌드합니다. Unity가 Android 애플리케이션을 AAB로 빌드하게 하려면 다음 단계를 따르십시오.

1. File > Build Settings를 선택합니다.
2. Platform 창의 플랫폼 리스트에서 Android를 선택합니다.
3. Build App Bundle (Google Play)을 활성화합니다. 프로젝트를 익스포트하여 Android Studio에서 빌드하고자 하는 경우 Export Project를 활성화한 다음 Export for App Bundle을 활성화합니다.

Build the application

Android용 Unity 애플리케이션을 빌드하려면 다음 단계를 따르십시오.

1. File > Build Settings를 선택합니다.
2. From the list of platforms in the Platform pane, select Android.
   Note: If Android is greyed out, set up your project for Android development.
3. Disable Export Project. If you want to export your project for Android Studio instead of building it within Unity, refer to Exporting your Android project.
4. If you want to use the Build and Run option to immediately run the build on a target device, set Run Device to the device you want to run the application on. For information on how to connect your target device to Unity, refer to Debugging on an Android device or Debugging on a ChromeOS device, depending on the platform you want to build for.
5. Click either Build or Build and Run.
6. Select the destination for Unity to place the application. If you selected Build and Run, Unity also installs the application on the Run Device.
7. Click Save. This starts the build.

Build and Run을 선택한 경우 Unity가 빌드를 생성할 때 다음을 수행합니다.

• Split Application Binary 플레이어 설정이 활성화되고 Build App Bundle (Google Play) 빌드 설정이 비활성화되는 경우 Unity는 APK에 대한 Android 확장 파일 (OBB)을 빌드하여 기기의 올바른 위치에 배치합니다.
• Development Build 빌드 설정이 활성화되는 경우 Unity는 애플리케이션을 실행하기 전에 프로파일러 터널을 설정하고 CheckJNI를 활성화합니다.

팁: 출력 경로를 처음 지정한 후 Ctrl+B (macOS: Cmd+B) 키보드 단축키를 사용하여 애플리케이션을 빌드하고 실행할 수 있습니다.

Application signing

Android applications must be digitally signed to run on an Android device. There are two types of application signing:

• Debug signing: The default signing method for a new Unity Project. Applications that use debug signing are able to run on an Android device, but you can’t publish them.
• Custom signing: The signing method that Gradle uses when you provide custom signing information. Applications that use custom signing are able to run on an Android device and you can publish them.

To provide custom signing information, create a keystore and load it into Publishing Settings.

When you provide custom signing information, Unity doesn’t store keystores and key passwords on disk for security reasons. This means that you need to re-enter key passwords each time you restart the Unity Editor. If you don’t provide the passwords and attempt to build the application, the build process fails. To avoid entering passwords each time you open the Unity Editor, it’s best practice to only provide custom signing information when you want to build the application to publish. To create a build for testing on a device, don’t provide custom signing information and use debug signing instead.

For more information about application signing, refer to Sign your app.