Version: Unity 6.0 (6000.0)
언어 : 한국어
iOS용 빌드 및 배포
iOS 빌드 설정 레퍼런스

iOS 애플리케이션 빌드

Unity로 iOS 애플리케이션을 빌드하는 프로세스는 다음의 두 가지 주요 단계로 구성됩니다.

  1. Unity에서 Xcode 프로젝트를 생성합니다.
  2. Xcode에서 생성된 프로젝트를 애플리케이션으로 빌드합니다.

Unity로 iOS 애플리케이션을 빌드하는 상세한 방법은 Unity로 iOS 애플리케이션 빌드하기에서 확인하십시오.

참고: iOS 애플리케이션을 로컬에서 빌드하려면 개발 머신이 macOS를 사용해야 합니다. Xcode는 macOS 기기에서만 사용할 수 있기 때문입니다. macOS 기기가 없다면 Unity Build Automation을 사용하여 클라우드에서 애플리케이션을 빌드할 수 있습니다.

iOS용 프로젝트를 빌드하기 전에 iOS Player Settings에서 Bundle Identifier를 설정하십시오(메뉴: Edit > Project Settings > Player Settings). 앱이 시뮬레이터를 타게팅할지 실제 기기를 타게팅할지 선택할 수도 있습니다. 이를 위해서는 SDK version 필드를 변경하면 됩니다.

Unity 에디터에서 Xcode 프로젝트 빌드

iOS용 Xcode 프로젝트를 빌드하려면 다음 단계를 따르십시오.

  1. File > Build Profiles를 선택합니다.
  2. Add Build Profile을 선택하여 Platform Browser 창을 엽니다.
  3. Platform 창의 플랫폼 리스트에서 iOS를 선택합니다. iOS 옵션이 없을 경우 Install with Unity Hub를 선택하고 설치 지침을 따르십시오.
  4. Add Build Profile을 선택합니다.
  5. 새 빌드 프로파일을 활성 프로파일로 설정하려면 Switch Profile을 선택합니다.
  6. 프로젝트에 필요한 모든 빌드 설정을 지정합니다.
  7. Build 또는 Build and Run을 선택합니다. Build and Run을 선택하고 macOS 기기를 사용하는 경우, Xcode는 생성된 프로젝트를 애플리케이션에 빌드한 다음 연결된 iOS 기기에 애플리케이션을 설치합니다.
  8. Unity가 Xcode 프로젝트를 빌드할 디렉토리를 선택하거나 생성합니다. 타겟 디렉토리에 Xcode 프로젝트가 이미 존재할 경우, 진행 방법에 대한 옵션을 제공하는 알림이 표시됩니다. 사용 가능한 옵션에 대한 상세 내용은 대체 및 추가 모드를 참조하십시오.

: 타겟 디렉토리를 처음 지정한 후에는 Cmd+B를 사용하여 애플리케이션을 빌드하고 실행할 수 있습니다. Unity는 Append 모드를 사용하여 Xcode 프로젝트를 재생성합니다.

Xcode에서 Xcode 프로젝트를 실행하는 상세한 방법은 앱 빌드 및 실행(Apple 개발자)을 참조하십시오.

대체 및 추가 모드

다른 Xcode 프로젝트가 이미 포함된 디렉토리에서 프로젝트를 빌드하는 경우, Unity는 경고를 표시하고 진행 방법을 선택하도록 합니다. 이때 두 가지 옵션이 주어집니다.

  • Replace: Unity가 타겟 Xcode 프로젝트 디렉토리의 모든 내용을 제거합니다. 이후 Unity는 비워진 디렉토리에 새 Xcode 프로젝트를 생성합니다.
  • Append: Unity는 타겟 Xcode 프로젝트 루트 디렉토리와 하위 디렉토리 DataLibraries의 모든 파일을 제거합니다. 이후 새로 생성된 Xcode 프로젝트 콘텐츠로 해당 디렉토리들을 채웁니다. 그런 다음 Unity는 최신 Unity 프로젝트 변경 사항에 따라 Xcode 프로젝트 파일을 업데이트합니다. Unity는 동일한 Unity iOS 버전으로 생성된 기존 Xcode 프로젝트에 대해서만 이 모드를 지원합니다. 하위 디렉토리 classes의 파일은 제거되지 않으므로 해당 디렉토리에 커스텀 빌트인 코드를 저장할 수 있습니다.

커맨드 라인에서 Xcode 프로젝트 실행

Unity가 Xcode 프로젝트를 생성한 후에는 커맨드 라인에서 Xcode 프로젝트를 빌드하고 실행할 수 있습니다. 그러려면 다음 과정을 수행하십시오.

  1. 터미널 창을 엽니다.
  2. Xcode 프로젝트 디렉터리로 이동합니다.
  3. 애플리케이션을 실행할 기기의 기기 ID를 찾습니다. 이는 Xcode의 Window > Devices and Simulators에서 확인할 수 있습니다.
  4. 터미널에 다음 명령을 입력합니다. 여기서 <device-id>는 장치 ID입니다.
unity$ xcodebuild test -destination "platform=iOS,id=<device-id>" -scheme Unity-iPhone

특정 타겟에 대한 빌드 설정 지정

커맨드 라인 인자를 사용하여 지정한 빌드 설정은 Xcode 프로젝트의 모든 타겟에 적용됩니다. 이를 방지하기 위해 일부 빌드 설정에는 접미사가 붙은 버전이 있으며 이는 빌드 설정이 영향을 주는 타겟을 지정하는 데 사용됩니다. 이는 Xcode > Build SettingsUser-Defined 설정을 통해 구현할 수 있습니다. APP 접미사는 애플리케이션 타겟에 사용되며 FRAMEWORK 접미사는 프레임워크 타겟에 사용됩니다.

xcodebuild를 사용하여 빌드할 경우 접미사가 붙은 버전을 다음 빌드 설정에 대해 사용하십시오.

Xcode 빌드 설정 접미사가 붙은 버전
PRODUCT_NAME PRODUCT_NAME_APP
PROVISIONING_PROFILE PROVISIONING_PROFILE_APP
PROVISIONING_PROFILE_SPECIFIER PROVISIONING_PROFILE_SPECIFIER_APP
OTHER_LDFLAGS OTHER_LDFLAGS_FRAMEWORK

커스텀 빌드 파이프라인에 따라 다른 설정을 포함하도록 이 리스트를 확장할 수 있습니다.

추가 리소스

iOS용 빌드 및 배포
iOS 빌드 설정 레퍼런스