您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 10 適配全景整理:從通知、ATS 到 Xcode 8 的 18 個升級痛點

編輯:iOS 開發綜合

2016 年 9 月蘋果發布 iOS 10,那是一次破壞性升級。對開發者而言,從通知體系重構、ATS 收緊,到 Xcode 8 的一堆怪問題,幾乎每個專案都要改一輪。以下按類別整理當時最常遇到的適配重點,其中部分結論至今仍具參考價值,部分則已被後續版本取代,閱讀時可留意每小節的時間前提。

1. 通知體系全面重構

通知從被引入 iOS 開始就不斷演進,但歷次更新多屬小幅調整,直到 iOS 10 才真正大改,把相關 API 統一到 UserNotifications.framework。

iOS 9 之前的痛點:API 命名冗長易混淆,容易呼叫錯方法;App 在前景與背景時的通知處理路徑不一致;前景時無法直接顯示遠端通知,需要額外繞路;已送出的通知無法更新或撤銷;內容只能是簡單文字,擴展性很差。

iOS 10 的改善:通知相關 API 全部收攏到新框架;支援撤銷、更新與中途修改內容;通知可以帶圖片、影片與自訂 UI;權限申請把本地與遠端通知整合在同一個方法中;整體更易於管理。

若專案有用到推送,註冊方式需要相應調整。

2. ATS 收緊

iOS 9 預設禁止非 HTTPS 連線,當時可以透過 NSAllowsArbitraryLoads = YES 全域關閉 ATS。但蘋果宣布從 2017 年 1 月 1 日起不再允許這個做法,等於強制要求 HTTPS,否則提交時可能被拒。

解法是用 NSExceptionDomains 針對特定域名放行 HTTP,這樣較容易通過審核。設定步驟:

1)在 Info.plist 中加入 App Transport Security Settings,型別為 Dictionary;

2)加入子項 Exception Domains,型別同為 Dictionary;

3)把需要放行的域名作為 Key 加入,型別 Dictionary;

4)每個域名下設定三個屬性:NSIncludesSubdomains、NSExceptionRequiresForwardSecrecy、NSExceptionAllowsInsecureHTTPLoads。

細節提醒:iOS 9 之後載入網路圖片時,也要確認圖片域名是否為 HTTP,如果是,同樣要加進例外清單,否則圖片會全部載入失敗。

3. 隱私權限必須明確聲明

iOS 10 對隱私權限更嚴格,未設定對應 key 就直接崩潰。解法仍是在 Info.plist 補上對應的 Key-Value。

圖中 Value 的部分是顯示給使用者看的說明文字,必須填寫且不可為空。

4. Xcode 8 大量無用 log

新建的工程什麼都沒做,控制台卻刷出一堆無關訊息。解法是設定環境變數 OS_ACTIVITY_MODE = disable:

第一步:

第二步:

第三步,在 scheme 的 Environment Variables 中新增:

Name:OS_ACTIVITY_MODE,Value:disable

5. UIStatusBar 相關 API 被標記為廢棄

直接存取 statusBarStyle 等屬性的寫法在 iOS 9 之後已被標記廢棄,改用 preferredStatusBarStyle:

- (UIStatusBarStyle)preferredStatusBarStyle {
    return UIStatusBarStyleDefault;
}

6. UICollectionView 效能優化

iOS 10 針對 UICollectionView 做了明顯改進,重點包含:

  • cell 的 pre-fetching 預加載機制
  • 新增的 UICollectionViewDataSourcePrefetching 協議
  • self-sizing cell 的改善
  • 互動式排序(Interactive reordering)

為什麼 iOS 10 之前大量 cell 快速滑動時會明顯卡頓?關鍵在於舊版的加載時機:整行 cell 都要在進入螢幕前完成配置,一幀內的工作量太大,也就是所謂的掉幀。要讓滑順感成立,App 必須維持 60fps,換算下來每幀只有約 16 毫秒。

iOS 10 之前 cell 的生命週期:

1. 螢幕外準備進場的 cell 從重用佇列取出,呼叫 prepareForReuse 重置狀態;

2. 呼叫 cellForItemAtIndexPath 賦值模型並回傳;

3. 即將進入螢幕時呼叫 willDisplayCell,做最後調整;

4. cell 完全離開螢幕後呼叫 didEndDisplayingCell。

iOS 10 的調整在於把前兩步提前:cell 還在螢幕外時就開始準備與配置,willDisplayCell 則嚴格等到真正要顯示的那一刻才呼叫;此外改為「逐個 cell」載入而非「整行」載入,大幅降低單幀壓力。

