기술 자료

​
​

Development

User Acquisition

Monetization

산업 분야

Build Automation

DevOps

Build Automation REST API

Build Automation Editor Package

Open Unity Dashboard

Build Automation

​
​
Build Automation
  • Overview
  • Get started with Build Automation
  • Build Automation Glossary
  • Build configuration
  • Advanced build configuration
  • Run builds
  • Check build results
    • Troubleshooting Build Automation failures
      • Builds fail immediately
      • Unrecognized project error
      • Clone hangs when you use Git submodules
      • Lightmap baking
      • Android build failures
      • Errors after migration to a new Xcode version
      • macOS notarization failure
      • Problems with iOS Build Automation during XCode export
      • iOS build can't download or install from Unity Build Automation
  • Optimize build speed
  • Manage consumption costs
  • Sign build artifacts
  • Build Automation integrations
  • Build Automation API
  • Build Automation Editor Package
  • Reference
  1. Unity Build Automation
  3. Build results
  5. Troubleshoot Build Automation failures

Unity Build Automation에서 Android 빌드 실패

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

증상

  • 알 수 없는 이유로 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 버전이나 SDK 버전이 필요합니다.
프로젝트가 로컬에서 빌드하는 경우 사용한 툴의 버전을 기록하고 Unity Build Automation 서비스에서 사용하는 버전과 일치해야 합니다. Gradle의 로컬 버전을 확인하려면 터미널의 
gradle --version
커맨드를 사용합니다.
빌드가 
batchmode
에서 로컬로 작동하지만, 동일한 툴과 버전을 사용하는 Unity Build Automation 서비스에서 오류가 발생하는 경우 지원팀이 추가적인 조사를 할 수 있도록 지원 티켓을 제출하시기 바랍니다. Unity Dashboard에서 티켓을 제출하려면 DevOps를 열고 Help & Support > Ticket > File a ticket을 선택합니다.

추가 리소스

  • 에디터 버전별 기본 Android 툴
Copyright © 2026 Unity Technologies
법률 정보개인정보 처리방침쿠키Documentation Terms of Use개인 정보 판매 또는 공유 금지개인정보 보호 선택(쿠키 설정)

'Unity', Unity 로고 및 기타 Unity 상표는 미국 및 기타 지역 내 Unity Technologies 또는 그 계열사의 상표 또는 등록상표입니다(자세한 내용은 여기에서 확인하세요). 기타 명칭 또는 브랜드는 해당 소유자의 상표입니다.

일부 페이지는 편의를 위해 기계 번역되었으며 부정확한 내용이 있을 수 있습니다. 정보가 상충되는 경우, 영어 버전을 우선으로 참조하세요.

  • 보고 있는 페이지

    • 증상

    • 원인

    • 해결 방법

    • 추가 리소스

이 페이지의 문제 보고