針對 Power Apps 中的包裝功能問題進行疑難解答

  • 發行項

本文可協助您解決 Microsoft Power Apps 中包裝功能最常見的問題。

問題 1 - 包裝組建失敗

如果您的包裝組建失敗，您可以採取下列步驟來解決問題。

步驟 1：確認您的映射為 PNG 格式

請確定您以包裝方式使用的映像是 PNG 格式。 使用非 PNG 包裝格式的映像，會導致建置失敗。 使用影像轉換器將影像儲存為 .png 檔案，或確定原始圖像檔案為 PNG 格式。

重要事項

手動將映像擴展名從 .jpeg 或任何其他格式變更 為.png 不會自動將映像重新格式化為 PNG 格式。

步驟 2：確認您的 App Center 已正確設定

您的 App Center 連結必須建立為組織內的應用程式，而不是獨立應用程式。 下列螢幕快照顯示如何以包裝精靈建立新的組織。

顯示如何在包裝精靈中建立新應用程式中心位置的螢幕快照。

For more information about how to automatically create a new location in wrap wizard, see Step 5: Manage output in the "Create native mobile apps for iOS and Android using the wizard" section.

步驟 3：確認您的金鑰保存庫設定正確無誤

請確定已建立 Azure 服務主體，並已正確新增服務主體角色。 如需詳細資訊，請參閱使用精靈 Create 適用於iOS和Android的原生行動應用程式中的步驟1和2。

確定您的金鑰保存庫包含 iOS、Android 或兩者的所有必要憑證、秘密和標籤：

  • iOS：兩個標記、一個憑證和一個秘密
  • Android：一個標籤和一個憑證

如需詳細資訊，請參閱 Create 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 金鑰保存庫中發生錯誤

下列 Azure 金鑰保存庫錯誤可能會出現在 Power Apps 的包裝中，而且可以加以修正。

錯誤碼1000118

錯誤碼 描述
1000118 找不到預設訂用帳戶，或遺失訪問許可權

注意事項

自 2024 年 3 月 30 日起，Azure AD 和 MSOnline PowerShell 模組已被取代。 若要深入瞭解，請閱讀 淘汰更新。 在此日期之後，這些模組的支援僅限於 Microsoft Graph PowerShell SDK 的移轉協助和安全性修正。 已淘汰的模組會繼續運作到 2025 年 3 月 30 日。

建議您移轉至 Microsoft Graph PowerShell，以與 Microsoft Entra ID (先前的 Azure AD) 互動。 如需常見的移轉問題，請參閱 移轉常見問題。 注意： 1.0.x 版的 MSOnline 可能會在 2024 年 6 月 30 日之後中斷。

  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 存取應用程式]。

      顯示如何搜尋包裝KeyVault存取應用程式的螢幕快照。

    4. 選 取 [包裝 KeyVault 存取應用程式] ，然後選取索引卷標底部的 [ 檢閱 + 指派 ] 按鈕，將 讀者 角色指派給它。

      顯示如何將讀者角色指派給包裝KeyVault存取應用程式的螢幕快照。

錯誤碼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 存取應用程式]。

      顯示如何搜尋包裝KeyVault存取應用程式的螢幕快照。

    4. 選 取 [包裝 KeyVault 存取應用程式] ，然後選取索引卷標底部的 [ 檢閱 + 指派 ] 按鈕，將 讀者 角色指派給它。

      顯示如何將讀者角色指派給包裝KeyVault存取應用程式的螢幕快照。

  5. 將存取原則新增至您的 Azure 金鑰保存庫。

    顯示如何新增 Azure 金鑰保存庫存取原則的螢幕快照。

    顯示如何檢閱和建立保存庫存取原則的螢幕快照。

錯誤碼1000120

