iOS 向け開発

iOS では、ビルドしてスマートフォンやタブレットで実行する すべての アプリに、Apple が発行した証明書とプロビジョニングプロファイルを使って署名する 必要があります 。このマニュアルでは、iOS 向けにゲームのバンドルを作成する手順を説明します。開発中は、コンテンツやコードをデバイスへ直接ホットリロード（hot reload）できるため、開発用アプリ（development app） を通じてゲームを実行する方法がよく使われます。

Apple のコード署名の仕組み

iOS アプリのセキュリティは、いくつかの要素で構成されています。Apple の iOS Developer Program に登録すると、必要なツールを利用できます。登録後、Apple の Developer Member Center にアクセスします。

Certificates, Identifiers & Profiles セクションには、必要なツールがすべて揃っています。ここでは、次の項目を作成、削除、編集できます。

Certificates

開発者としての身元を証明する、Apple が発行した暗号証明書です。開発用または本番用の証明書を作成できます。開発用証明書を使うと、サンドボックスのテスト環境でアプリ内購入の仕組みなど、特定の機能をテストできます。本番用証明書は、App Store にアップロードする最終版のアプリへの署名に使います。テストのためにアプリをデバイスへインストールするには、その前に証明書でアプリへ署名する必要があります。

Identifiers

さまざまな用途に使う識別子です。複数のアプリで使用できるワイルドカード識別子（たとえば some.prefix.*）を登録できます。App ID には、アプリが Passbook 連携や Game Center などを有効にするかどうかといった Application Service 情報を含めることができます。そのような App ID にワイルドカード識別子は使えません。Application Services を機能させるには、アプリケーションの バンドル識別子（bundle identifier） が App ID の識別子と一致する必要があります。

Devices

開発用の各デバイスを、その UDID（Unique Device IDentifier、後述）で登録する必要があります。

Provisioning Profiles

プロビジョニングプロファイルは、証明書を App ID およびデバイスのリストに関連付けます。どの開発者のどのアプリを、どのデバイスにインストールできるかを定めます。

Defold でゲームやアプリに署名するには、有効な証明書と有効なプロビジョニングプロファイルが必要です。

デバイス識別子（UDID）

iOS デバイスの UDID は、Wi-Fi またはケーブルでデバイスをコンピューターに接続して確認できます。Xcode を開き、Window ▸ Devices and Simulators を選択します。デバイスを選択すると、シリアル番号と識別子が表示されます。

Xcode がインストールされていない場合は、iTunes で識別子を確認できます。デバイスのアイコンをクリックして、使用するデバイスを選択します。

1. Summary ページで Serial Number を探します。
2. Serial Number を1回クリックすると、フィールドが UDID に変わります。繰り返しクリックすると、デバイスに関するいくつかの情報が順に表示されます。UDID が表示されるまでクリックします。
3. 長い UDID 文字列を右クリックし、Copy を選択して識別子をクリップボードにコピーします。これで、Apple の Developer Member Center でデバイスを登録するときに、UDID フィールドへ簡単に貼り付けられます。

無料の Apple 開発者アカウントを使った開発

Xcode 7 以降では、誰でも Xcode をインストールして、無料で実機を使った開発ができます。iOS Developer Program に登録する必要はありません。代わりに、Xcode が開発者用の証明書（有効期間は1年）と、特定のデバイス上のアプリ用のプロビジョニングプロファイル（有効期間は1週間）を自動的に発行します。

1. デバイスを接続します。
2. Xcode をインストールします。
3. Xcode に新しいアカウントを追加し、Apple ID でサインインします。
4. 新しいプロジェクトを作成します。最もシンプルな Single View App で十分です。
5. 自動的に作成された Team を選択し、アプリにバンドル識別子を設定します。

1. Xcode がアプリの Provisioning Profile と Signing Certificate を作成したことを確認します。

   

2. デバイス上でアプリをビルドします。初回は Xcode から Developer mode を有効にするよう求められ、デバイスがデバッガーをサポートするための準備が行われます。これには時間がかかることがあります。

3. アプリが動作することを確認したら、ディスク上でアプリを探します。ビルド先は、Report Navigator のビルドレポートで確認できます。

   

4. アプリを見つけて右クリックし、Show Package Contents を選択します。

   

5. embedded.mobileprovision ファイルを、ドライブ上の見つけやすい場所にコピーします。

このプロビジョニングファイルをコード署名 ID とともに使うと、Defold で1週間アプリに署名できます。

プロビジョニングの有効期限が切れたら、Xcode でアプリを再度ビルドし、上記の手順で新しい一時的なプロビジョニングファイルを取得する必要があります。

iOS アプリケーションバンドルの作成

コード署名 ID とプロビジョニングプロファイルが揃ったら、エディターからゲームのスタンドアロンのアプリケーションバンドルを作成できます。メニューから Project ▸ Bundle... ▸ iOS Application... を選択します。

コード署名 ID を選択し、モバイルプロビジョニングファイルの場所を指定して、ビルドバリアント（build variant、Debug または Release）を選択します。必要に応じて Sign application チェックボックスをオフにすると、署名処理をスキップし、後で手動で署名できます。Simulator をオンにすると、デバイス用バンドルの代わりに iOS シミュレーター用の arm64_sim-ios バンドルを作成します。

Create Bundle を押すと、コンピューター上のバンドルの作成先を指定するよう求められます。

アプリに使用するアイコンや起動画面のストーリーボードなどは、プロジェクト設定ファイル game.project の iOS セクション で指定します。

カスタム Info.plist とローカルターゲットの検出

組み込みの iOS Info.plist には、リリース以外のビルドでエディターがターゲットを自動検出するために必要な Bonjour サービスとローカルネットワークの使用目的の説明が含まれています。カスタム Info.plist は、この組み込みのベースマニフェストを置き換えます。デバッグビルドでカスタムマニフェストを使い、ローカルネットワーク経由のターゲット検出、プロファイリング、ホットリロード、ログのストリーミングが必要な場合は、次のエントリーを含めてください。

{{^variant_release}}
<key>NSBonjourServices</key>
<array>
    <string>_defold._tcp</string>
</array>
<key>NSLocalNetworkUsageDescription</key>
<string>Discover Defold targets on the local network.</string>
{{/variant_release}}

Mustache の条件により、リリースバンドルには検出用のエントリーが含まれなくなります。使用目的を説明する文字列は iOS がユーザーに表示するもので、変更やローカライズが可能です。リリース版アプリケーション自体が同じ Bonjour サービスとローカルネットワーク機能を使う場合にのみ、この条件を削除してください。

ビルドバリアント

ゲームのバンドル（bundle）を作成するときは、使用するエンジンの種類を選ぶ必要があります。基本となる選択肢は次の3つです。

• Debug
• Release
• Headless

これらの異なるバージョンは、ビルドバリアント（Build variants）とも呼ばれます。

Debug

この種類の実行ファイルには、便利なデバッグ機能がいくつか含まれているため、通常はゲームの開発中に使用します。

• プロファイラー（profiler） - パフォーマンスや使用状況を示すカウンターの収集に使用します。プロファイラーの使い方は、プロファイリングのマニュアルを参照してください。
• ログの記録 - ログの記録が有効な場合、エンジンはシステム情報、警告、エラーをログに記録します。また、Lua の print() 関数や、ネイティブ拡張（native extension）で dmLogInfo()、dmLogError() などを使用して記録するログも出力します。これらのログの読み方は、ゲームとシステムのログのマニュアルを参照してください。
• ホットリロード（hot reload） - ホットリロードは、ゲームの実行中に開発者がリソース（resource）を再読み込みできる強力な機能です。使い方は、ホットリロードのマニュアルを参照してください。
• エンジンサービス（engine services） - 開いているさまざまな TCP ポートやサービスを通じて、ゲームのデバッグ版に接続し、操作できます。これらのサービスには、前述のホットリロード機能、リモートでのログへのアクセス、プロファイラーのほかに、エンジンをリモートで操作するためのサービスも含まれています。エンジンサービスの詳細は、開発者向けドキュメントを参照してください。

Release

このバリアントでは、デバッグ機能が無効になっています。ゲームをアプリストアでリリースする準備ができたときや、ほかの方法でプレイヤーに配布する準備ができたときは、この選択肢を選んでください。次の理由から、デバッグ機能を有効にしたままゲームをリリースすることは推奨しません。

• デバッグ機能によってバイナリのサイズが少し大きくなります。リリースするゲームのバイナリサイズは、できる限り小さくすることをお勧めします。
• デバッグ機能は CPU の処理時間も少し消費します。ユーザーが低性能なハードウェアを使用している場合、ゲームのパフォーマンスに影響する可能性があります。携帯電話では、CPU 使用率の増加は発熱やバッテリーの消耗にもつながります。
• デバッグ機能は、セキュリティ、チート、不正行為の観点から、プレイヤーに見せることを意図していないゲームの情報を公開してしまう可能性があります。

