共用方式為


將 UWP WebView2 應用程式發佈到 Microsoft Store

UWP WebView2 應用程式是一個通用 Windows 平台 (UWP) 應用程式,負責承載 WebView2 控制項。 要讓 UWP WebView2 應用程式廣泛可用,你可以依照以下步驟將其發佈到 Microsoft Store

關於發佈到 Windows Store 的一般背景資訊,請參見「 開始指南:在 Microsoft Store 發佈你的第一個應用程式」。 以下步驟提供如何發布 UWP WebView2 應用程式的具體細節。

步驟 1:在 Visual Studio 中設定 Microsoft Store 帳號

確保你在 Microsoft Visual Studio 裡設定了 Microsoft Store 帳號。 請參閱 Microsoft Store 的「註冊為開發者」。

步驟 2:測試非封裝主機應用程式

在提交應用程式到 Microsoft Store 之前,請先測試這些常見的基本問題。 這將有助於防止商店認證失敗,避免延遲應用程式上架。

  1. 確保應用程式啟動時能正常運作。

  2. 確保應用程式在關機睡眠時能正常運作。

步驟 3:打包主機應用程式

Microsoft Store 需要提交一個打包好的應用程式。 請將您的應用程式包裝如下:

  1. 更新 package.appxmanifest 所有必要的內容,例如視覺資產、封裝名稱和應用程式資訊。 如果你不這麼做,Microsoft Store 驗證步驟就會失敗。 接著繼續以下步驟。

  2. 合作夥伴中心,選擇 專案>發佈 ,然後保留應用程式名稱。

  3. 透過選擇 「專案>發佈>」將應用程式與商店關聯,將應用程式與保留名稱關聯。

  4. 請選擇專案發佈(Project>Publish>)建立應用程式套件。 選擇目標配置:

    選擇目標配置

    32 位元與 64 位元版本的 WebView2 執行環境可在非 ARM 平台上的 UWP 中運作。 由於對 Microsoft Edge 的依賴,ARM 不支援 32 位元。 ARM 支援 64 位元。

  5. 當你的設定應用程式套件建立完成後, 建立應用程式套件 視窗會顯示 「完成建立套件 」對話框:

    Windows 應用程式認證組件

  6. 在對話框中,注意套件包的位置。 這些資訊也會在建構視窗中顯示。

  7. 點擊 關閉 按鈕。

步驟四:測試套件

為了確保套件中包含所有必要的內容檔案,並確保檔案擁有正確的權限,請測試你的套件應用程式,步驟如下:

  1. 使用產生的應用程式套件在你的電腦上安裝該應用程式。 注意是否有任何關於所需套件和功能的異常。

  2. 如果可能,也可以在其他機器上安裝你的應用程式。 注意是否有任何關於所需套件和功能的異常。

步驟五:Windows App WACK (運行認證套件)

Windows App 認證套件 (WACK) 是一款認證工具。 此工具會根據 Microsoft Store 的要求評估你的主機應用程式。

當你對套件中的應用程式正常運作感到滿意後,請執行 Windows App 認證套件 (WACK) :

  1. 如上所述,再次產生應用程式套件。 這是進入 Windows App 認證套件 (WACK) 流程最簡單的方法。

  2. 套件建立完成後,選擇啟動 Windows App 認證套件

  3. 您必須先核准 UAC) 存取控制 (使用者,才能讓 WACK) (Windows App 認證套件正常運作。

  4. 選擇 「全部 」作為測試套件,然後點 選「下一步」。

  5. 幾分鐘後,WACK (Windows App 認證套件) 顯示結果頁面。 如果應用程式失敗,請點擊連結查看結果。

解決測驗

WACK) 應用程式 (Windows App認證套件的結果頁面會顯示所有需要解決的測驗。

受限命名空間

如果你的應用程式未通過 限制命名空間 檢查,請編輯 package.appxmanifest 檔案並移除該 restrictedcapabilities 行及所有使用 rescap

WebView2 不應該需要任何限制功能才能運作。 如果你的應用程式需要功能受限,你必須透過 合作夥伴中心申請商店例外,或只透過非商店管道發佈應用程式。

品牌

如果你的應用程式未通過 品牌檢查 ,請依上述方式更新清單中的所有視覺資產。

APP 功能

如果你的應用程式在 App Capabilities 測試中失敗,請關閉所有不必要的功能。 如果你需要特殊使用功能,必須取得 Microsoft Store 的批准,或使用非 Store 的發行方式。

一般元資料正確性

如果你的應用程式在 一般元資料正確 性測試中失敗且出現錯誤 IPopup4,請更新 微軟。UI.xaml NuGet 套件可改為版本 Microsoft.UI.Xaml.2.8.0-prerelease.220118001 或更高版本。 在那個版本之前,貨單裡就有個錯誤。

支援的 API

在這個測試中,WACK 會檢查你主機應用程式呼叫的 Windows API,以確保它們是否被支援。

如果你的應用程式未通過支援 API 測試,請將 Windows SDK 更新到 22000 版本或更高版本,以獲得允許 API 清單的最新版本。 目前 Windows SDK 中不應該有 WebView2 的阻擋 API。

步驟 6:上傳應用程式套件

  • 在所有 WACK) 測試 (Windows App認證套件通過後,請透過以下任一方式將您的應用程式套件上傳至 Windows Store:

    • 方法一:在 WACK) (Windows App 認證套件中,選擇「專案>發佈>上傳應用程式套件」。

    • 方法二:前往合作夥伴中心,透過合作夥伴中心將你的應用程式套件上傳到 Windows 商店。

另請參閱