mPaaS 10.1.68 發布說明
從 10.1.68 基準開始正式廢棄 UIWebView,只支援 WKWebView,詳情可參考 mPaaS 適配 WKWebView。App Store 從 2020 年 4 月起不再接受使用 UIWebView 的新 APP,從 2020 年 12 月起不再接受使用 UIWebview 的 APP 的更新。請您儘快升級到 10.1.68 基準,適配 WKWebView。
支援 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 接入。
操作步驟
在 Podfile 中,將 SDK 版本設定改為 10.1.68。
執行
pod mpaas update 10.1.68
,即可安裝 10.1.68 基準的最新 SDK。根據需要執行
pod install
或pod update
即可完成對應工程下 10.1.68 的升級。
後續步驟
如果在 CocoaPods 接入時出現類似如下的錯誤:
Invalid `Podfile` file: [!] No mPaaS_Nebula : 10.1.68 found !!! Check name & version in Podfile.
可嘗試按照以下步驟解決:
運行
gem list | grep 'mPaaS'
命令檢查 CocoaPods 外掛程式版本,如下圖所示。若 CocoaPods 外掛程式版本 < 0.9.5,請運行以下指令碼重新安裝外掛程式。
sh <(curl -s http://mpaas-ios.oss-cn-hangzhou.aliyuncs.com/cocoapods/installmPaaSCocoaPodsPlugin.sh)
組件使用升級指南
如果您當前的基準版本 <10.1.60 且整合了 H5 容器和小程式組件,那麼請您詳細閱讀下列說明:
請閱讀 H5 容器 10.1.60 升級指南 瞭解 H5 容器和離線包升級的更多資訊。
請閱讀 小程式 10.1.60 升級指南 瞭解小程式升級的更多資訊。
組件 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 進行適配,適配內容包括:
對應平台的應用配置資訊更新(在第三方開發人員帳號中的應用管理中查看),具體適配方式查看參考連結的內容。
對於微信分享,mPaaS 分享組件的配置資訊中需要增加欄位 “universalLink”,取值為實際應用的 Universal Link 地址。