Apple App Store 및 Mac App Store용 설정

개요

이 가이드에서는 Unity 게임이 인앱 구매 스토어와 상호작용하는 데 필요한 디지털 기록과 관계를 설정하는 프로세스를 설명합니다. 주로 Unity IAP 구매 API를 다룰 것입니다.

인앱 구매(IAP)란 디지털 재화를 취득하는 금전 거래 프로세스입니다. 사용자는 플랫폼의 스토어에서 디지털 재화인 상품을 구매할 수 있습니다. 이러한 상품에는 일반적으로 문자열 데이터 유형인 식별자가 있습니다. 상품에는 그 사용 기간을 나타내는 유형이 있으며, 그 중 가장 일반적인 것은 구독, 소모품(재구매 가능), 비소모품(한 번만 구입 가능)입니다.

Apple 앱 스토어

시작

1. Unity IAP를 구현하는 게임을 작성합니다. Unity IAP 초기화를 참조하십시오.

2. 나중에 iTunes Connect에서 사용하기 위해 게임의 상품 식별자를 보관합니다.

   

애플리케이션 등록

1. Apple Developer Center에서 해당 Identifiers 섹션으로 이동합니다.

2. 새 App ID를 추가하여 Apple에서 필수 애플리케이션 엔티티를 만듭니다.

   참고: 명시적 App ID를 사용하십시오. 인앱 구매를 사용하는 애플리케이션에는 와일드카드 App ID(com.example.*)를 사용할 수 없습니다.

   참고: App ID는 Developer Center에서 만들어 iTunes Connect에서 사용할 수 있습니다.

   

3. iTunes Connect로 이동해 앱을 만들어 게임과 스토어 관계를 수립합니다.

   

4. 새로 만든 App ID를 앱의 Bundle ID로 사용합니다.

   

인앱 구매 추가

1. Features 를 선택하고 더하기(‘+’) 버튼을 사용하여 새 인앱 구매를 추가합니다.

   

2. Product Type을 선택합니다.

   

3. Product Identifier를 지정하고 요청에 따라 나머지 필드를 작성합니다.

   참고: 여기서 Product ID는 게임 소스 코드에서 사용되는 것과 동일한 식별자로, AddProduct() 또는 AddProducts() 를 사용하여__ Unity IAP__Unity In App Purchase(인앱 결제) 의 약어입니다.
   See in Glossary ConfigurationBuilder 인스턴스에 추가됩니다.

   참고: 여러 Apple 기기 그룹을 타게팅하는 경우(예: iOS와 Mac 모두에서 제공되는 경우), Apple은 각 기기 그룹에 대해 서로 다른 고유의 제품 식별자를 사용하도록 요구합니다. Unity IAP의 Purchasing.IDs 클래스를 사용하여 제품 ID와 스토어별 식별자의 일대다 매핑을 정의하고 IAP 초기화 시 해당 매핑을 전달합니다.

   

4. 결과:

   

IAP 테스트

1. 테스트 기기의 iTunes 계정에서 사용할 iTunes Connect를 사용하여 Sandbox Testers 를 생성합니다. 이를 위해 iTunes Connect > Users and Roles 로 이동하여 더하기(‘+’) 버튼을 선택합니다. Apple의 Sandbox Tester 기술 자료에서 사용과 관련된 주요 참고 사항을 확인하십시오. Tester를 생성할 때는 실제 이메일 주소를 사용해야 합니다.

   참고: 자세한 내용은 iOS 및 Mac 앱 스토어 가이드를 참조하십시오.

   팁: 이메일 주소를 간편하게 관리하려면 Gmail, iCloud, Outlook.com과 같이 하위 주소 지정(emailaccount+subaddress@example.com)이 가능한 이메일 서비스를 사용하십시오. 그러면 하나의 이메일 계정에서 여러 하위 주소의 이메일을 수신할 수 있습니다.

   

2. 사용자 생성 마법사를 완료합니다.

   

3. Unity를 사용하여 게임의 Xcode 프로젝트를 빌드합니다.

   참고: Unity의 번들 식별자(Edit > Project Settings에서 Other Settings 카테고리를 선택한 후 Bundle Identifier 섹션으로 이동))가 iTunes Connect의 번들 식별자와 일치하는지 확인하십시오.

4. 게임의 Xcode 프로젝트에서 팀(Project Navigator > your game Target > General > Identity > Team)이 Apple 개발자 계정의 팀으로 설정되어 있는지 확인합니다.

   

iOS의 경우

1. 타겟 iOS 기기를 사용하여 기존 Apple ID 계정에서 로그아웃합니다. 나중에 앱에 프롬프트 메시지가 표시되는 경우에만 Sandbox Tester로 로그인합니다. 이후 구매는 Production Store가 아닌 Apple Sandbox를 통해 전달됩니다.

   

2. iOS 기기에서 게임을 빌드하고 실행합니다. 모든 항목이 올바르게 설정된 경우 UnityPurchasing.Initialize()가 성공합니다.

3. 기기에서 게임을 실행해 구매를 하여 IAP를 테스트합니다. 해당 구매가 Sandbox 환경에서 수행되었음을 설명하는 수정된 구매 다이얼로그가 표시됩니다. 구매 메시지가 표시되면 Sandbox User Tester 비밀번호를 사용합니다.

   경고: 표시가 없으면 상품 대금이 실제로 계정에 청구됩니다.

   

Mac의 경우

1. 데스크톱 Mac 빌드를 빌드하는 경우 Unity의 Mac Player 설정에서 Mac App Store Validation 을 선택합니다.

2. 앱을 빌드한 후 번들 식별자와 버전 문자열을 사용하여 해당 info.plist 파일을 업데이트합니다. .app 파일을 마우스 오른쪽 버튼으로 클릭해 Show Package Contents 를 클릭하고, info.plist 파일을 찾아 CFBundleIdentifier 문자열을 애플리케이션의 번들 식별자로 업데이트합니다.

3. 애플리케이션을 서명하고 패키징하고 설치합니다. “your.app” and “your.pkg”를 적절히 채워서 다음 명령을 OSX 터미널에서 실행합니다.

   팁: 번들에 서명하려면 먼저 Contents.meta 파일이 your.app/Contents/Plugins/unitypurchasing.bundle/Contents.meta에 존재하는 경우 이를 제거해야 합니다.

   1. codesign -f --deep -s "3rd Party Mac Developer Application: " your.app/Contents/Plugins/unitypurchasing.bundle

   2. codesign -f --deep -s "3rd Party Mac Developer Application: " your.app

   3. productbuild --component your.app /Applications --sign "3rd Party Mac Developer Installer: " your.pkg

4. 패키지를 올바르게 설치하려면 새로 만든 패키지를 실행하고 설치하기 전에 패키지를 푼 .app 파일을 삭제합니다.

5. Applications 폴더에서 앱을 실행합니다. 처음 실행할 때는 iTunes 계정 세부 정보를 입력하라는 메시지가 표시됩니다. 그러면 샌드박스 환경에서 이 계정을 사용해 구매를 테스트할 수 있습니다.

Apple 앱 스토어 테스트 및 서명에 대한 자세한 내용은 iOS 및 Mac 확장 기능 및 macOS 애플리케이션 빌드를 참조하십시오.