全部產品
Search
文件中心

Mobile Platform as a Service:iOS 發行管理

更新時間:Jul 13, 2024

發行管理是用戶端升級新版本的配置後台,支援使用者建立多任務、多維度升級配置。

關於此任務

iOS 發行管理的功能包括以下方面:

  • 增加升級資源並提示 App 的下載二維碼(僅限 企業分發)。

  • 建立、修改新版本資源套件的任務。

  • 對已添加的發布包建立多種類型的發布任務,例如白名單灰階、時間窗灰階、正式發布。同一版本的升級包可以有多個發布任務。

  • 支援多種條件的升級過濾,例如城市、機型、裝置系統版本、網路、發布包版本。

添加發布包

進入 mPaaS 控制台,完成以下步驟:

  1. 在左側導覽列,點擊 即時發布 > 發行管理,頁面顯示發行管理列表。

  2. 點擊 + 添加發布包,在彈出的視窗中完成以下設定:

    • 平台:選擇 iOS

    • 發布類型:分為 AppStore企業分發TestFlight,詳見下方的說明。

      • AppStore:針對從 AppStore 下載的 App 提示升級。

      • 企業分發:針對在企業內部分發的 App 提示升級。

      • TestFlight:針對即將發布到 AppStore 的新版本做上線前的灰階驗證。

  3. 點擊 確定,完成添加,新添加的發布包會出現在頁面的最上方。

  4. 在發行管理列表,點擊發布包前的加號表徵圖(add)查看升級包的發布任務:

    • 如果升級包未發布過,當前包的狀態為 待發布,並且沒有任何發布任務。

    • 如果升級包發布過,當前包的狀態為最新任務的發布狀態,並且有相關的發布任務。

AppStore

說明

要使用 AppStore 發布,您需要先在蘋果官方 App Store 中上架您的 App。

當您選擇 AppStore 為發布類型時,您需要輸入以下資訊:

  • appstore 地址:您的 App 在 App Store 上的地址。

  • 版本號碼:發布包的版本號碼。此版本號碼需與 iOS 工程 info.plist 檔案中的 Product Version 欄位保持一致。

  • 發布描述(選填):發布包的描述資訊。

企業分發

當您選擇 企業分發 為發布類型時,您需要選擇或輸入以下資訊:

  • 上傳表徵圖(可選):可上傳 .jpg.png 格式的圖片作為表徵圖。

  • 發布包:從本地選擇發布包進行上傳,只支援 .ipa 格式。

  • bundleId(選填):您的 App 的 bundleId,若不填則使用在代碼配置頁面下載設定檔時填寫的 bundleId。

  • 版本號碼:發布包的版本號碼。此版本號碼需與 iOS 工程 info.plist 檔案中的 Product Version 欄位保持一致。

  • 發布描述(選填):發布包的描述資訊。

  • 下載驗證:如開啟該開關,則使用者在掃描二維碼後,需要通過驗證碼驗證才能下載發布包。

    說明

    添加 企業分發 類型的發布包後,在發布包列表頁的 二維碼 列中會產生一個下載 .ipa 發布包的二維碼,掃描該二維碼後,即可將發布包安裝至手機。

TestFlight

說明

  • 要使用 TestFlight 測試功能,您必須已在 App Store Connect 中建立並啟用了公開連結。

  • 只有在版本 ≥ 10.1.32 的用戶端中才可使用 TestFlight。

  • 您輸入的 包失效時間 測試人員上限 必須與您在 App Store Connect 中設定的一致。

當您選擇 TestFlight 為發布類型時,您需要輸入以下資訊:

  • 公開連結地址:您在 App Store Connect 中建立的公開連結地址,需保證此連結是啟用狀態。

  • 包失效時間:TestFlight 包的失效時間,需與您在 App Store Connect 中設定的一致。

  • 測試人員上限:參與測試的人員上限,需與您在 App Store Connect 中設定的一致。

  • 版本號碼:發布包的版本號碼。此版本號碼需與 iOS 工程 info.plist 檔案中的 Product Version 欄位保持一致。

  • 發布描述(選填):發布包的描述資訊。