另一個重要變化是系統會把離開螢幕的 cell 多保留一段時間,使用者滑回來時不必重跑整輪生命週期,直接呼叫 willDisplayCell 就能重新出現。

Pre-Fetching 預加載

新協議 UICollectionViewDataSourcePrefetching 定義了兩個方法:

- (void)collectionView:(UICollectionView *)collectionView prefetchItemsAtIndexPaths:(NSArray<NSIndexPath *> *)indexPaths NS_AVAILABLE_IOS(10_0);

- (void)collectionView:(UICollectionView *)collectionView cancelPrefetchingForItemsAtIndexPaths:(NSArray<NSIndexPath *> *)indexPaths NS_AVAILABLE_IOS(10_0);

第一個方法用於非同步預取資料,傳入的 indexPaths 是有序的,代表 cell 即將需要資料的先後順序;第二個是選用方法,可在使用者反向滑動時取消或降低預取優先級。

要注意的是,這個協議並不能取代原本的資料來源方法,它只是輔助提前載入。UITableView 同樣支援這套機制。

7. UIColor 新增廣色域支援

iOS 10 在整條圖形鏈(Core Graphics、Core Image、Metal、AVFoundation)上大幅改善對 extended-range 像素格式與廣色域的支援,UIKit 也統一到新的 extended sRGB 色彩空間。

官方給出的幾點建議:

  • iOS 10 起 UIColor 使用 extended sRGB,初始化時不再把元件值夾在 0.0 到 1.0 之間。若你的程式依賴 UIKit 自動夾值,需要自行調整。
  • 在 iPad Pro(9.7 吋)上做自繪時,底層繪圖環境使用 extended sRGB。
  • 自訂圖片輸出時,可用新的 UIGraphicsImageRenderer 控制目標位圖是否使用 extended-range 格式。
  • 若在廣色域裝置上用 Core Graphics 或 Metal 自行處理圖片,應使用 extended range 色彩空間與支援 16-bit 浮點的像素格式,並在必要時明確夾值。
  • Core Graphics、Core Image 與 Metal Performance Shaders 都提供了色彩空間轉換的新選項。

因此蘋果建議改用 sRGB 相關的新 API:

+ (UIColor *)colorWithDisplayP3Red:(CGFloat)displayP3Red green:(CGFloat)green blue:(CGFloat)blue alpha:(CGFloat)alpha NS_AVAILABLE_IOS(10_0);

- (UIColor *)initWithDisplayP3Red:(CGFloat)displayP3Red green:(CGFloat)green blue:(CGFloat)blue alpha:(CGFloat)alpha NS_AVAILABLE_IOS(10_0);

8. UITextContentType 語意化輸入

// 提供鍵盤關於文字語意意圖的額外資訊
@property(nonatomic, copy) UITextContentType textContentType NS_AVAILABLE_IOS(10_0); // 預設 nil

設定這個屬性後,系統能依語意自動選擇合適的鍵盤配置,並改善自動校正與與其他 App 的資料整合體驗。例如帳號欄設為 UITextContentTypeUsername、信箱欄設為 UITextContentTypeEmailAddress,使用者體驗會明顯更好。

9. 字體隨系統動態字型調整

以前要讓 App 的字體跟著系統設定縮放,需要自己監聽並手動處理。iOS 10 提供了 adjustsFontForContentSizeCategory:

UILabel *myLabel = [UILabel new];
// 指定樣式,字體大小自動符合使用者設定
myLabel.font = [UIFont preferredFontForTextStyle:UIFontTextStyleHeadline];
// 系統 Dynamic Type 變更時自動更新字體
myLabel.adjustsFontForContentSizeCategory = YES;

注意:這個屬性要生效,字體必須來自 preferredFontForTextStyle:,否則不會有任何效果。

10. UIScrollView 內建 refreshControl

iOS 10 之後,只要繼承自 UIScrollView 的元件都直接支援下拉刷新:

@property (nonatomic, strong, nullable) UIRefreshControl *refreshControl NS_AVAILABLE_IOS(10_0) __TVOS_PROHIBITED;

11. 判斷系統版本的正確方式

常見的三種寫法,結果並不一致:

// 得到 1
[[[[UIDevice currentDevice] systemVersion] substringToIndex:1] integerValue]
// 得到 10.000000
[[UIDevice currentDevice] systemVersion].floatValue
// 得到 "10.0"
[[UIDevice currentDevice] systemVersion]

用 substring 截第一位在版本號進到兩位數時必然出錯;floatValue 也存在精度問題(例如 8.3 曾被解析為 8.2)。建議使用 NSProcessInfo 的 isOperatingSystemAtLeastVersion:,或直接用 @available 做編譯期判斷。

Swift 的寫法:

if #available(iOS 10.0, *) {
    print("iOS 10.0")
}

12. Xcode 8 外掛失效

升級 Xcode 8 之後,過去依賴的第三方外掛全部失效。網路上雖有繞過簽章驗證的方法,但使用未簽章的外掛存在安全風險,提交審核也可能被拒。與其冒險,不如改用 Xcode 內建的 snippets、behaviours 或自建指令稿來達成同樣的效率。

13. 部分文字顯示不全

實測以 Xcode 8 與 Xcode 7.3 分別建立一個自適應大小的 Label,字體同為 17pt,輸出的寬度並不相同。

Xcode 8

Xcode 7

這就是升級後某些中文顯示不全的原因。測試下來英文不受影響,只有漢字會被截斷。當時只能靠逐個調整控制 awhile件來規避。這類問題在新版 Xcode 中已修正,遇到時可先確認工具鏈版本。

14. awakeFromNib 必須呼叫 super

Xcode 8 開始,awakeFromNib 中若未呼叫父類實作會出現警告。官方說明是:雖然 NSObject 的預設實作不做任何事,但許多 UIKit 類別提供了非空的實作,因此必須給父類執行額外初始化的機會。呼叫位置可在自己方法的任何時機。

15. 遠端通知需要開啟 Background Mode

若已實作 application:didReceiveRemoteNotification:fetchCompletionHandler:,卻仍收到警告,原因是缺少 remote-notification 的 background mode 宣告。

解法是在 Xcode 的 Capabilities 中開啟 Remote notifications:

16. 「One of the two will be used」警告

模擬器中常見這段輸出:

objc[5114]: Class PLBuildVersion is implemented in both .../AssetsLibraryServices.framework/AssetsLibraryServices
and .../PhotoLibraryServices.framework/PhotoLibraryServices. One of the two will be used. Which one is undefined.

原因是 Objective-C runtime 對同一個 App 使用共享的 flat namespace,載入機制如下:

1. 二進位映像被載入,檢查相依關係;

2. 每個映像載入時,其中的 Objective-C 類別會註冊到 runtime 命名空間;

3. 若同名類別被再次註冊,runtime 的行為是未定義的,可能載入其中任意一個。

這個警告多來自系統私有框架,通常不影響功能,但值得知道它的含義。

17. Assets.car 不能包含 16-bit 或 P3 資產

在 Xcode 8 中,若資源目錄含有 16 位元圖,或圖片的顯示模式為 P3 廣色域,同時 deployment target 設為 iOS 9.3 以下,就會出現:

Invalid Bundle - The asset catalog at 'Payload/XXXXX/Assets.car' can't contain 16-bit or P3 assets if the app supports iOS 9.3 or earlier

解法取決於需求:若要支援廣色域顯示,把 target 提高到 iOS 9.3 以上;若必須相容舊版本,則要把所有 16 位元或 P3 圖片轉為 8 位元 sRGB。

離線排查步驟:

1. 導出專案的 ipa;

2. 把副檔名改為 .zip;

3. 解壓,進入含 App bundle 的 Payload 目錄;

4. 切換到 .app 目錄:

cd path/to/Payload/your.app

5. 定位 Assets.car:

find . -name 'Assets.car'

6. 用 assetutil 檢查每個 Assets.car:

sudo xcrun --sdk iphoneos assetutil --info /path/to/a/Assets.car > /tmp/Assets.json

7. 打開 /tmp/Assets.json,搜尋 "DisplayGamut": "P3",該段 JSON 的 Name 欄位即為問題檔案。

8. 把該圖檔改為 8 位元 sRGB,重新編譯上傳。

18. Xcode 8 格式的 Xib 無法被舊版開啟

用 Xcode 8 開啟並儲存過的 Xib,回到 Xcode 7 會報錯:

This version does not support documents saved in the Xcode 8 format. Open this document with Xcode 8.0 or later

當時的權宜辦法是直接用編輯器刪除 Xib 開頭的這段宣告:

<capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>

更根本的解法還是在團隊中統一 Xcode 版本,否則 Xib 的雙向相容問題會反覆出現。

回顧與建議

回頭看這份清單,真正需要改動業務程式碼的其實只有前幾項:通知 API 遷移、ATS 設定、隱私權限補齊、狀態列樣式改寫。其餘多為 Xcode 工具鏈的問題,或只需調整設定的項目。

如果今天要從舊版本升上來,建議的順序是:先升 Xcode 並修完編譯錯誤,再補 Info.plist 的權限與 ATS 設定,然後處理被標記廢棄的 API,最後才做效能優化。把破壞性變更與效能改進分開處理,出問題時才容易定位。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved