關于 mPaaS 10.1.60
10.1.60 基線已正式支持 WKWebView 接口,詳情請參考 10.1.60 適配 WKWebView。由于 App Store 從 2020 年 4 月起不再接受使用 UIWebView 的新 APP,從 2020 年 12 月起不再接受使用 UIWebview 的 APP 的更新,詳情請參見 蘋果官方聲明 。因此,請開發者注意使用 WKWebView 替換 UIWebView。
10.1.60 基線最新版已適配 iOS 13 和 Xcode 11,詳情可參考 mPaaS 10.1.60 適配 iOS 13。
10.1.60 基線新增加了小程序組件。小程序正式版擁有更加完善的 API,且在穩定性、兼容性等方面有了大幅提高。關于小程序升級請參見 小程序升級指南,關于小程序 IDE 新增調試、預覽、發布等功能的詳情請參見 開發小程序。
10.1.60 基線對 H5 容器整體進行大幅優化,提供了更加簡化的接入流程,持續補強能力,在兼容性、穩定性等方面有顯著提高。關于 H5 容器和離線包升級,請參見 H5 容器升級指南。
10.1.60 基線新增加 智能投放 組件。智能投放提供了在應用內個性化投放廣告的能力,支持針對定向人群進行個性化廣告投放,幫助 APP 運營人員精準、及時觸達用戶,詳情請參見 智能投放。
10.1.60 基線的整體組件的兼容性、穩定性都有了大幅提高,功能也有著顯著提升,具體的發布說明請參見 iOS SDK 發布說明。
10.1.60 基線已不支持 iOS 8。
mPaaS 10.1.60 升級指南
使用 mPaaS Xcode Extension 進行升級(推薦)
前提條件
mPaaS Xcode Extension 已更新為 1.1.0 或更高版本。關于更新 mPaaS Xcode Extension 請參見 更新 mPaaS Xcode Extension。
操作步驟
在 Xcode 菜單中,點擊 Editor > mPaaS > 編輯工程,打開 mPaaS Xcode Extension。
如果您已經集成了10.1.60-beta基線版本,請選擇 更新產品集 選項,升級到最新產品集即可。
如果您使用的基線版本非 10.1.60-beta,請選擇 升級基線 選項,選擇升級的基線版本為 10.1.60。升級時間可能比較長,請您耐心等待,不要關閉插件窗口。
更新或升級成功后,插件上即展示工程的 SDK 版本為 10.1.60。
使用 mPaaS 插件接入升級
前提條件
Xcode mPaaS 插件已更新到 5.0.7 或以上的版本。
操作步驟
在當前工程下打開插件面板。
如果您已經集成了10.1.60-beta基線版本,切換至 mPaaS產品集更新 選項,升級到最新產品集即可。
如果您使用的基線版本非 10.1.60-beta,請選擇 mPaaS基線升級 選項,選擇升級的基線版本為 10.1.60。升級時間可能比較長,請您耐心等待,不要關閉插件窗口。
更新或升級成功后,插件上即展示工程的 SDK 版本為 10.1.60。
使用 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.60。
執行
pod mpaas update 10.1.60
,即可安裝 10.1.60 基線的最新 SDK。根據需要執行
pod install
或pod update
即可完成對應工程下 10.1.60 的升級。
后續步驟
如果在 CocoaPods 接入時出現類似如下的錯誤:
Invalid `Podfile` file: [!] No mPaaS_Nebula : 10.1.60-beta 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 升級指南 了解小程序升級的更多信息。
熱修復升級至 10.1.60 后,熱修復庫也必須升級至 10.1.60 版本。由于線上可用的熱修復庫是通過工單或技術支持人員提供,請您 提交工單 申請或聯系 mPaaS 支持人員。
組件 API 變更
mPaaS 組件從 10.1.32 基線開始添加了適配層,如您使用的基線未使用適配層 API,請先行閱讀 mPaaS 10.1.32 適配 iOS 13。
建議您在升級 SDK 后使用適配層的 API,具體可參考以下各組件文檔中的舊版本升級注意事項:
需重點關注項目中 mPaaS 各組件的配置類的 category 和 info.plist 中的配置發生的變化。
強烈建議您修改代碼,使用中間層(適配器)方法而非直接使用底層方法,因為某些底層方法可能會在將來的版本中發生變更或廢棄。如果您繼續使用,在將來的更新中可能需要花費更多的時間進行適配。
iOS 熱修復僅限專有云使用,更多詳情,請咨詢 mPaaS 技術支持。
定制庫處理
10.1.60 基線版本各組件合入了定制化的需求,但是為了穩妥起見,如果此前您的依賴中包含定制庫且是從低版本 SDK(如 10.1.32)升級至 10.1.60 版本,您的定制庫可能需要基于新版本重新定制,請 提交工單 或聯系 mPaaS 支持人員確認。