ラップウィザードを使用してモバイルアプリをビルドする

[アーティクル]
07/18/2023

ステップバイステップウィザードを使用して、ラップ機能で 1 つ以上のキャンバスアプリを、単一のネイティブモバイルアプリパッケージとしてパッケージ化します。

Power Apps のラップ機能により、キャンバスアプリをカスタムブランドの Android や iOS モバイルアプリとしてネイティブモバイルバージョンを作成することができます。 Microsoft Intune、Microsoft アプリセンター、Google Play、Apple Business Manager などのネイティブな配布方法で、エンドユーザーにこのようなラップ されたネイティブモバイルアプリを配布することができます。

ラップ機能を使用すると、iOS、 Android、Google Play Store 向けのモバイルアプリを作成できます:

iOS (IPA パッケージ)
Android (APK パッケージ)
Google Play Store (AAB パッケージ)

ラップ機能は、キャンバスアプリをネイティブのモバイルアプリのシェルでラップし、デジタル署名して配布できる機能です。アプリを更新して再公開すると、アプリは自動的に更新されます。

前提条件

次へのアクセス権が必要です:

アプリ登録先の Azure portal 。
新しい組織とアプリ追加先の App Center 。
この機能では、アプリがマネージドまたはアンマネージドソリューションの一部である必要があります。アプリがまだソリューションの一部になっていない場合は、既存または新規のソリューションに追加します。詳細情報: ソリューション内からキャンバスアプリを作成する。

Android プラットフォーム用のモバイルアプリパッケージを作成し、手動でコード署名を行う場合は、事前にキーを生成し、署名ハッシュを生成しておいてください。生成された署名のハッシュは、 URI のリダイレクト の構成に必要です。

ソリューションにキャンバスアプリを追加する

Power Apps のラップは、アプリがソリューションの一部である必要があります。キャンバスアプリがまだソリューションの一部になっていない場合は、既存または新規のソリューションに追加します。左のナビゲーションウィンドウから、ソリューション を選択します。項目がサイドパネルウィンドウに表示されない場合は、…さらに表示を選択して、目的の項目を選択します。サイトを選択し、編集を選択します。

ソリューションを選択します。

上部のメニューから + 既存の追加 オプションを選択し、ドロップダウンリストの アプリ > キャンバスアプリ を選択します。

上部メニューから既存のものを追加を選択します。

外部 Dataverse タブを選択し、リストからアプリを選択します。追加ボタンを押して、アプリをソリューションに追加します。

ソリューションに追加するアプリを選択します。

詳細情報: アプリをソリューションに追加する

ウィザードを使用して iOS および Android 用のネイティブモバイルアプリを作成する

Power Apps にサインインします。
左のナビゲーションウィンドウから、ラップ を選択します。項目がサイドパネルウィンドウに表示されない場合は、…さらに表示を選択して、目的の項目を選択します。
ラップするアプリを選択してから、コマンドバーでラップを選択します。

手順 1: アプリを選択します

ラップするアプリを選択する画面で、プライマリアプリとセカンダリアプリを選択します。
- プライマリアプリ: モバイルアプリの起動時にエンドユーザーに表示されるアプリを選択します。
- セカンダリアプリ: オプションの他のアプリは、プライマリアプリと一緒にモバイルアプリパッケージに向けて同じビルドをバンドルすることができます。
  
  注意
  
  複数のラッププロジェクトで同じプライマリアプリを使用できます。
次へを選択します。

手順 2: ターゲットのプラットフォーム

対象となるモバイルプラットフォームを選択する画面で、選択したバンドル ID を入力します。

注意

バンドル ID は、アプリ用に作成する一意の識別子です。バンドル ID にはピリオド (.) を 1 つ含める必要があり、スペースは使用できません。
ターゲットプラットフォームで、エンドユーザーがモバイルデバイスで使用するすべてのモバイルプラットフォームを選択します。
モバイルアプリに自動的にコード署名するには、アプリに署名 をオンに設定し、 Azure Key Vault URI をリストから選択し、次へをクリックします。 Azure Key Vault URI リストに入力がない場合は、まず Azure Key Vault を作成する必要があります。詳細: Power Apps のラップ用 Azure Key Vault を作成する。

