通过

Power Apps 中整合功能的故障排除问题

  • 项目

本文可帮助你解决 Microsoft Power Apps 中包装功能的最常见问题。

问题 1 - 包装生成失败

如果包装生成失败，可以执行以下步骤来解决该问题。

步骤 1：验证图像是否采用 PNG 格式

确保包装中使用的图像采用 PNG 格式。 换行使用 PNG 以外的任何格式的图像将导致生成失败。 使用图像转换器将图像 另存为.png 文件，或确保原始图像文件采用 PNG 格式。

重要

将图像文件扩展名 从.jpeg 或任何其他格式手动更改为 .png 不会自动将图像重新格式化为 PNG 格式。

步骤 2：验证是否已正确配置 App Center

应用中心链接必须作为组织中的应用创建，而不是作为独立应用创建。 以下屏幕截图显示了如何在包装向导中创建新组织。

显示如何在包装向导中创建新的应用中心位置的屏幕截图。

有关如何在包装向导中自动创建新位置的详细信息，请参阅 “使用向导为 iOS 和 Android 创建本机移动应用”部分中的步骤 5：管理输出 。

步骤 3：验证密钥保管库配置是否正确

请确保已创建 Azure 服务主体，并正确添加服务主体角色。 有关详细信息，请参阅使用向导为 iOS 和 Android 创建本机移动应用中的步骤 1 和 2。

确保密钥保管库包含 iOS、Android 或两者的所有必需证书、机密和标记：

  • iOS：两个标记、一个证书和一个机密
  • Android：一个标记和一个证书

有关详细信息，请参阅 创建 Azure 密钥保管库以包装 Power Apps。

步骤 4：如果具有所有正确的配置，请重试

如果包装生成在验证包装项目是否具有所有正确的配置后仍然失败，请参阅 本文包装 部分中的其他问题。

问题 2 - 已为应用禁用包装按钮

只能包装具有编辑权限的应用。 请确保你对要包装的应用拥有编辑权限，然后重试。

问题 3 - 无法保存项目或触发包装生成

若要解决此问题，您可以：

  • 更新到最新的包装解决方案版本，然后重试。
  • 确保没有 UI 验证错误阻止 “保存 ”或 “生成” 提交。

问题 4 - 无法在设备上安装包装的移动应用

请确保已对输出的应用程序进行签名。 可以通过配置密钥保管库并在生成触发时提供密钥保管库或手动签名来对其进行签名。 有关代码签名的详细信息，请参阅：

验证移动设备是否满足这些 最低要求。

问题 5 - 无法登录到包装的移动应用或看不到数据

如果无法登录到包装的移动应用，请验证：

  • Microsoft Entra 应用已正确配置。

  • 已正确添加应用的所有 API 权限。 有关如何查看和配置应用的 API 权限的详细信息，请参阅以下屏幕截图和 配置 API 权限。

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

  • 脚本 Add-AdminAllowedThirdPartyApps 已成功运行。 有关详细信息，请参阅 “允许在你的环境中注册的应用”。

  • Microsoft Entra 应用类型为 多租户。 在Microsoft Entra 应用的“身份验证”选项卡下，支持帐户类型应为任何组织目录中的帐户（任何Microsoft Entra 目录 - 多租户）。

  • 为 iOS 和 Android 创建了正确的重定向 URI。 对于 Android，请确认哈希已正确提供。 有关配置重定向 URI 的详细信息，请参阅 “配置平台设置”。

问题 6 - Power Apps 包装的 Azure 密钥保管库中的错误

对于 Power Apps，可能会出现以下 Azure 密钥保管库错误，可以进行纠正。

错误代码1000118

错误代码 说明
1000118 找不到默认订阅或缺少访问权限

注意

自 2024 年 3 月 30 日起，Azure AD 和 MSOnline PowerShell 模块已弃用。 若要了解详细信息，请阅读有关弃用的更新。 在此日期之后，对这些模块的支持仅限于到 Microsoft Graph PowerShell SDK 的迁移帮助和安全性修复。 弃用的模块将持续运行至 2025 年 3 月 30 日。

我们建议迁移到 Microsoft Graph PowerShell，以便与 Microsoft Entra ID（以前称为 Azure AD）进行交互。 有关常见迁移问题，请参阅迁移常见问题解答。 注意：2024 年 6 月 30 日之后，MSOnline 版本 1.0.x 可能会遇到中断。

  1. 确保 Azure 密钥保管库位于租户 的默认订阅中。

  2. 以管理员身份在 PowerShell 中运行以下命令：

    Connect-AzureAD -TenantId <your tenant ID>

    New-AzureADServicePrincipal -AppId 4e1f8dc5-5a42-45ce-a096-700fa485ba20 -DisplayName "Wrap KeyVault Access App"

  3. 在Azure 门户中，转到默认订阅。 在“访问控制（IAM）页上，向表示应用的服务主体添加读取者角色分配，例如”包装 KeyVault 访问应用”。 请确保它位于 订阅的 IAM 和 Keyvault 的 IAM 中。 步骤如下：

    1. 转到“访问控制”（IAM）选项卡，然后选择“添加菜单”按钮下的“添加角色分配”选项。

      显示访问控制（IAM）选项卡中的“添加角色分配”选项的屏幕截图。

    2. 选择“作业函数角色”选项卡，并确保已选择“读取者”角色。 然后选择顶部菜单上的“成员”选项卡。

      显示顶部菜单上的“成员”选项卡的屏幕截图。

    3. 在“成员”选项卡上搜索“包装 KeyVault Access 应用”。

      显示如何搜索 Wrap KeyVault Access 应用的屏幕截图。

    4. 选择 “包装 KeyVault 访问应用 ”，然后选择 选项卡底部的“审阅 + 分配 ”按钮，为其分配“ 读取者 ”角色。

      显示如何向 Wrap KeyVault Access App 分配读取者角色的屏幕截图。

