Unity 6.6 iOS 프로젝트를 원격 Mac에서 서명하고 아카이브하는 방법? 2026

Unity 6.6 iOS 프로젝트를 원격 Mac에서 서명하고 아카이브하는 방법? 2026

Unity에서 iOS용 Xcode 프로젝트를 만든 다음, 원격 Mac에서 Xcode 빌드·서명·아카이브를 진행하세요. 아카이브가 만들어져도 업로드나 심사가 완료된 것은 아니므로, 배포 전 검증을 별도로 해야 합니다. Unity 6.6의 내보내기 방식과 실제 프로젝트 의존성이 확인된 경우에 적용하는 절차입니다. Unity 공식 문서는 6.6을 6000.6으로 표기하며, iOS 프로젝트 생성과 Xcode 빌드를 구분합니다. Unity 6.6 iOS 빌드 환경 안내와 Unity iOS 빌드 및 배포 과정에서 현재 프로젝트에 맞는 절차를 먼저 확인하세요.

Windows나 Linux에서 Unity 6.6으로 개발하지만 iOS 배포 빌드가 필요한 개인 개발자에게 적합합니다.
Xcode 프로젝트를 이미 내보냈거나, 서명과 아카이브를 맡길 macOS 환경을 찾는 게임 개발자를 위한 내용입니다.
수동 빌드 과정을 원격 Mac에 연결하려는 소규모 팀도 단계별로 점검할 수 있습니다.

내보내기 전에: Unity 프로젝트와 배포 대상을 고정하세요

Unity에서 Xcode 프로젝트를 내보내는 단계와 Xcode에서 최종 빌드 및 서명을 하는 단계는 별개입니다. 따라서 프로젝트를 옮기기 전에 빌드 결과물이 어떤 용도인지 먼저 정해야 합니다. 개발 중 기기 테스트인지, 배포용 아카이브인지에 따라 서명 방식과 필요한 설정이 달라질 수 있습니다.

Unity의 iOS 빌드 설정에서 대상 기기와 Bundle Identifier, 빌드 종류를 확인하세요. 사용하는 네이티브 플러그인과 사용자 정의 빌드 스크립트도 목록으로 정리합니다. Unity의 iOS 빌드 설정 설명을 기준으로 현재 버전의 항목과 프로젝트 설정을 대조하세요. 메뉴 이름이나 설정 위치가 이전 버전과 같다고 가정하지 말고, 실제 설치 버전의 문서에서 확인해야 합니다.

Unity 6.6이 만든 Xcode 프로젝트는 무엇을 옮겨야 하나요?
개별 프로젝트 파일 하나만 복사하지 말고, 생성된 Xcode 프로젝트와 빌드에 필요한 리소스·원시 코드·설정을 함께 옮기세요. Unity가 만든 프로젝트 구조는 Unity 6.6의 Xcode 프로젝트 구조 안내에서 확인할 수 있습니다. 플러그인이나 별도 의존성의 파일이 프로젝트 밖에 있다면, 해당 플러그인의 공식 설치 방법과 프로젝트의 실제 참조 경로까지 살펴봐야 합니다.

프로젝트를 옮길 때: 파일 누락과 비밀 정보 노출을 막으세요

원격 Mac으로 복사할 때는 완전한 작업 사본을 만드는 것이 중요합니다. Xcode 프로젝트 파일만 있고 연결된 리소스나 네이티브 코드가 빠지면, 로컬과 원격 환경의 빌드 결과가 달라질 수 있습니다. 대용량 파일을 제외하거나 생성물을 다시 만들려는 경우에는 어떤 파일이 재생성 가능하고 어떤 파일이 필수인지 먼저 확인하세요.

팀에서 버전 관리 시스템을 사용한다면 커밋된 상태를 기준으로 원격 Mac에서 작업 사본을 준비합니다. 별도 동기화 도구를 쓴다면 전송 후 파일 목록과 수정 시각을 비교하고, 전송이 끝난 뒤에 빌드하세요. 개발자 인증서의 개인 키, 비밀번호, API 인증 정보를 저장소에 넣지 마세요. 파일 접근 권한도 필요한 사용자와 작업 범위에 맞게 제한합니다. VPSOmni의 원격 Mac 시작 안내를 확인하면 원격 환경에 접속하고 작업을 시작하는 절차를 살펴볼 수 있습니다.

