通过

使用整合向导构建移动应用

  • 项目

使用分步向导来使用整合功能将一个或多个画布应用打包为单个本机移动应用包。

利用 Power Apps 中的整合功能，您可以创建画布应用的本机移动版本作为自定义品牌的 Android 和 iOS 移动应用。 可以通过 Microsoft App Center、Google Play 或 Apple Business Manager 或其他本机分发方法将此类已整合本机移动应用分发给最终用户。

利用整合功能，您可以为 iOS、Android 或 Google Play 商店创建移动应用：

  • iOS（IPA 包）
  • Android（APK 包）
  • 用于 Google Play 商店分发（AAB 软件包）

整合功能会将您的画布应用整合在本机移动应用外壳中，以便您进行数字签名和分发。 当您更新应用并重新发布它时，该应用会自动更新。

使用向导创建适用于 iOS 和 Android 的本机移动应用

  1. 登录到 Power Apps。

  2. 在左侧导航窗格中选择整合。 如果项目不在侧面板窗格中，请选择 …更多，然后选择所需项目。

  3. 选择要整合的应用，然后在命令栏上选择整合。

步骤 1：选择应用

  1. 在选择要整合的应用屏幕上，选择您的主要应用和次要应用。

    • 主应用：选择启动移动应用时，最终用户看到的应用。

    • 次要应用：您与主要应用一起为移动应用包捆绑的同一个构建。

      选择您要整合的应用。

      备注

      • 您可以在多个整合项目中使用相同的主要应用。
      • 在整合向导中，如果主要应用名称显示不正确，继续执行下一步，然后返回查看正确的名称。

  2. 选择下一步。

步骤 2：注册您的应用

在注册您的应用屏幕上，在 Azure 中手动注册您的应用程序，以在应用与 Microsoft 标识平台之间建立信任关系。 详细信息： 在 Azure 门户中手动注册应用。

应用必须在 Microsoft Entra 中注册，这样应用用户才能登录。 如果您已注册，请在自有注册字段中找到您的注册。

创建新应用注册。

如果在自有注册下拉菜单中未看到已注册的应用程序名称，请按照以下步骤操作。

  • 选择新应用注册，以便自动为您的应用创建新注册。

  • 您需要提供应用程序名称和 Android 签名哈希，它们是必填字段。 应用程序名称是必填字段，因为它是应用程序面向客户的名称。 如果在创建和构建 Wrap 项目时选择了 Android 作为平台之一，则需要 Android 签名散列。

    备注

    Android 哈希密钥的格式是 28 位字母数字哈数字，如 –ga0RGNYHvNM5d0SLGQfpQWAPGJ8=。 如果签名哈希密钥已存在，则无需创建新的哈希密钥。 在创建新的应用注册时，可以重复使用以前生成的签名哈希密钥。

    添加应用注册详细信息。

配置管理员允许的第三方应用

整合向导将自动为应用配置所有必需的 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 并提供需要管理员访问权限的应用程序 ID。
  • 运行 Get-AdminAllowedThirdPartyApps 验证您的应用程序名称是否出现在列表中。

完成前述步骤后，注册界面如下截图所示。

显示注册屏幕的屏幕截图，其中有绿色勾号表示已完成的步骤

API 权限

注册应用时，Azure 管理员还需要授予对应用的 API 权限。 请参阅以下屏幕截图，了解有关授予访问权限的说明以及需要 API 权限的原因。

显示应用的 API 权限的屏幕截图。

备注

在此步骤中，有时对于新客户，只有应用程序名称字段可见。 不显示用于添加 Android 签名哈希的字段。 要解决此问题，继续执行后续步骤，在目标平台步骤中选择 Android 作为目标平台。

步骤 3：配置品牌打造

  1. 在配置品牌推广步骤中，为您的应用设置以下外观选项：

    备注

    所有图像都必须采用 .png 格式。 如果未选择自定义图像，将使用默认图像。

    • 应用图标：上传图标以用于您的应用。 建议 iOS 尺寸：1024 像素 x 1024 像素 .png 图像或更大。 建议 Android 图像尺寸：432 像素 x 432 像素 .png 图像或更大。
    • 初始屏幕图像：加载时在移动应用的初始屏幕上使用的图像。 未提供时使用的默认图像。
    • 欢迎屏幕图像：加载时将在移动应用的欢迎（登录）屏幕上使用的图像。 未提供时使用的默认图像。
    • 背景填充颜色：用于欢迎屏幕背景的十六进制颜色代码。
    • 按钮填充颜色：用于填充按钮颜色的十六进制颜色代码。
    • 状态栏文本主题：应用顶部状态栏文本的颜色。

  2. 选择下一步。

