Version: Unity 6.0 (6000.0)
언어 : 한국어
Android 빌드 설정 레퍼런스
Android 프로젝트 익스포트

Android용 애플리케이션 빌드

Android용 Unity 애플리케이션을 빌드하는 방법과 고려해야 할 사항에 대한 다음 지침을 참고하십시오. Android용 빌드 프로세스와 Unity가 사용하는 툴에 대한 자세한 내용은 Unity가 Android 애플리케이션을 빌드하는 방법을 참조하십시오.

애플리케이션을 빌드하는 대신 Unity 프로젝트를__ Gradle__여러 빌드 프로세스를 자동화하는 Android 빌드 시스템입니다. 이러한 자동화로 인해 많은 일반적인 빌드 오류가 발생할 가능성이 감소합니다. 자세한 정보
See in Glossary
프로젝트로 익스포트하여 Android Studio에 임포트할 수도 있습니다. 빌드 파이프라인을 더 세부적으로 제어하고 싶거나, Unity가 애플리케이션용으로 생성하는 Android 앱 매니페스트를 확인 또는 수정하거나, 다른 Android 애플리케이션에 Unity 기반 기능을 통합하려는 경우 유용합니다. 자세한 내용은 Android 프로젝트 익스포트를 참조하십시오.

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

일부 디지털 배포 서비스는 애플리케이션의 초기 설치 크기를 제한합니다. Unity에는 설치 크기를 최적화하는 데 사용할 수 있는 여러 방법이 포함되어 있습니다. 자세한 내용은 배포 크기 최적화를 참조하십시오.

디버깅 목적으로 애플리케이션을 빌드하려는 경우 애플리케이션 패치를 사용하면 애플리케이션을 빌드하는 시간을 줄일 수 있습니다. 자세한 내용은 애플리케이션 패치를 참조하십시오.

빌드 구성

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

  • Player 설정: 애플리케이션의 런타임 및 빌드 설정을 구성합니다.
  • Build Settings: 빌드 시스템 설정을 구성합니다.

퍼블리싱 포맷

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

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

  1. File > Build Profiles를 선택합니다.
  2. Platform 창의 플랫폼 리스트에서 Android를 선택합니다.
  3. Build App Bundle (Google Play)을 활성화합니다. 이 설정은 Export Project가 비활성화된 경우에만 표시됩니다. 프로젝트를 익스포트하고 Android Studio에서 빌드하려면 Export Project를 활성화한 다음 Export for App Bundle을 활성화합니다.

애플리케이션 빌드

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

  1. File > Build Profiles를 선택합니다.
  2. Add Build Profile을 선택하여 Platform Browser 창을 엽니다.
  3. Platform 창의 플랫폼 리스트에서 Android를 선택합니다.
    옵션에 Android가 없는 경우 Install with Unity Hub를 선택하고 설치 지침을 따릅니다. Android 개발용 프로젝트 설정을 참조하십시오.
  4. Add Build Profile을 선택합니다.
  5. 새 빌드 프로파일을 활성 프로파일로 설정하려면 Switch Profile을 선택합니다.
  6. Export Project를 비활성화합니다. Unity 내에서 빌드하는 대신 Android Studio용으로 프로젝트를 익스포트하려면 Android 프로젝트 익스포트를 참조하십시오.
  7. Build and Run 옵션을 사용하여 타겟 기기에서 빌드를 즉시 실행하려면 Run Device를 애플리케이션을 실행할 기기로 설정합니다. 타겟 기기를 Unity에 연결하는 방법에 대한 자세한 내용은 Android 기기의 디버깅을 참조하십시오.
  8. Build 또는 Build and Run을 클릭합니다.
  9. Unity가 애플리케이션을 배치할 대상을 선택합니다. Build and Run을 선택한 경우 Unity는 Run Device에도 애플리케이션을 설치합니다.
  10. Save를 클릭합니다. 그러면 빌드가 시작됩니다.

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

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

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

애플리케이션 서명

Android 애플리케이션을 Android 기기에서 실행하려면 디지털 서명을 받아야 합니다. 애플리케이션 서명에는 다음의 두 가지 유형이 있습니다.

  • 디버그 서명: 새 Unity 프로젝트의 기본 서명 방법입니다. 디버그 서명을 사용하는 애플리케이션은 Android 기기에서 실행할 수 있지만 퍼블리시할 수는 없습니다.
  • 커스텀 서명: 커스텀 서명 정보를 제공할 때 Gradle이 사용하는 서명 방법입니다. 커스텀 서명을 사용하는 애플리케이션은 Android 기기에서 실행할 수 있으며 퍼블리시할 수 있습니다.

커스텀 서명 정보를 제공하려면 키스토어 만들기를 수행하고 퍼블리싱 설정에 로드하십시오.

커스텀 서명 정보를 제공하면 Unity는 보안상의 이유로 키스토어와 키 비밀번호를 디스크에 저장하지 않습니다. 즉, Unity 에디터를 재시작할 때마다 키 비밀번호를 다시 입력해야 합니다. 비밀번호를 입력하지 않고 애플리케이션을 빌드하려고 하면 빌드 프로세스가 실패합니다. Unity 에디터를 열 때마다 비밀번호를 입력하지 않아도 되게 하려면 퍼블리시할 애플리케이션을 빌드하려는 경우에만 커스텀 서명 정보를 제공하는 것이 좋습니다. 기기에서 테스트할 빌드를 생성하려면 커스텀 서명 정보를 제공하지 않고 대신 디버그 서명을 사용해야 합니다.

추가 리소스

Android 빌드 설정 레퍼런스
Android 프로젝트 익스포트