git status --short
git rev-parse HEAD

첫 명령으로 작업 트리에 남은 변경 사항을 확인하고, 다음 명령으로 기준 커밋을 기록할 수 있습니다. 출력은 프로젝트에 따라 달라지므로 실제 결과를 빌드 기록과 함께 보관하세요. 파일을 직접 전송했다면 사용한 원본 위치와 전달한 파일 목록을 기록해 두는 편이 좋습니다.

원격 Mac에서: Xcode와 네이티브 의존성을 확인하세요

원격 Mac에 프로젝트를 받은 직후 아카이브를 시도하기보다, 먼저 Xcode와 프로젝트 의존성을 점검하세요. 필요한 Xcode 버전은 Unity, 플러그인, 대상 SDK가 요구하는 조건에 맞춰야 합니다. 특정 Xcode 버전이 모든 Unity 6.6 프로젝트와 호환된다고 단정할 수는 없습니다. Unity 문서와 각 플러그인 문서를 확인한 뒤 대상 프로젝트에서 재현해야 합니다.

프로젝트가 CocoaPods 같은 의존성 관리자나 사용자 정의 스크립트를 사용한다면, 문서에 적힌 준비 과정을 원격 Mac에서 수행하세요. 처음 열 때 패키지 해석이나 프로젝트 생성이 진행되면 그 결과를 기록합니다. 로컬에서만 설치된 라이브러리나 환경 변수가 있으면 원격 빌드에서 누락될 수 있습니다. Xcode에서 프로젝트나 워크스페이스를 연 뒤 구성 목록을 확인하려면 다음 명령을 사용할 수 있습니다.

xcodebuild -list -project "프로젝트 경로/Unity-iPhone.xcodeproj"

명령이 프로젝트 구성을 읽지 못하면 바로 서명 문제로 판단하지 마세요. 경로가 올바른지, 워크스페이스를 열어야 하는지, 의존성 설치가 빠졌는지부터 분리해서 확인합니다. Unity에서 생성한 프로젝트의 구조와 실제로 열린 항목이 일치하는지도 점검하세요.

서명 설정 단계: 팀과 프로비저닝 정보를 맞추세요

iOS 코드 서명은 Unity 설정 하나로 끝나지 않습니다. Unity 프로젝트의 앱 식별 정보, Xcode 대상의 서명 설정, Apple 개발자 계정의 인증서와 프로비저닝 프로파일이 서로 맞아야 합니다. 특히 Bundle Identifier가 대상 앱과 일치하는지, 올바른 팀이 선택됐는지, 필요한 entitlements가 적용됐는지 확인하세요.

Apple은 인증서 유형과 보호 방법을 인증서 안내에서 설명합니다. 개발 기기용 프로비저닝 프로파일은 Apple의 프로파일 생성 절차를 참고하세요. 개발 테스트와 배포는 서명 목적이 다를 수 있으므로, 현재 빌드 대상에 맞는 자격 증명을 선택해야 합니다. 인증서 개인 키를 팀 저장소나 일반 텍스트 메모에 넣지 말고, 원격 Mac에 저장할 때도 접근 가능한 계정과 권한을 확인하세요.

서명 오류가 나면 인증서부터 다시 만들지 마세요. 먼저 선택한 Xcode 대상, 팀, Bundle Identifier, 프로파일 및 entitlements가 이번 빌드 목적에 맞는지 하나씩 대조하세요.

원격 Mac의 서명 설정은 무엇을 확인해야 하나요?
Xcode 대상의 서명 팀과 앱 식별자, 자동 또는 수동 서명 방식, 프로비저닝 프로파일, 필요한 권한 항목을 확인하세요. 자동 서명을 쓰더라도 대상 프로젝트가 의도한 계정과 앱 식별자를 사용하는지 확인해야 합니다. App Store Connect API 인증 정보는 업로드 자동화에 쓰일 수 있지만 코드 서명 인증서와 같은 자격 증명은 아닙니다. 두 종류를 별도로 보관하고 설정하세요. 서명 항목을 바꿨다면 변경 전후 설정을 기록해 원인을 추적할 수 있게 합니다.

빌드와 아카이브 단계: 실패 지점을 나눠 기록하세요

