기술 자료

​
​

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
  2. Build results
  3. Troubleshoot Build Automation failures

프로젝트 오류를 인식하지 못하는 경우

Resolve unrecognized project errors in Unity Build Automation and configure project paths correctly.
읽는 시간 1분
최근 업데이트: 10달 전

증상

다음 오류와 함께 빌드가 실패합니다.
[error] Error: unrecognized project! Please check your app configuration - if this is a Unity application, We expect your "Project Subdirectory" to be set to the path which directly contains the ProjectSettings and Assets directories. For a native app, this should be set to the path which directly contains the project file (.xcodeproj, project.properties, etc).

원인

Unity Build Automation은 Unity 프로젝트의 빌드만 지원합니다. 이 오류는
ProjectSettings
와
Assets
폴더가 소스 코드 저장소나 사용자 저장소에서 Unity Build Automation이 타게팅하는 폴더의 하위 디렉토리에 포함되는 경우 가장 흔하게 발생합니다.

해결 방법

프로젝트가 Unity 프로젝트이고 하위 디렉토리에 있는 경우 새 타겟을 생성하고 프로젝트 하위 디렉토리 경로의 이름을 정의할 수 있습니다. 이렇게 하면 Unity Build Automation에서는 이 하위 디렉토리에서 빌드해야 하는 프로젝트를 찾습니다.
Unity Dashboard에서 타겟을 변경하려면 다음 단계를 따릅니다.
  1. Build Automation > Configurations를 선택합니다.
  2. 편집하려는 빌드에서 편집 버튼을 선택합니다.
  3. Basic settings 탭에서 타겟을 편집합니다.
‘UBA - 프로젝트 하위 디렉토리’

‘UBA - 프로젝트 하위 디렉토리’

추가 리소스

  • 향후의 Unity Build Automation에 대한 자세한 내용은 Unity DevOps 로드맵을 참고하십시오.

Copyright © 2026 Unity Technologies
법률 정보개인정보 처리방침쿠키Documentation Terms of Use개인 정보 판매 또는 공유 금지개인정보 보호 선택(쿠키 설정)

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

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

  • 보고 있는 페이지
    • 증상

    • 원인

    • 해결 방법

    • 추가 리소스


이 페이지의 문제 보고