Version: 2021.2
言語: 日本語
Unity Developer Dashboard を使用して Unity Cloud Build を Plastic 用に設定
Advanced options (詳細オプション)

iOS 用のビルド

Cloud Build を使用すると、Unity プロジェクトを iOS デバイス用にビルドする処理を自動化できます。

このページでは iOS 用プロジェクトのビルドの必要条件を説明します。さらに、Cloud Build を設定するためのサポート的な要素の作成方法も説明します。以下の内容が含まれます。

  • Apple Developer Program への加入
  • iOS 証明書と p12 ファイルの作成
  • プロファイルにデバイスを加える方法
  • プロビジョニングプロファイルの作成
  • iOS 用にビルドするためのアプリケーション設定

Apple Developer Program への加入

iOS アプリケーションを開発するには、Apple Developer Program のメンバーになる必要があります。これにより、アプリケーションのビルド、テスト、そして最終的には Apple App Store でのリリースが可能になります。

ノート: iOS と Mac のアプリケーションを開発するためには、 OS X Yosemite (v10.10) 以降を搭載する Intel ベースの Mac が必要です。

Apple Developer ポータルにサインインすると、左側に Program Resources というリストが表示されます。Click Certificates, IDs & Profiles をクリックして、アプリケーションの開発と配布に必要な証明書、識別子、プロファイル、デバイスを管理します。

プロビジョニングプロファイル

プロビジョニングプロファイルは、開発者とデバイスを認可された Development Team に結びつけ、テスト用のデバイスを使用できるようにします。 アプリケーションコードを実行する予定の各デバイスに Development Provisioning Profile をインストールする必要があります。

Development Provisioning Profile には、一連の Development Certificates、Unique Device Identifiers (UDID)、App ID が含まれています。

テスト用のデバイスを使用するには、開発証明書もプロファイルに加える必要があります。1 つのデバイスが複数のプロビジョニングプロファイルを持つことが可能です。

プロビジョニングプロファイルの構成要素

証明書によって、アプリケーションが開発専用であるか、App Store へのリリース候補であるかが決まります。Ad Hoc の Production 用証明書を使用すると、ゲームのすべての機能 (例えば Game Center など) をテストできます。

識別子は、プロジェクトを識別するために使用する一意の ID です。基本的なプロジェクトであったり、これが最初の iOS プロジェクトである場合は、App ID を作成することになります。これは、しばしば Unity3D プロジェクトの Bundle ID と同じような役割を持っています。

ヒント: ID と証明書と署名に関する詳細については、Apple Developer ウェブサイトの Maintaining Your Signing Identities and Certificates を参照してください。

デバイスは、プロジェクトをテストする予定のハードウェア ( iPhone、iPad、iPod など) です。ゲームをテストする予定の各デバイスの UDID を取得する必要があります。その後に、iOS Developer ポータルの Devices セクションに UDID を追加します。

ノート: 毎年、決められた数のデバイスを登録することができます。登録可能なデバイスの最大数は、メンバーシップ年度につき、製品群ごとに 100 デバイスです。詳細については、Apple Developer のWebサイトの Maintaining Identifiers, Devices, and Profiles トピックのRegistering Devices Using Your Developer Account を参照してください。

iOS 証明書と p12 ファイルの作成

証明書を作成するときは、Development Certificate (テスト専用) を作成するか、Production Certificate (App Store を通してアプリケーションを配布するために使用) を作成するかを決める必要があります。

ヒント: いずれの証明書のタイプも開発に使用できますが、Production Certificate を使用すると、アプリケーションを Apple Store へリリースするプロセスが簡単になります。

証明書の作成

  1. Apple Developer Program にログインします。
  2. Member Center > Certificates > Identifiers & Profiles > Certificates の順にクリックします。
  3. 左ペインで Certificates の下の All をクリックします。
  4. What type of certificate do you need と表示されたページで、生成する証明書のタイプを選択します。通常、まだ iOS 用の開発を始めたばかりの場合は、App Store and Ad Hoc の Production 証明書 を選択するとよいでしょう。
  5. Mac の Keychain Access プログラムを使って (Finder を開くと Applications/Utilities 内にあります)、Certificate Signing Request (CSR) ファイルを生成します。iOS ポータルサイトの説明に従ってこれを作成します。この CSR ファイルを保存した場所を控えておいてください。
  6. Generate your certificate ページで CSR ファイル (.certSigningRequest の拡張子を持つ場合があります) をアップロードします。Choose File ボタンをクリックし、CSR ファイルを選択してから、Generate ボタンをクリックします。
  7. Mac に証明書をダウンロードするには、Your Certificate is Ready が表示されたページで Download ボタンをクリックします。このファイルを任意の安全な場所に保管し、バックアップを取っておきます。

キーチェーンに証明書を加えるには、証明書をダブルクリックします。すると、Keychain Access プログラムが開きます。ポップアップメッセージ「Do you want to add the certificate to a keychain?」が表示された場合はログインし、Add ボタンをクリックします。

p12 ファイルのエクスポート

Unity Cloud Build を使ってアプリケーションを作成するために、証明書ファイルを p12 ファイルに変換する必要があります。p12 ファイルはプライベートキーと証明書を含み、コードを署名するファイルです。一般的に、ネイティブの Xcode でプロジェクトを開発する場合、このプロセスは裏で処理されます。

