全部產品
Search
文件中心

Mobile Platform as a Service:mPaaS 10.1.68 升級指南

更新時間:Jul 13, 2024

mPaaS 10.1.68 發布說明

  1. 從 10.1.68 基準開始正式廢棄 UIWebView,只支援 WKWebView,詳情可參考 mPaaS 適配 WKWebView。App Store 從 2020 年 4 月起不再接受使用 UIWebView 的新 APP,從 2020 年 12 月起不再接受使用 UIWebview 的 APP 的更新。請您儘快升級到 10.1.68 基準,適配 WKWebView。

  2. 支援 Xcode 11 構建靜態庫打包,相容 Xcode 11 開發。

mPaaS 10.1.68 升級指南

使用 CocoaPods 接入升級

前提條件

已安裝 CocoaPods mPaaS 外掛程式。

  • 如您尚未安裝 CocoaPods mPaaS外掛程式,請您在終端執行以下指令碼安裝 CocoaPods 外掛程式。

      sh <(curl -s http://mpaas-ios.oss-cn-hangzhou.aliyuncs.com/cocoapods/installmPaaSCocoaPodsPlugin.sh)
  • 如您已安裝了 CocoaPods mPaaS 外掛程式,則可以直接使用升級命令pod mpaas update --all升級外掛程式。更多 CocoaPods mPaaS 外掛程式使用資訊,請參見 基於原生架構且使用 CocoaPods 接入

操作步驟

  1. 在 Podfile 中,將 SDK 版本設定改為 10.1.682

  2. 執行 pod mpaas update 10.1.68,即可安裝 10.1.68 基準的最新 SDK。

  3. 根據需要執行 pod installpod update 即可完成對應工程下 10.1.68 的升級。

後續步驟

如果在 CocoaPods 接入時出現類似如下的錯誤:

Invalid `Podfile` file: [!] No mPaaS_Nebula : 10.1.68 found !!! Check name & version in Podfile.

可嘗試按照以下步驟解決:

  1. 運行 gem list | grep 'mPaaS' 命令檢查 CocoaPods 外掛程式版本,如下圖所示。cocoapod 故障排查

  2. 若 CocoaPods 外掛程式版本 < 0.9.5,請運行以下指令碼重新安裝外掛程式。

sh <(curl -s http://mpaas-ios.oss-cn-hangzhou.aliyuncs.com/cocoapods/installmPaaSCocoaPodsPlugin.sh)

組件使用升級指南

如果您當前的基準版本 <10.1.60 且整合了 H5 容器和小程式組件,那麼請您詳細閱讀下列說明:

組件 API 變更

mPaaS 組件從 10.1.32 基準開始添加了適配層,如您使用的基準未使用適配層 API,請先行閱讀 mPaaS 10.1.32 適配 iOS 13

建議您在升級 SDK 後使用適配層的 API,具體可參考以下各組件文檔中的舊版本升級注意事項:

說明
  • 強烈建議您修改代碼,使用中介層(適配器)方法而非直接使用底層方法,因為某些底層方法可能會在將來的版本中發生變更或廢棄。如果您繼續使用,在將來的更新中可能需要花費更多的時間進行適配。

定製庫處理

10.1.68 基準版本各組件合入了定製化的需求,但是為了穩妥起見,如果此前您的依賴中包含定製庫且是從低版本 SDK(如 10.1.32)升級至 10.1.68 版本,您的定製庫可能需要基於新版本重新定製,請搜尋群號 41708565 加入DingTalk群進行諮詢。

分享組件

10.1.68 版本分享組件中的第三方 SDK 已升級,包括微信 SDK,微博 SDK,QQ 互聯 SDK。由於微信和 QQ 的分享在最新版本中增加了 Universal Link 的特性,因此請您注意對新版 SDK 進行適配,適配內容包括:

  1. 對應平台的應用配置資訊更新(在第三方開發人員帳號中的應用管理中查看),具體適配方式查看參考連結的內容。

  2. 對於微信分享,mPaaS 分享組件的配置資訊中需要增加欄位 “universalLink”,取值為實際應用的 Universal Link 地址。