错误代码1000119

错误代码 说明
1000119 Keyvault 不存在，或者 Keyvault 缺少访问权限

  1. 验证 Azure 密钥保管库是否位于租户 的默认订阅中。

  2. 创建密钥保管库时， 请确保已选择保管库访问策略 选项。

    在“访问配置”选项卡下选择保管库访问策略选项。

  3. 以管理员身份在 PowerShell 中运行以下命令：

     Connect-AzureAD -TenantId <your tenant ID>

    New-AzureADServicePrincipal -AppId 4e1f8dc5-5a42-45ce-a096-700fa485ba20 -DisplayName "Wrap KeyVault Access App"

  4. 在Azure 门户中，转到默认订阅。 在“访问控制（IAM）页上，向表示应用的服务主体添加读取者角色分配，例如”包装 KeyVault 访问应用”。 请确保它位于 订阅的 IAM 和 Keyvault 的 IAM 中。 步骤如下：

    1. 转到“访问控制”（IAM）选项卡，然后选择“添加菜单”按钮下的“添加角色分配”选项。

      显示访问控制（IAM）选项卡中的“添加角色分配”选项的屏幕截图。

    2. 选择“作业函数角色”选项卡，并确保已选择“读取者”角色。 然后选择顶部菜单上的“成员”选项卡。

      显示顶部菜单上的“成员”选项卡的屏幕截图。

    3. 在“成员”选项卡上搜索“包装 KeyVault Access 应用”。

      显示如何搜索 Wrap KeyVault Access 应用的屏幕截图。

    4. 选择 “包装 KeyVault 访问应用 ”，然后选择 选项卡底部的“审阅 + 分配 ”按钮，为其分配“ 读取者 ”角色。

      显示如何向 Wrap KeyVault Access App 分配读取者角色的屏幕截图。

  5. 将访问策略添加到 Azure 密钥保管库。

    显示如何为 Azure 密钥保管库添加访问策略的屏幕截图。

    显示如何查看和创建保管库访问策略的屏幕截图。

错误代码1000120

错误代码 说明
1000120 在密钥保管库上找不到组织 ID 标记

  1. 转到 Power Platform 管理中心，选择“环境”，然后选择包装项目所在的环境。

    显示 Power Platform 管理中心中的“环境”选项卡的屏幕截图。

  2. 复制组织 ID。

    显示可在 Power Platform 管理中心中找到的组织 ID 的屏幕截图。

  3. 在Azure 门户的密钥保管库中，转到“标记”，创建新的名为组织 ID 的标记，并将组织 ID 添加到此标记。

    显示如何将组织 ID 添加到Azure 门户中的标记的屏幕截图。

错误代码1000121

错误代码 说明
1000121 Android 密钥存储无效。 缺少标记和/或证书

  1. 导入 Android 证书。

    显示如何导入 Android 证书的屏幕截图。

    显示如何创建 Android 证书的屏幕截图。

  2. 为证书添加新标记。

    • 标记名称应基于包装项目中使用的捆绑 ID。 例如，如果 包装应用的捆绑 ID 为 com.testApp.wrap，则新的 标记名称 应为 com.testApp.wrap.keystore。

    • 标记 值 应与在上一步中上传证书文件时为 证书 选择的名称相对应。 例如，如果证书名为 AndroidWrapCertificate，则标记值的值也应为 AndroidWrapCertificate。

    显示如何创建证书标记的屏幕截图。

错误代码1000122

错误代码 说明
1000122 iOS 证书无效

  1. 导入 iOS 证书。

    显示如何导入 iOS 证书的屏幕截图。

    显示如何创建 iOS 证书的屏幕截图。

  2. 为证书添加新标记。

    • 标记名称应基于包装项目中使用的捆绑 ID。 例如，如果 包装应用的捆绑 ID 为 com.testApp.wrap，则新的 标记名称 应为 com.testApp.wrap.cert。

    • 标记 值 应与在上一步中上传证书文件时为 证书 选择的名称相对应。 例如，如果证书名为 iOSCertificate1，则标记值的值也应为 iOSCertificate1。

    显示如何为 iOS 创建证书标记的屏幕截图。

错误代码1000123

错误代码 说明
1000123 iOS 配置文件无效

  1. 将 预配配置文件 导入为 机密。

  2. 为预配配置文件添加新标记。

    • 标记名称应基于包装项目中使用的捆绑 ID。 例如，如果 包装应用的捆绑 ID 为 com.testApp.wrap，则新的 标记名称 应为 com.testApp.wrap.profile。

    • 标记 值 应对应于在上一步中上传 povisioning 配置文件时为 机密 选择的名称。 例如，如果机密名为 iOSProvisioningProfileSecret，则标记值的值也应为 iOSProvisioningProfileSecret。

    显示如何为 iOS 预配配置文件机密创建标记的屏幕截图。

Power Apps 的其他问题包装

对于所有其他问题，或者如果问题在执行这些步骤后仍然存在，请参阅 本文后面的后续步骤 ，通过支持请求报告问题。 需要提供重现视频、屏幕截图或两者，以及可通过以下方式获取的会话 ID：

  • 在登录屏幕上，转到右下角选择齿轮图标，然后选择“ 会话详细信息”。
  • 打开应用后，点击并按住屏幕，然后选择“ 会话详细信息”。

后续步骤

如果本文未列出你的问题，可以 搜索更多支持资源，或联系 Microsoft支持人员。 有关详细信息，请参阅 “获取帮助 + 支持”。