パート 3 : Monaca アプリのビルド

こちらのチュートリアルでは、iOS 向けと Android 向けの Monaca アプリのビルド方法を解説します。

他のプラットフォーム向けの Monaca アプリのビルドに関しては、ビルドをご確認ください。

iOS 向け Monaca アプリのビルド

端末にインストールできるデバッグビルド版 iOS アプリの作成方法を解説します。ビルドの種類に関する詳細は、ビルドの種類をご確認ください。

事前準備

Apple Developer Program への登録 ( 必須 )

必要事項

Apple Developer Program 登録後、iOS Provisioning Portal 上で、次のアイテムを作成します。

App ID ( App ID の登録と開発用端末の登録を参照のこと )
デベロッパー証明書 ( 別名「開発用証明書」、証明書の作成を参照のこと )
開発用プロビジョニングプロファイル ( プロビジョニングプロファイルの作成を参照のこと )

ステップ 1 : iOS アプリの設定

Monaca クラウド IDE から、設定 → iOS アプリ設定を選択します。
アプリに関する情報を入力します。
- アプリケーション名 : マーケット上で公開されるアプリ名です。
- App ID : アプリを識別する一意の ID です。App ID には、逆ドメイン形式 ( 例 : mobi.monaca.appname ) を推奨します。英数字とピリオドのみ使用できます ( ピリオドは、最低限、1 つ使用 )。各レベルのドメイン ( 各節 ) は、ピリオドで区切られ、英字から始まります。
- バージョン : App Store Connect 経由で、アプリをアップロード ( 配布のため ) するときに必要となる、アプリのバージョン番号です。ドットで区切った、3 つの数字 ( 例 : 1.10.2 ) を使用します。各数字は、[0-99] の範囲にします。
- 他の設定項目は、任意です。こちらの設定画面では、アイコン、スプラッシュ画像などを設定できます。

Monaca のビルド設定で使用する App ID には、iOS Provisioning Portal で登録した App ID と同じ ID を使用します。なお、Monaca のビルド設定で使用する App ID には、アスタリスク ( * ) は使用できません。使用した場合、ビルドが失敗します。

3. 設定後、保存する をクリックします。

ステップ 2 : iOS ビルドの設定

Monaca クラウド IDE から、設定 → iOS ビルド設定を選択します。
新しい秘密鍵または秘密鍵と証明書の Monaca へのインポートを作成することができます。このチュートリアルでは、新しい秘密鍵の作成方法を示します。秘密鍵と CSR の生成ボタンをクリックします。

3. Apple ID 情報 ( ユーザー名とメールアドレス ) および国コードを入力して、 秘密鍵と CSR の生成ボタンをクリックします。

4. 認証後、次のダイアログが表示されます。CSR のダウンロードボタンをクリックして、CSR ファイルをダウンロードします。ダウンロードしたファイルは、後ほど、iOS Provisioning Portal で、証明書を発行するときに必要となります。

既存の秘密鍵をインポートする場合、インポートする秘密鍵を使用して発行した証明書が必要になります。また、秘密鍵と CSR ファイルを新規作成する場合、新規作成した CSR ファイルを使用して、証明書を発行する必要があります。

ステップ 3 : アプリのビルド

Monaca クラウド IDE から、ビルド → iOS アプリのビルドを選択します。
[ デバッグ向けビルド ] のデバッグビルドオプションを選択し、加えて、対応するプロビジョニングプロファイルを選択します。次に、 ビルドを開始するボタンをクリックします。

3. ビルドが完了するまで数分かかる場合もありますので、しばらく待ちます。ビルドが完了すると、次の画面が表示されます。

ステップ 4 : ビルドしたアプリのインストール

デバッグビルド版アプリのインストール方法は、下記になります。

ビルド済みアプリをダウンロードし、Apple Configurator 2 を使用して、iOS 端末にインストールします。（ Mac のみ）
QR コードを使用して、インストールします。
配信/配布支援サービス ( デプロイサービス ) 経由でインストールします。

Android 向け Monaca アプリのビルド

デバッグビルド版 Android アプリの作成方法を解説します。ビルドの種類に関する詳細は、ビルドの種類をご確認ください。

ステップ 1 : Android アプリの設定

Monaca クラウド IDE から、 設定 → Android アプリ設定を選択します。
アプリに関する情報を入力します。
- アプリケーション名 : マーケット上で公開されるアプリ名です。
- パッケージ名 : アプリを識別する一意の ID です。ID には、逆ドメイン形式 ( 例 : mobi.monaca.appname ) の使用を推奨します。英数字とピリオドのみ使用できます ( ピリオドは、最低限、1 つ使用 )。各レベルのドメイン ( 各節 ) は、ピリオドで区切られ、英字から始まります。
- バージョン : アプリのバージョン番号です。ドットで区切った、3 つの数字 ( 例 : 1.10.2 ) を使用します。各数字は、[0-99] の範囲にします。
- ビルド種別ごとにパッケージ名を分ける : チェックをした場合、デバッグビルド版アプリのパッケージ名とカスタムビルド版デバッガーのパッケージ名は、異なる名になります。デバッグビルド版アプリのパッケージ名の拡張子は .debug となり、プロジェクトのデバッガーのパッケージ名の拡張子は .debugger となります。ただし、デフォルトでは、このオプションは無効になっています。常時有効にしてしまうと、決まったパッケージ名 ( In-App Purchase など ) に紐付けされているプラグインが存在する場合、デバッグができなくなるためです。
- 他の設定項目は、任意です。こちらの設定画面では、アイコン、スプラッシュ画像などを設定できます。

3. 設定後、 保存するをクリックします。

ステップ 2 : Android キーストア ( Keystore ) の設定

Android キーストアを使用して、パッケージの署名に必要な鍵 ( エイリアス ) を格納します。キーストアを紛失した場合、または、別のキーストアで上書きした場合は、既に署名されているパッケージは、同じ鍵では再署名できません。1 つのキーストアには、複数のエイリアスを格納できますが、アプリのコード署名 ( Code Sign ) 時には、エイリアスを 1 つのみ、使用します。

Monaca での Android キーストアの設定方法は、次のとおりです。

Monaca クラウド IDE から、設定 → Android キーストア設定を選択します。
これまでにキーストアを作成したことがない場合、キーストアを新規に作成します。新規作成の他にも、既存のキーストアがあれば、インポートもできます。このチュートリアルでは、キーストアを新規に作成することを前提として解説します。 クリアして作成 ...ボタンをクリックして、[ キーストアを作成する ] ダイアログを表示させます。