Headless

ヘッドレス（headless）版の実行ファイルは、グラフィックスの表示もサウンドの再生も行わずに動作します。つまり、CI サーバー上でゲームの単体テストやスモークテストを実行したり、クラウド上のゲームサーバーとして動作させたりすることもできます。

接続した iPhone へのバンドルのインストールと起動

エディターの Bundle ダイアログにある Install on connected device と Launch installed app のチェックボックスを使うと、ビルドしたバンドルをインストールして起動できます。

この機能を使うには、ios-deploy コマンドラインツールをインストールする必要があります。最も簡単なインストール方法は Homebrew を使うことです。

$ brew install ios-deploy

エディターが ios-deploy ツールのインストール先を検出できない場合は、環境設定 で指定する必要があります。

ストーリーボードの作成

ストーリーボードファイルは Xcode で作成します。Xcode を起動して新しいプロジェクトを作成します。iOS と Single View App を選択します。

Next をクリックし、プロジェクトの設定に進みます。Product Name を入力します。

Create をクリックして手順を完了します。これでプロジェクトが作成されたので、ストーリーボードの作成に進みます。

画像をドラッグ＆ドロップしてプロジェクトにインポートします。次に Assets.xcassets を選択し、画像を Assets.xcassets にドロップします。

LaunchScreen.storyboard を開き、プラスボタン（+）をクリックします。ダイアログに imageview と入力して、ImageView コンポーネントを探します。

Image View コンポーネントをストーリーボードにドラッグします。

Image ドロップダウンから、先ほど Assets.xcassets に追加した画像を選択します。

画像の位置を調整し、必要に応じて Label やその他の UI 要素を追加するなどの調整を行います。完了したら、アクティブなスキームを Any iOS Device (arm64)（または Generic iOS Device）に設定し、Product ▸ Build を選択します。Defold は64ビットデバイス上の iOS 15.0 以降をサポートしているため、デプロイメントターゲットは15.0以降にしてください。ビルド処理が完了するまで待ちます。

ストーリーボードで画像を使っても、それらは LaunchScreen.storyboardc に自動では含まれません。game.project の Bundle Resources フィールドを使ってリソースを同梱してください。 たとえば、Defold プロジェクト内に LaunchScreen フォルダーを作成し、その中に ios フォルダーを作成します（これらのファイルを iOS バンドルにのみ含めるために ios フォルダーが必要です）。次に、ファイルを LaunchScreen/ios/ に配置します。このパスを Bundle Resources に追加します。

最後に、コンパイルされた LaunchScreen.storyboardc ファイルを Defold プロジェクトにコピーします。Finder で次の場所を開き、LaunchScreen.storyboardc ファイルを Defold プロジェクトにコピーします。

/Library/Developer/Xcode/DerivedData/YOUR-PRODUCT-NAME-cbqnwzfisotwygbybxohrhambkjy/Build/Intermediates.noindex/YOUR-PRODUCT-NAME.build/Debug-iphonesimulator/YOUR-PRODUCT-NAME.build/Base.lproj/LaunchScreen.storyboardc

ストーリーボードファイルが用意できたら、game.project から参照できます。

アイコンのアセットカタログの作成

アセットカタログを使うことは、アプリケーションのアイコンを管理する方法として Apple が推奨しています。実際、App Store の掲載情報で使われるアイコンを指定する唯一の方法です。アセットカタログはストーリーボードと同じように、Xcode で作成します。Xcode を起動して新しいプロジェクトを作成します。iOS と Single View App を選択します。

Next をクリックし、プロジェクトの設定に進みます。Product Name を入力します。

Create をクリックして手順を完了します。これでプロジェクトが作成されたので、アセットカタログの作成に進みます。

サポートされている各アイコンサイズを表す空の枠に、画像をドラッグ＆ドロップします。

完了したら、アクティブなスキームを Build -> Any iOS Device (arm64)（または Generic iOS Device）に設定し、Product -> Build を選択します。ビルド処理が完了するまで待ちます。

最後に、コンパイルされた Assets.car ファイルを Defold プロジェクトにコピーします。Finder で次の場所を開き、Assets.car ファイルを Defold プロジェクトにコピーします。