ラップウィザードで利用可能な自動コード署名を使用する代わりに、モバイルアプリパッケージに手動でコード署名することもできます。アプリに手動でコード署名する方法の詳細については、次を参照してください:

次へを選択します。

手順 3: ブランド化の構成

ブランド化の構成手順で、アプリの次のルックアンドフィールオプションを設定します:

注意

すべての画像は .png 形式である必要があります。カスタムイメージが選択されていない場合は、デフォルトのイメージが使用されます。
- アプリアイコン: アプリで使用するアイコンをアップロードします。 iOS の推奨サイズ: 1024px x 1024px の .png 画像以上。 Android の推奨画像サイズ: 432px x 432px の .png 画像以上。
- スプラッシュスクリーンのイメージ: 読み込み中にモバイルアプリのスプラッシュ画面で使用される画像です。提供されていない場合に使用され既定の画像です。
- ウェルカムスクリーンのイメージ: 読み込み中にモバイルアプリのようこそ画面 (ログイン画面) で使用される画像です。提供されていない場合に使用され既定の画像です。
- 背景を塗りつぶす色: ようこそ画面の背景に使用される 16 進数のカラーコードです。
- ボタンを塗りつぶす色: ボタンの色の塗りつぶしに使用される 16 進数のカラーコードです。
- ステータスバーのテキストテーマ: アプリ上部のステータスバーテキストの色です。
次へを選択します。

手順 4: アプリを登録する

アプリを登録する画面で、Azure にアプリケーションを登録して、アプリと Microsoft ID プラットフォーム間に信頼関係を確立します。アプリのユーザーがログインできるように、アプリを Microsoft Entra に登録する必要があります。

新しいアプリの登録

新しいアプリの登録 を選択すると、アプリの新しい登録が自動的に作成されます。

新規アプリの登録を作成します。

また、手動で 新しいアプリの登録 をすることもできます。詳細については、Azure portal にアプリを手動で登録するを参照してください。

ラップウィザードは、アプリに必要なすべての API の権限を自動的に構成します。この手順をトラブルシューティングする必要がある場合は、API 権限を手動で構成することもできます。詳細については、アプリの API 権限を手動で構成するを参照してください。

手順 5: 出力を管理する

出力を管理 画面で、ビルド完了後にモバイルアプリを送信する アプリセンターの場所 を作成するか、既存のアプリセンターを選択します。ラップウィザードで自動的に新しい場所を作成するには、画面上部の 新しい場所 を選択し、Android または iOS を選択します。

新しい App Center の場所。

Android: 既存の場所を選択するか、新しい場所を作成します。
iOS: 既存の場所を選択するか、新しい場所を作成します。

また、App Center で アプリセンターの場所 を手動で作成することも可能です。詳細については、モバイルアプリのアプリセンターの場所を手動で作成するを参照してください。

ステップ 6: まとめ

まとめ画面で、アプリの詳細を確認してから、ビルドを選択します。ビルドが成功すると、前述の手順で選択した アプリセンターの場所 にモバイルアプリが表示されます。

モバイルアプリパッケージのテストと配布

テストと配布については、App Center のテストと配布を参照してください。

手動で Azure ポータルにアプリを登録する (オプション)

ステップ 4 で説明したように、ラップウィザードでアプリ登録を自動的に作成できます。または、Azure portal でアプリの新しい登録を手動で作成できます。詳細情報については、クイックスタート: アプリケーションを Microsoft ID プラットフォームに登録するを参照してください。

注意

シングルテナントとマルチテナントのどちらのお客様も、ラップを使用して、Power Apps キャンバスアプリに基づいて独自のモバイルアプリケーションを作成できます。

シングルテナントメーカーかマルチテナントメーカーかに関係なく、アプリでサポートされているアカウントの種類を選択してラップを有効にする場合、任意の Microsoft Entra ディレクトリ - マルチテナント を含むオプションのいずれかを選択する必要があります。次のアカウントタイプのいずれかを選択します。