建立發布任務

對已添加的發布包建立發布任務,支援為同一版本的發布包同時建立多個發布任務。單個升級包最多支援同時發布 10 個任務。

發布任務下發規則:

  • 當用戶端請求匹配到多個發布任務時,優先下發高版本任務。

  • 當同一個發布包版本命中多個發布任務時,按照任務類型,發布任務的下發優先順序從高到低為:正式 > 白名單(灰階)> 時間窗(灰階)。

  • 若發布包版本相同,任務類型也相同,則以最新發行的任務為準。例如,在控制台上發布了一個 5.0 版本的白名單任務 A,針對 4.0 版本進行單次升級;接著又發布了一個白名單任務 B,針對 4.0 版本做強制升級。這兩個任務同時存在,當 4.0 版本的用戶端請求升級時,首先下發任務 B,在任務 B 終止或者暫停後,下發任務 A。

  • 當一個版本同時發布灰階任務和正式任務時,列表發布狀態顯示為“正式發布”,當暫停或結束正式任務後,發布狀態顯示為“灰階發布”。如果所有任務都結束了,則顯示“已結束髮布”。

操作步驟如下:

  1. 找到要建立發布任務的發布包。

  2. 在右側的 操作 列中,點擊 建立發布任務

  3. 建立發布任務 頁面中,選擇或輸入以下資訊:

    • 發布類型:分為 灰階正式

      • 灰階:在正式發布前,進行小規模發布以驗證新包的功能是否達到預期,發布對象是部分使用者。

      • 正式:正式發布版本,發布對象是全部使用者。

        說明

        TestFlight企業分發 類型的發布包僅支援 灰階 發布。TestFlight 發佈頁面不展示 發布類型 選項,企業分發 類型的發布包固定為 灰階 類型,且不可選擇。

    • 升級模式:分為 單次多次強制升級

      • 單次:在 App 啟動後根據靜默原則提示升級。

        說明

        靜默策略指彈出升級提示後,使用者點擊取消後一段時間內處於“靜默”狀態,不再提醒升級。預設靜默時間為 3 天,可自訂。如需自訂靜默時間,可參考 發布新版本

      • 多次:在 App 每次啟動後均提示升級。

      • 強制升級:在 App 每次啟動後提示升級並且無法關閉提示窗。

        說明

        TestFlight 類型的發布包無 強制升級,只有 單次多次

    • 發布模型(僅限 灰階 發布):分為 白名單灰階時間窗灰階

      • 當選擇 白名單灰階 時,您可在下方配置白名單。

        說明

        您可在白名單管理中配置白名單。具體操作步驟,參見 白名單管理

      • 當選擇 時間窗灰階 時,您可在下方選擇時間窗的 結束時間 以及 灰階人數

        說明

        企業分發 類型的發布包無 時間窗灰階,只有 白名單灰階

    • 升級提示資訊(選填):升級時所顯示的資訊。

    • 發布描述(選填):本次發布的描述資訊。

    • 進階規則(僅限 灰階 發布):點擊 添加,您可在彈出的視窗中選擇 包含不包含 特定的 城市機型網路 等資訊,並選擇與 類型 對應的 資源值

  4. 設定完畢後,點擊 確定,即可開始發布。您可點擊發布包左側的加號表徵圖(add)來查看剛剛建立的發布任務。

相關操作

  • 上傳符號表。在發行管理列表,您可對已添加的發布包上傳符號表。

    • 一個 .ipa 發布包對應一個符號表檔案。

    • 只支援 dSYM 格式的符號表,且需要將檔案壓縮成 .tgz 格式上傳。

  • 變更升級包的發布任務。在發行管理列表,點擊發布包前的加號表徵圖(add)查看升級包的發布任務。

    • 點擊 暫停,暫停發布任務。暫停後,如要繼續進行該任務,點擊 繼續

    • 點擊 結束,終止發布任務。結束後,您不能再對任務做任何操作。