p12 ファイルの生成は以下の手順で行います。

  1. Mac で Finder を開き、Applications > Utilities の順に移動し Keychain Access プログラムを開きます。

  2. 左ペインの Keychains の下の Login が選択されていることを確認します。

  3. 左ペインの Category 下の My Certificates が選択されていることを確認します。Keychain Access のメインのペインで証明書を選択します。

    ノート: 通常は、証明書は My Certificates に置かれています。そこに見つからない場合は Certificates 以下を探します。

  4. File メニュー から File > Export Items の順に選択、または、右クリックして Export を選択します。

  5. File Format ドロップダウンから Personal Information Exchange (p12) を選択します。

    Note: Keychains の下の LoginCategory の下の My Certificates が選択されないと、p12 オプションは選択できません。

  6. p12 ファイルのパスワードを設定します。

    ノート: パスワードは任意の安全な場所に保管してください。Unity Cloud Build で iOS ビルドを設定する場合は、パスワードの入力が必要です。

デバイスを加える方法

開発目的のために、Apple によって、アプリケーションをインストールする予定の各デバイスの UDID が必須とされています。いったんアプリケーションが App Store に許可されれば、誰でもダウンロードしてインストールすることが可能です。ただし、適切なバージョンの iOS を持っていて、他の必要な条件を満たしていなければなりません。

UDID を探す

iTunes を使ってデバイスの UDID を見つけることができます。その詳しい手順は、WhatsMyUDID.com を参照してください。

基本的な手順は、以下の通りです。

  1. Mac の iTunes を起動します。
  2. デバイス (iPhone, iPad, etc) をコンピューターに接続します。
  3. iTunes でデバイスを選択します。
  4. 画面にデバイスの名、容量、その他の情報が表示されます。UDID を表示するには、Serial # フィールドをクリックします。
  5. 後で使用するために、UDID をドキュメントにコピーアンドペーストします。
  6. iTunes を終了し、デバイスの接続を切ります。

UDID を Apple Developer ポータルサイトに加える方法

UDID を Apple Developer ポータルサイトに加えるには、以下を行います。

  1. Aoole Developer の左コラムの Devices の下の All をクリックします。
  2. 新しい UDID を加えるには、右上の + ボタンをクリックします。
  3. デバイスを認識できるように名前を付け、iTunes から UDID フィールドに設定した UDID をコピーアンドペーストします。
  4. Continue をクリックします。

各デバイスに同じ手順を繰り返します。

App ID の作成

iOS 証明書を作成したので App ID を作成します。

  1. Apple Developer ポータルサイトの左ペインで App ID をクリックします。

  2. Register iOS App IDs ページ、右上の + ボタンをクリックします。

  3. Registering an App ID ページで、以下の情報を入力します。
    1. App ID Description: アプリケーションの名前 (特殊文字は使用不可)
    2. App ID Suffix: Game Center や In-App Purchases などの特別なサービスを利用しようと思っている場合は、Explicit ID を作成します。これらのサービスが必要ない場合は、Wildcard App ID を作成します。Wildcard App ID を利用すると App ID を複数のプロジェクトに再使用できます。
    3. App Services: 任意。Apple が提供する Apple App Services から必要なもの選択します。

    App ID の登録に関して詳しくは Maintaining Identifiers, Devices, and Profiles を参照してください。

  4. Continue ボタンをクリックします。

  5. Confirm your App ID ページで、内容を確認し Submit ボタンをクリックします。

プロビジョニングプロファイルの作成

次に、.mobileprovision ファイルを生成します。.mobileprovision ファイルは p12 証明書と App ID を関連付け、アプリケーションをテストするデバイスの UDID を認識します。

  1. Apple Developer ポータルサイトの左ペインで Certificates, IDs & Profiles をクリックします。
  2. Apple Developer ポータルサイトの左ペインで Provisioning Profiles の下の All を選択します。
  3. 新しい Provisioning Profile を加えるには、右上の + ボタンをクリックします。
  4. Development で作成するプロビジョニングプロファイルのタイプを選んで Continue をクリックします。 Note: iOS での開発を始めたばかりであれば、Distribution > Ad Hoc を選ぶとよいでしょう。これを選択すると、ゲームをビルドしてデバイスでテストできます。
  5. 開発に使用する App ID を選択し、Continue ボタンをクリックします。
  6. 1 つ以上の開発証明書を選択し、Continue ボタンをクリックします。
  7. 1 つ以上のデバイスを選択し、Continue ボタンをクリックします。
  8. Profile Name (プロファイル名) を入力し Continue ボタンをクリックします。
  9. Done をクリックします。

生成された .mobileprovision ファイルをデスクトップにダウンロードします。

iOS 用にビルドするためのアプリケーション設定

iOS Cloud Build を設定するために、以下が必要です。

  • プロビジョニングプロファイル (.mobileprovision)
  • p12 ファイル
  • .p12 ファイルのパスワード

この手順は、基本的な iOS の使用には十分です。Xcode フレームワークを持つプロジェクトには、さらにいくつかの設定が必要です。

Xcode フレームワークの使用

Xcode フレームワークを手動で追加するには、Xcode Manipulation API を使用します。API により、外部の Xcode フレームワークを処理することが可能になります。

この API を使用する Unity プロジェクトの例については、BitBucket の UpdateXcodeProject サンプルプロジェクトを参照してください。このサンプルで、経験したり学んだりすることができます。

サンプルプロジェクトのプラグインの 1 つは、外部の Xcode プロジェクト操作の DLL です。DLL は Unity の Bitbucket リポジトリで利用可能なソースのビルドプロダクトです。Xcode プロジェクトの操作機能を加えるには、C# ソースコードファイルをプロジェクトの Assets/Editor フォルダーにコピーするのが好ましい方法です。

Xcode Manipulation APIは、以下の方法で使用できます。

Unity Developer Dashboard を使用して Unity Cloud Build を Plastic 用に設定
Advanced options (詳細オプション)