錯誤碼 描述
1000120 在金鑰保存庫上找不到組織標識子標籤

  1. 移至 Power Platform 系統管理中心，選取 [ 環境] ，然後選取包裝專案所在的環境。

    顯示 Power Platform 系統管理中心 [環境] 索引標籤的螢幕快照。

  2. 複製 [組織標識符]。

    此螢幕快照顯示您可以在Power Platform系統管理中心的環境中找到的組織識別碼。

  3. 在 Azure 入口網站 中的金鑰保存庫中，移至 [標記]，建立名為 organization-id 的新標籤，然後將您的組織標識元新增至此標籤。

    顯示如何將組織標識元新增至 Azure 入口網站 中標籤的螢幕快照。

錯誤碼1000121

錯誤碼 描述
1000121 Android 金鑰存放區無效。 遺漏標籤和/或憑證

  1. 匯入 您的 Android 憑證。

    顯示如何匯入Android憑證的螢幕快照。

    顯示如何建立Android憑證的螢幕快照。

  2. 為您的憑證新增標籤。

    • 標籤名稱應該以您在包裝專案中使用的套件組合識別元為基礎。 例如，如果您已包裝應用程式的套件 組合標識 符是 com.testApp.wrap，則新的 標籤名稱 應該是 com.testApp.wrap.keystore。

    • 在上傳上一個步驟中的憑證檔案時， Tag 值 應該會對應至您為 憑證 選擇的名稱。 例如，如果您的 憑證 名為 AndroidWrapCertificate，則 Tag值的值 也應該是 AndroidWrapCertificate。

    顯示如何建立憑證標籤的螢幕快照。

錯誤碼1000122

錯誤碼 描述
1000122 iOS 憑證無效

  1. 匯入 您的 iOS 憑證。

    顯示如何匯入 iOS 憑證的螢幕快照。

    顯示如何建立 iOS 憑證的螢幕快照。

  2. 為您的憑證新增標籤。

    • 標籤名稱應該以您在包裝專案中使用的套件組合識別元為基礎。 例如，如果包裝應用程式的 套件組合標識 符是 com.testApp.wrap，則新的 標籤名稱 應該是 com.testApp.wrap.cert。

    • 在上傳上一個步驟中的憑證檔案時， Tag 值 應該會對應至您為 憑證 選擇的名稱。 例如，如果您的 憑證 名為 iOSCertificate1，則 Tag值的值 也應該是 iOSCertificate1。

    顯示如何建立 iOS 憑證標籤卷標的螢幕快照。

錯誤碼1000123

錯誤碼 描述
1000123 iOS 設定檔無效

  1. 將您的 布建配置檔匯入 為 秘密。

  2. 為您的布建配置檔新增標籤。

    • 標籤名稱應該以您在包裝專案中使用的套件組合識別元為基礎。 例如，如果包裝應用程式的 套件組合標識 符是 com.testApp.wrap，則新的 標籤名稱 應該是 com.testApp.wrap.profile。

    • Tag 值應該會對應至您在上傳上一個步驟中的配置檔時，為秘密選擇的名稱。 例如，如果您 的秘密 名為 iOSProvisioningProfileSecret，則 Tag 值的值 也應該是 iOSProvisioningProfileSecret。

    顯示如何建立 iOS 佈建配置檔秘密標籤的螢幕快照。

Power Apps 的其他包裝問題

對於所有其他問題，或如果您的問題在遵循這些步驟之後持續發生，請參閱本文稍後的 後續步驟 ，以透過支援要求回報問題。 您必須提供重現視訊、螢幕快照或兩者，以及可透過下列方式取得的作業階段識別碼：

  • 在登入畫面上，移至右下角選取齒輪圖示，然後選取 [ 會話詳細數據]。
  • 開啟應用程式之後，點選並按住畫面，然後選取 [ 會話詳細數據]。

後續步驟

如果您的問題未列在本文中，您可以 搜尋更多支持資源，或連絡 Microsoft 支援服務。 如需詳細資訊，請 參閱取得說明 + 支援。