/Library/Developer/Xcode/DerivedData/YOUR-PRODUCT-NAME-cbqnwzfisotwygbybxohrhambkjy/Build/Products/Debug-iphoneos/Icons.app/Assets.car

アセットカタログファイルが用意できたら、そのファイルとアイコンを game.project から参照できます。

iOS アプリケーションバンドルのインストール

エディターは、iOS アプリケーションバンドルである .ipa ファイルを書き出します。このファイルをデバイスにインストールするには、次のいずれかのツールを使えます。

• Xcode の Devices and Simulators ウィンドウ
• ios-deploy コマンドラインツール
• macOS App Store の Apple Configurator 2
• iTunes

xcrun simctl コマンドラインツールを使って、Xcode から利用できる iOS シミュレーターを操作することもできます。

# show a list of available devices
xcrun simctl list

# boot an iPhone X simulator
xcrun simctl boot "iPhone X"

# install your.app to a booted simulator
xcrun simctl install booted your.app

# launch the simulator
open /Applications/Xcode.app/Contents/Developer/Applications/Simulator.app

Apple のプライバシーマニフェスト

プライバシーマニフェスト（privacy manifest）は、アプリまたはサードパーティ SDK が収集するデータの種類と、使用する API のうち理由の宣言が求められるものを記録するプロパティリストです。アプリまたはサードパーティ SDK は、収集するデータの種類ごとに、また、理由の宣言が求められる API を使用する場合はそのカテゴリごとに、理由を同梱のプライバシーマニフェストファイルに記録する必要があります。

Defold では、game.project ファイルの Privacy Manifest フィールドを通じて、デフォルトのプライバシーマニフェストが提供されます。アプリケーションバンドル（application bundle）の作成時に、このプライバシーマニフェストはプロジェクトの依存関係に含まれるすべてのプライバシーマニフェストとマージされ、アプリケーションバンドルに含められます。

プライバシーマニフェストについて詳しくは、Apple の公式ドキュメントを参照してください。

輸出コンプライアンス情報

App Store にゲームを提出すると、ゲームでの暗号化の使用に関する輸出コンプライアンス情報の提供を求められます。Apple はこれが必要な理由を次のように説明しています。

「TestFlight または App Store にアプリを提出すると、アプリは米国内のサーバーにアップロードされます。米国またはカナダ以外でアプリを配布する場合、法人の所在地にかかわらず、アプリには米国の輸出法が適用されます。アプリで暗号化を使用したり、暗号化にアクセスしたり、暗号化を含めたり、実装したり、組み込んだりしている場合、これは暗号化ソフトウェアの輸出とみなされます。そのため、アプリには米国の輸出コンプライアンス要件に加え、アプリを配布する国の輸入コンプライアンス要件が適用されます。」

Defold ゲームエンジンは、次の目的で暗号化を使います。

• 安全な通信経路（HTTPS や SSL）を使った呼び出し
• Lua コードの著作権保護（複製を防ぐため）

Defold エンジンにおけるこれらの暗号化の用途は、米国および欧州連合の法律で、輸出コンプライアンス書類の要件から免除されています。ほとんどの Defold プロジェクトは引き続き免除対象となりますが、ほかの暗号方式を追加すると、この扱いが変わる場合があります。プロジェクトがこれらの法律の要件と App Store の規則を満たしていることを確認する責任は、開発者にあります。詳しくは、Apple の輸出コンプライアンスの概要を参照してください。

プロジェクトが免除対象だと判断した場合は、ITSAppUsesNonExemptEncryption キーの値が False になるように、プロジェクトの Info.plist を設定します。詳しくは、アプリケーションマニフェストを参照してください。

よくある質問

Q: 無料の Apple Developer アカウントを使って Defold のゲームをインストールできません。

A: Defold プロジェクトで使用しているバンドル識別子（bundle identifier）が、モバイルプロビジョニングプロファイルを生成したときに Xcode プロジェクトで使用したものと同じであることを確認してください。

Q: バンドルを作成したアプリケーションのエンタイトルメントを確認するにはどうすればよいですか？

A: ビルドしたアプリのエンタイトルメントの確認より:

codesign -d --ent :- /path/to/the.app

Q: プロビジョニングプロファイルのエンタイトルメントを確認するにはどうすればよいですか？

A: プロファイルのエンタイトルメントの確認より:

security cms -D -i /path/to/iOSTeamProfile.mobileprovision