發布管理是客戶端升級新版本的配置后臺,支持用戶創建多任務、多維度的升級配置。
關于此任務
iOS 發布管理的功能包括以下方面:
增加升級資源并提示 App 的下載二維碼(僅限 企業分發)。
創建、修改新版本資源包的任務。
對已添加的發布包創建多種類型的發布任務,例如白名單灰度、時間窗灰度、正式發布。同一版本的升級包可以有多個發布任務。
支持多種條件的升級過濾,例如城市、機型、設備系統版本、網絡、發布包版本。
添加發布包
進入 mPaaS 控制臺,完成以下步驟:
在左側導航欄,點擊 實時發布 > 發布管理,頁面顯示發布管理列表。
點擊 + 添加發布包,在彈出的窗口中完成以下設置:
平臺:選擇 iOS。
發布類型:分為 AppStore、企業分發 與 TestFlight,詳見下方的說明。
AppStore:針對從 AppStore 下載的 App 提示升級。
企業分發:針對在企業內部分發的 App 提示升級。
TestFlight:針對即將發布到 AppStore 的新版本做上線前的灰度驗證。
點擊 確定,完成添加,新添加的發布包會出現在頁面的最上方。
在發布管理列表,點擊發布包前的加號圖標()查看升級包的發布任務:
如果升級包未發布過,當前包的狀態為 待發布,并且沒有任何發布任務。
如果升級包發布過,當前包的狀態為最新任務的發布狀態,并且有相關的發布任務。
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。
當一個版本同時發布灰度任務和正式任務時,列表發布狀態顯示為“正式發布”,當暫?;蚪Y束正式任務后,發布狀態顯示為“灰度發布”。如果所有任務都結束了,則顯示“已結束發布”。
操作步驟如下:
找到要創建發布任務的發布包。
在右側的 操作 列中,點擊 創建發布任務。
在 創建發布任務 頁面中,選擇或輸入以下信息:
發布類型:分為 灰度 與 正式。
灰度:在正式發布前,進行小規模發布以驗證新包的功能是否達到預期,發布對象是部分用戶。
正式:正式發布版本,發布對象是全部用戶。
說明TestFlight 與 企業分發 類型的發布包僅支持 灰度 發布。TestFlight 發布頁面不展示 發布類型 選項,企業分發 類型的發布包固定為 灰度 類型,且不可選擇。
升級模式:分為 單次、多次 與 強制升級。
單次:在 App 啟動后根據靜默策略提示升級。
說明靜默策略指彈出升級提示后,用戶點擊取消后一段時間內處于“靜默”狀態,不再提醒升級。默認靜默時間為 3 天,可自定義。如需自定義靜默時間,可參考 發布新版本。
多次:在 App 每次啟動后均提示升級。
強制升級:在 App 每次啟動后提示升級并且無法關閉提示窗。
說明TestFlight 類型的發布包無 強制升級,只有 單次 與 多次。
發布模型(僅限 灰度 發布):分為 白名單灰度 和 時間窗灰度。
當選擇 白名單灰度 時,您可在下方配置白名單。
說明您可在白名單管理中配置白名單。具體操作步驟,參見 白名單管理。
當選擇 時間窗灰度 時,您可在下方選擇時間窗的 結束時間 以及 灰度人數。
說明企業分發 類型的發布包無 時間窗灰度,只有 白名單灰度。
升級提示信息(選填):升級時所顯示的信息。
發布描述(選填):本次發布的描述信息。
高級規則(僅限 灰度 發布):點擊 添加,您可在彈出的窗口中選擇 包含 或 不包含 特定的 城市、機型、網絡 等信息,并選擇與 類型 對應的 資源值。
設置完畢后,點擊 確定,即可開始發布。您可點擊發布包左側的加號圖標()來查看剛剛創建的發布任務。
相關操作
上傳符號表。在發布管理列表,您可對已添加的發布包上傳符號表。
一個
.ipa
發布包對應一個符號表文件。只支持
dSYM
格式的符號表,且需要將文件壓縮成.tgz
格式上傳。
變更升級包的發布任務。在發布管理列表,點擊發布包前的加號圖標()查看升級包的發布任務。
點擊 暫停,暫停發布任務。暫停后,如要繼續進行該任務,點擊 繼續。
點擊 結束,終止發布任務。結束后,您不能再對任務做任何操作。