기술 자료

지원

Unity Build Automation에서 Android 빌드 실패

Resolve Android build failures in Unity Build Automation and identify common causes.
읽는 시간 1분최근 업데이트: 한 달 전

증상

  • 알 수 없는 이유로 Android 빌드가 완료되지 않습니다.
  • Android 빌드가 실패하고 다른 타겟은 올바르게 빌드됩니다.
  • Android 빌드가 UBA에서 실패하지만 로컬에서는 작동합니다.

원인

Unity Build Automation은 빌드를 실행하기 위해
batchmode
에서 Unity 에디터를 실행하는 기본 Android 툴(JDK/SDK)을 사용합니다. Android 빌드가 서비스에서 실패하지만 로컬에서 작동하거나 다른 타겟이 올바르게 작동하는 것처럼 보이면 원인은 호환되지 않는 Android 툴에 있는 경우가 종종 있습니다.
Android 툴로 인해 오류가 발생하면 종종 로그에
Gradle Build failed
메시지가 표시됩니다. Gradle은 Unity가 Android 빌드에 사용하는 빌드 시스템입니다.

해결 방법

이 문제를 해결하기 위한 첫 번째 단계로 다음 툴 버전을 사용하여 배치 모드에서 프로젝트를 로컬로 빌드할 수 있는지 확인합니다.
  • Unity 에디터
  • JDK(선택한 버전의 에디터와 함께 제공되는 기본 버전)
  • Android SDK(기본 버전이나 고급 타겟 설정에서 지정한 것 중 하나)
또한 사용 중인 Gradle 버전을 확인해야 합니다. 프로젝트가 로컬에서 빌드하는 경우 사용한 툴의 버전을 기록하고 Unity Build Automation 서비스에서 사용하는 버전과 일치해야 합니다. Gradle의 로컬 버전을 확인하려면 터미널의
gradle --version
커맨드를 사용합니다.
빌드가
batchmode
에서 로컬로 작동하지만, 동일한 툴과 버전을 사용하는 Unity Build Automation 서비스에서 오류가 발생하는 경우 지원팀이 추가적인 조사를 할 수 있도록 지원 티켓을 제출하시기 바랍니다. Unity Dashboard에서 티켓을 제출하려면 DevOps를 열고 Help & Support > Ticket > File a ticket을 선택합니다.

추가 리소스