서명 설정을 확인한 뒤 먼저 대표적인 빌드를 실행해 컴파일 오류와 의존성 문제를 확인합니다. 컴파일이 완료되면 Xcode의 아카이브 절차를 진행하세요. Apple은 배포 전 프로젝트 설정과 아카이브·배포 과정을 각각 Xcode 배포 준비 안내와 Xcode를 통한 베타 테스트 및 배포 안내에서 설명합니다.

문제가 생겼을 때는 발생 단계를 구분하면 재작업을 줄일 수 있습니다.

매번 사용한 커밋, Xcode 버전, 빌드 설정, 오류 로그를 한곳에 기록하세요. 이렇게 해야 프로젝트 변경과 원격 환경 변경을 구분할 수 있습니다. 빌드 성공은 컴파일과 해당 단계의 처리가 끝났다는 뜻이지, App Store Connect가 빌드를 받았거나 심사를 통과했다는 뜻은 아닙니다.

이번 주에는 어떤 방식으로 진행하면 좋을까요?
- 프로젝트가 버전 관리에 있고 의존성이 재현 가능하면, 같은 커밋을 원격 Mac에서 받아 빌드하세요.
- 저장소에 넣을 수 없는 대용량 리소스나 민감한 설정이 있다면, 안전한 파일 전송으로 작업 사본을 만든 뒤 누락 여부를 대조하세요.
- Xcode 버전이나 플러그인 요구 사항을 확인하지 못했다면, 배포용 아카이브보다 의존성 확인과 대표 빌드를 먼저 진행하세요. 필요한 조건을 재현하지 못하면 서명 단계로 넘어가지 말고 프로젝트 담당자와 설정을 확정하세요.

실행 경로 결정: 조건에 맞는 작업 방식을 고르세요

아래 항목을 확인하고, 조건에 맞는 경로를 선택하세요.

업로드 전: 아카이브와 배포 상태를 따로 확인하세요

아카이브가 생성되면 Xcode Organizer에서 올바른 앱과 빌드가 선택됐는지 확인하고, 현재 배포 목적에 맞는 검증을 실행하세요. 버전과 빌드 번호, Bundle Identifier, 서명 정보를 이번 배포 작업의 기준과 대조합니다. 문제가 없을 때만 다음 배포 단계로 진행하세요.

아카이브가 완료되면 App Store Connect에 올릴 준비도 끝난 건가요?
아닙니다. Xcode Organizer에서 아카이브를 검증한 뒤 업로드를 진행하고, App Store Connect에서 빌드 처리 상태를 확인해야 합니다. App Store Connect의 빌드 및 메타데이터 상태 안내는 업로드 이후의 빌드 정보를 확인하는 기준입니다. 처리 중이거나 문제가 표시되면 Xcode에서 아카이브가 만들어졌다는 사실만으로 배포 가능하다고 판단하지 마세요. TestFlight 배포나 App Store 제출도 별도의 상태 확인이 필요합니다.

여러 환경을 오가면 파일 동기화, 플러그인 설치, 서명 키 보호와 빌드 기록 관리가 각각 운영 부담이 됩니다. 전용 Mac을 직접 구매하면 장기적으로 계속 쓰는 작업에 적합할 수 있지만, 초기 구매 비용과 장비 관리가 필요하고 물리 장치를 직접 연결해야 하는 작업에는 실제 Mac 접근 방식도 따져야 합니다. 일시적인 릴리스나 원격 검증 환경이 필요한 경우에는 원격 Mac을 빌려 필요한 기간에만 Xcode 빌드와 아카이브를 수행하는 편이 맞을 수 있습니다. VPSOmni의 원격 Mac 서비스 안내에서 이용 조건을 확인한 뒤, 현재 Unity 프로젝트의 Xcode 요구 사항과 서명 절차를 충족하는지 먼저 대조하세요.

원격 맥에서 앱 서명과 아카이브를 진행하세요

VPSOmni의 전용 실물 맥에서 프로젝트를 빌드하고 서명한 뒤 아카이브까지 이어서 진행하세요.

원격 Mac 대여

다음 단계: 프로젝트에 맞는 요금제 선택

기종, 이용 기간, 접속 방식을 먼저 확인한 뒤 대여 여부를 결정하세요.