次の方法で共有


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

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

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

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

  • iOS (IPA パッケージ)
  • Android (APK パッケージ)
  • Google Play ストアの配布用 (AAB パッケージ)

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

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

  1. Power Apps にサインインします。

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

  3. ラップするアプリを選択してから、コマンド バーでラップを選択します。

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

  1. ラップするアプリを選択する画面で、プライマリ アプリとセカンダリ アプリを選択します。

    • プライマリ アプリ: モバイル アプリの起動時にエンド ユーザーに表示されるアプリを選択します。

    • セカンダリ アプリ: オプションの他のアプリは、プライマリ アプリと一緒にモバイル アプリ パッケージに向けて同じビルドをバンドルすることができます。

      ラップするアプリを選択します。

      ヒント

      • 複数のラップ プロジェクトで同じプライマリ アプリを使用できます。
      • ラップ ウィザードで、プライマリ アプリの名前が正しく表示されない場合は、次の手順に進み、戻って正しい名前を確認します。
  2. 次へを選択します。

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

アプリの登録 画面で、Azure にアプリケーションを手動で登録し、アプリと Microsoft ID プラットフォームの間に信頼関係を確立します。 詳細については、Azure portal にアプリを手動で登録する を参照してください。

アプリのユーザーがログインできるように、アプリを Microsoft Entra に登録する必要があります。 すでに登録している場合は、所有登録フィールドで登録を見つけます。

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

登録したアプリ名が所有登録のドロップダウン メニューに表示されていない場合は、以下の手順に従ってください。

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

  • アプリケーション名Android 署名ハッシュは必須フィールドであるため、指定する必要があります。 アプリケーション名 は、顧客向けのアプリケーション名であるため、必須です。 Android の署名ハッシュは、ラップ プロジェクトの作成と構築中にプラットフォームの 1 つとして Android を選択した場合に必要です。

    ヒント

    Android ハッシュ キーの形式は、–ga0RGNYHvNM5d0SLGQfpQWAPGJ8= などの 28 桁の英数字ハッシュ番号です。 署名ハッシュ キーが既に存在する場合は、新しいハッシュ キーを作成する必要はありません。 新しいアプリ登録を作成するときに、以前に生成した署名ハッシュ キーを再利用できます。

    アプリの登録の詳細を追加します。

管理者が許可するサード パーティ製アプリを構成する

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

アプリを登録する際、続行するには Azure 管理者にアクセス権を付与する必要があります。 アクセスを許可するには、次の手順に従います:

  • Windows PowerShell を開き、管理者として実行します。
  • コマンド Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -AllowClobber -Force を実行します。
  • 実行ポリシーを設定します: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
  • Import-Module -Name Microsoft.PowerApps.Administration.PowerShell を使用してモジュールをインポートします。
  • Add-AdminAllowedThirdPartyApps を実行し、管理者アクセスが必要な App ID を指定します。
  • Get-AdminAllowedThirdPartyApps を実行して、アプリ名がリストに表示されているか確認します。

前の手順を完了すると、登録画面は次のスクリーンショットのようになります。

完了したステップを示す緑色のチェックマークが付いた登録画面を示すスクリーンショット

API アクセス許可

アプリを登録するときに、Azure 管理者はアプリの API アクセス許可へのアクセスも許可する必要があります。 アクセス権を付与する手順と API アクセス許可が必要な理由については、次のスクリーンショットを参照してください。

アプリの API アクセス許可を示すスクリーンショット。

注意

このステップでは、新規顧客に対して アプリケーション名 フィールドのみが表示される場合があります。 Android 署名ハッシュを追加するフィールドが表示されません。 これを解決するには、次のステップに進み、ターゲット プラットフォームのステップAndroid としてターゲット プラットフォームを選択します。

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

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

    ヒント

    すべての画像は .png 形式である必要があります。 カスタム イメージが選択されていない場合は、デフォルトのイメージが使用されます。

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

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

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

    ヒント

    バンドル ID は、アプリ用に作成する一意の識別子です。 バンドル ID にはピリオド (.) を 1 つ含める必要があり、スペースは使用できません。

  2. ターゲット プラットフォームで、エンド ユーザーがモバイル デバイスで使用するすべてのモバイル プラットフォームを選択します。

  3. アプリに署名するオンに設定して、モバイルアプリに自動的にコード署名を行い、リストからAzure Key Vault URIを選択し、次へを選択します。 Azure Key Vault URI リストに入力がない場合は、まず Azure Key Vault を作成する必要があります。 詳細: Power Apps のラップ用 Azure Key Vault を作成する

    ラップするするアプリを選択します。

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

注意

ラップ ウィザードには、自動サインイン プロセスが用意されています。 しかし、モバイル プロセスに精通した開発者は、各プラットフォームで異なるメカニズムを使用して、Android や iOS アプリケーションに手動でサインインすることができます。 手動プロセスでログインする場合は、Azure Key Vault を作成する必要はありません。

  1. 次へを選択します。

ステップ 5: Azure Blob Storage

  1. まだ作成していない場合は、Azure Key Vault を作成します。 詳細: 既定のサブスクリプションを使用してラップするために Azure Key Vault を作成する
  2. Azure Blob Storage アカウントの名前とコンテナー名を作成します。 詳細: Azure Storage ストレージの作成
  3. ドロップダウン リストをクリックして、Azure Key Vault URI を追加します。
  4. Azure blob ストレージ アカウント 名と、Azure blob ストレージ アカウント の作成手順で作成したコンテナー名を追加します。
  5. ビルド手順の完了後、上記で作成した Azure blob ストレージ の場所からビルドされた APK/IPA をダウンロードします。

ステップ 6: まとめ

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

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

アプリケーションをテストおよび配布します。 テスト中に問題が発生した場合は、トラブルシューティング ページを確認してください。

手動で 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 コマンドを実行し、再試行してください。

  • Microsoft Graph モジュールが利用可能であることを確認するか、以下のコマンドを使用してインストールします:
    Install-Module -Name Microsoft.Graph
    
  • Azure API 接続許可がありません:
    Connect-MgGraph -TenantId <your tenant ID>
    New-MgServicePrincipal -AppId fe053c5f-3692-4f14-aef2-ee34fc081cae -DisplayName "Azure API Connections"
    
  • PowerApps サービス許可がありません:
    Connect-MgGraph -TenantId <your tenant ID>
    New-MgServicePrincipal -AppId 475226c6-020e-4fb2-8a90-7a972cbfc1d4 -DisplayName "PowerApps Service"
    

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

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

モバイル アプリのアプリ センターの場所は、App Center で直接手動で作成できます。 詳細情報: App Center の場所

チップ

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

  1. App Center に移動します。

  2. 職場または学校のアカウントでサインインします。

  3. 既存の組織がない場合は、新しく追加する>新しい組織を追加するを選択して新しい組織を作成します。

  4. 左ペインの一覧から組織を選択します。

  5. アプリ>アプリの追加を選択します。

  6. アプリ名を入力します。

  7. アプリのリリース タイプを選択します。

  8. iOS アプリ用カスタム OS、または Android アプリ用 Android OS を選択します。

    ヒント

    プラット フォームごとに個別の App Center コンテナーを作成する必要があります。

  9. Android OSでは、React ネイティブに、プラットフォームを選択します。

    ヒント

    プラットフォーム は、App Center 内のすべてのアプリが React ネイティブである必要があります。

    App Center アプリの構成。

  10. 新規アプリの追加を選択します。

  11. アプリのアプリ センター URL をコピーします。 これは、後で Power Apps でラップ プロジェクトを構成するために必要になります。

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

    App Center の URL。

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

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

参照