全部產品
Search
文件中心

Mobile Platform as a Service:mPaaS 10.2.3 適配 Xcode15

更新時間:Jul 13, 2024

背景

蘋果要求自 2024 年 4 月 29 日起,所有提交至 App Store 的 App 都必須使用 Xcode 15 或更高版本構建,詳情請參考 蘋果官方聲明,並且 Xcode 15 不再支援構建 iOS 12 之前的系統,詳情可參考 Xcode 15 發布說明

蘋果宣布自 2024 年 5 月 1 日起,App 代碼中如使用到蘋果官方所列的 API 列表 中的 API,需要在 App 的隱私清單列表中聲明相關原因,如使用到蘋果官方所列的 三方 SDK 列表 中的 SDK,三方 SDK 需要提供相應隱私清單配置,才能將全新 App 或新版本 App 上傳到 App Store Connect,詳情請參考 蘋果官方聲明

現狀

目前 mPaaS 已在 10.2.3.40 及以上的基準版本中完成對 Xcode 15 版本下的適配和測試工作,使用 10.1.68 基準(已廢棄)或更早的基準請升級到 10.2.3 最新版本,且不再支援 iOS 12 之前的系統。

升級基準

根據您當前的基準版本,選擇對應的升級方式。

當前基準為 10.2.3 主基準

請先參考 mPaaS 10.2.3 的使用以及適配 iOS 17 升級到 10.2.3 最新基準並進行相關適配。

當前基準為定製基準

如果您使用的是定製基準,請搜尋群號 41708565 加入DingTalk群或提交工單諮詢對應的售後及技術支援人員,是否可切換到 10.2.3 基準。

升級方式

基於 CocoaPods 升級

按照以下步驟,即可安裝 10.2.3 版本的最新 SDK:

  1. 首先確保 Podfile 中 mPaaS 組件的版本號碼為 10.2.3

  2. 執行 pod mpaas update 10.2.3

    如果提示命令報錯,需通過 pod mpaas update --all 命令先更新外掛程式,再重新執行。

  3. 執行 pod install

升級注意事項

通過 Extension 外掛程式 升級到 10.2.3.30 及以上的基準版本時,如添加了威脅感知、國密等模組,如下圖所示:

image.png

在主工程中需要手動在 Building Setting 中的 Other link flag 裡添加系統庫 resolv。

image.png

否則會出現如下報錯:

image.png

API 變更

本次 Xcode15 適配暫無介面使用的變化。

適配 Xcode 15 更新的庫清單

  • 移動網關

  • 移動調度

  • 資料同步

  • 訊息推送

  • 國密

  • 多媒體

  • 小程式

  • 離線包

  • 安全鍵盤

  • 部分內部相依元件

測實驗證範圍

由於蘋果工具鏈的升級為黑盒操作,經常會帶來穩定性等問題,在完成 App 對 Xcode 15 的適配後,建議對 App 進行全面迴歸測試。

且由於 Xcode 15 打包的安裝包在 iOS 17 及之後的 URL 解析從 RFC1738/1808 更新為 RFC 3986 可能會導致 URL 相關解析異常,如使用到 URLWithString和InitWithString 等 API,請進行相關驗證和適配,詳情請參考 蘋果官方說明