步骤 4：目标平台

  1. 在选择要面向的平台屏幕上，输入我们选择的捆绑销售 ID。

    备注

    捆绑销售 ID 是您为您的应用创建的唯一标识符。 捆绑销售 ID 必须包含一个句点 (.)，并且没有空格。

  2. 在目标平台下面，选择您的最终用户在其移动设备上使用的所有移动平台。

  3. 将为我的应用签名切换设置为开，自动对您的移动应用进行代码签名，然后从列表中选择 Azure Key Vault URI，然后选择下一步。 如果您在 Azure Key Vault URI 列表中无任何条目，则需要先创建 Azure Key Vault。 详细信息：创建用于 Power Apps 整合的 Azure 密钥保管库。

    选择要整合的应用。

您也可以手动为移动应用包进行代码签名，而不是使用整合向导中的自动代码签名功能。 有关如何手动为应用进行代码签名的详细信息，请参阅：

备注

Wrap 向导提供了一个自动登录过程。 不过，熟悉移动流程的开发人员可以使用每个平台的不同机制手动登录其 Android 或 iOS 应用程序。 如果通过手动过程登录，则无需创建 Azure 密钥保管库。

  1. 选择下一步。

步骤 5：Azure blob 存储

  1. 创建 Azure 密钥保管库（如果尚未创建）。 更多信息：使用默认订阅创建用于 wrap 的 Azure 密钥保管库
  2. 创建 Azure Blob 存储帐户和容器名称。 更多信息：创建 Azure 存储账户
  3. 通过单击下拉列表添加 Azure 密钥保管库 URI。
  4. 添加 Azure Blob 存储帐户名称和在 Azure Blob 存储帐户创建步骤中创建的容器名称。
  5. 生成步骤完成后，从上面创建的 Azure blob 存储位置下载生成的 APK/IPA。

步骤 6：整合

在整合屏幕上，查看应用详细信息，然后选择生成。 构建成功后，您将在上一步选择的 Azure blob 存储位置中看到您的移动应用程序。

测试和分发移动应用包

测试并发布应用程序。 如果在测试过程中遇到任何问题，请查看故障排除页面

手动在 Azure 门户上注册您的应用（可选）

您可以按照步骤 4 中的介绍在整合向导中自动创建您的应用注册。 或者，您也可以在 Azure 门户上手动为您的应用创建新注册。 详细信息：快速入门：使用 Microsoft 标识平台注册应用程序。

备注

单租户和多租户客户都可以使用整合功能根据其 Power Apps 画布应用创建本机移动应用。

无论您是单租户还是多租户制作者，在为您的应用选择支持的帐户类型以对其启用整合时，必须选择包含任何 Microsoft Entra 目录 - 多租户的任何选项。 选择以下帐户类型之一：

  • 任何组织目录（任何 Microsoft Entra 目录 - 多租户）中的帐户
  • 任何组织目录（任何 Microsoft Entra 目录 - 多租户）中的帐户和个人 Microsoft 帐户，例如，Skype 或 Xbox。

应用注册 - 整合支持的帐户类型。

重要提示

  • 整合目前仅支持多租户帐户类型。 还不支持单租户帐户类型。 关于帐户类型的详细信息：Microsoft 身份平台中的帐户类型。
  • 您必须为要定位的每个平台（iOS、Android）创建一个单独的重定向 URI。

手动为应用配置 API 权限（可选）

完成步骤 4 后，整合向导将自动为您的应用配置所有必需的 API 权限。

如果整合向导中出错，您可以手动配置 API 权限。 详细信息：添加和配置

手动配置 API 权限时需要以下 API 权限：

  • Microsoft API
    • 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 位置。 详细信息：App Center 位置

小费

有关 App Center 的详细信息，请转到 Visual Studio App Center 文档。

  1. 转到 App Center。

  2. 使用您的工作或学校帐户登录。

  3. 如果您没有任何现有组织，选择新增>添加新组织创建新组织。

  4. 从左侧窗格的列表中选择组织。

  5. 选择应用>添加应用。

  6. 输入应用名称。

  7. 选择应用发布类型。

  8. 为 iOS 应用选择自定义操作系统，或为 Android 应用选择 Android 操作系统。

    备注

    您必须为每个平台创建单独的 App Center 容器。

  9. 对于 Android 操作系统，平台选择React Native。

    备注

    对于 App Center 中的所有应用，平台均必须为 React Native。

    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 设备不同。

另请参见