任意の組織ディレクトリ内のアカウント (任意の Microsoft Entra ディレクトリ - マルチテナント型)
任意の組織ディレクトリ内のアカウント (任意の Microsoft Entra ディレクトリ - マルチテナント型) および個人の Microsoft アカウント (例: Skype、Xbox) を選択します。

アプリの登録 - ラップでサポートされているアカウントの種類。

重要

ラップは現在、マルチテナントのアカウントタイプにのみ対応しています。 シングルテナントのアカウントタイプはまだ対応していません。アカウントタイプの詳細: Microsoft ID プラットフォームのアカウントタイプ。
対象となるプラットフォーム (iOS, Android) ごとに、個別の URI のリダイレクトを作成する必要があります。

アプリの API 権限を手動で構成する (オプション)

ステップ4 を完了すると、ラップウィザードによってアプリに必要なすべての API の権限が自動的に構成されます。

ラップウィザードでエラーが発生した場合は、API 権限を手動で構成できます。詳細情報: 追加と構成

API 権限を手動で構成する場合は、次の API 権限が必要です:

Microsoft APIs
- Dynamics CRM
組織が使用している API
- Azure API 接続
- PowerApps サービス
- Power BI (キャンバスアプリが Power BI データを使用する場合にのみ必要)
- Microsoft モバイルアプリケーション管理 (モバイルアプリの配布に Microsoft Intune を使用する場合にのみ必要)

注意

組織が使用している API の下に権限が見つからない場合、必要に応じて次の PowerShell コマンドを実行し、再試行してください。

Azure API 接続許可がありません:

Connect-AzureAD -TenantId <your tenant ID>
New-AzureADServicePrincipal -AppId fe053c5f-3692-4f14-aef2-ee34fc081cae -DisplayName "Azure API Connections"

PowerApps サービス許可がありません:

Connect-AzureAD -TenantId <your tenant ID>
New-AzureADServicePrincipal -AppId 475226c6-020e-4fb2-8a90-7a972cbfc1d4 -DisplayName "PowerApps Service"

詳細な手順については、アプリ登録ポータルで権限をリクエストするを参照してください。

モバイルアプリのアプリセンターの場所を手動で作成する (オプション)

ステップ 5 で説明したように、新しい App Center の場所を自動的に作成してモバイルアプリを保存するオプションがあります。ラップウィザードで作成できますが、App Center で直接手動で作成することもできます。詳細情報: App Center の場所

ヒント

App Center の詳細については、Visual Studio App Center のドキュメントにアクセスしてください。

App Center に移動します。
職場または学校のアカウントでサインインします。
既存の組織がない場合は、新しく追加する>新しい組織を追加するを選択して新しい組織を作成します。
左ペインの一覧から組織を選択します。
アプリ > アプリの追加を選択します。
アプリ名を入力します。
アプリのリリースタイプを選択します。
iOS アプリ用カスタム OS、または Android アプリ用 Android OS を選択します。

注意

プラットフォームごとに個別の App Center コンテナーを作成する必要があります。
Android OSでは、React ネイティブに、プラットフォームを選択します。

注意

プラットフォーム は、App Center 内のすべてのアプリが React ネイティブである必要があります。
新規アプリの追加を選択します。
アプリのアプリセンター URL をコピーします。これは、後で Power Apps でラッププロジェクトを構成するために必要になります。

例: https://appcenter.ms/orgs/Contoso-sales/apps/Sample-canvas-app-for-Android-OS/

モバイルアプリパッケージに手動で署名します (オプション)

ステップ2 のラッププロセス中にモバイルアプリパッケージに自動的に署名できますが、モバイルアプリパッケージのビルド後に手動で署名することもできます。コード署名プロセスは、Android および iOS デバイスで異なります。

ラップウィザードを使用してモバイルアプリをビルドする

前提条件

ソリューションにキャンバスアプリを追加する