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

iOS 10 適配完全指南:從 ATS、隱私權限到 Xcode 8 的實戰踩坑

編輯:iOS 開發綜合

從 iOS 9 到 iOS 10,蘋果在網路安全、隱私邊界與 API 風格上接連收緊。以下依主題整理升級時最常撞到的問題與解法。

1. ATS 的限制升級

iOS 9 起,非 HTTPS 的網路請求預設被攔下,雖然可以把 NSAllowsArbitraryLoads 設為 YES 來關閉 ATS,但蘋果宣布自 2017 年 1 月 1 日起不再允許用這個方式繞過,等於強制要求 HTTPS,否則提審時可能被拒。可行的折衷做法是透過 NSExceptionDomains 針對特定網域放行 HTTP,實務上通常也能順利通過審核。

具體設定步驟:

1)在專案的 info.plist 中新增一個 Key:App Transport Security Settings,型別為 Dictionary。

2)在其下加入 NSExceptionDomains,型別同為 Dictionary。

3)把需要放行的網域作為 Key 加入,型別仍為 Dictionary。

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

小提醒:如果 App 裡有用到網路圖片,也要確認那些圖片網址是不是 HTTP,若是,同樣要把圖片的網域加進例外清單。

2. iOS 10 的隱私權限描述

iOS 10 對隱私權限的檢查更嚴格,缺少對應說明時 App 會直接崩潰。解法幾乎都是同一招:在 info.plist 補上對應的 Key-Value。

圖中紅線標出的文字會直接顯示給使用者看,屬於必填。

3. UIStatusBar 相關 API 被標記為過期

專案裡若用到 UIStatusBar 的舊屬性,在 iOS 10 中已被宣告 deprecated,需要改用 preferredStatusBarStyle 這類由系統回呼的方式:

// iOS 10
- (UIStatusBarStyle)preferredStatusBarStyle {
    return UIStatusBarStyleDefault;
}

4. Xcode 8 控制台一堆無關輸出的解法

新建的空專案什麼都還沒做,控制台就噴出一大堆雜訊,這應該是 Xcode 8 的行為所致。解法是在 scheme 的 Run 設定中加上環境變數 OS_ACTIVITY_MODE = disable。

第一步:

第二步:

第三步:新增參數,Name 為 OS_ACTIVITY_MODE,Value 為 disable。

5. 通知體系的重寫

通知自被引入以來蘋果就不斷小修小補,直到 iOS 10 才真正大改重構,也讓開發者感受到 UserNotifications 框架的易用與強大。

iOS 9 之前的痛點:

1. 通知相關方法命名相似、容易混淆,寫錯方法的情況不少。

2. App 在前景與背景執行時,擷取通知的程式路徑不一致。

3. App 位於前景時無法直接顯示遠端通知,還得多做一層處理。

4. 已送出的通知無法更新,內容送出後不可變更,且僅支援純文字呈現,擴充性有限。

iOS 10 帶來的改變:

1. 所有通知相關 API 統一收攏到 UserNotifications.framework。

2. 新增撤銷、更新能力,通知送出後仍可修改內容。

3. 通知不再只是文字,可加入圖片、影片,並自訂呈現樣式。

4. 整體更易於管理,效能也經過大幅優化。

5. 權限申請流程簡化,本地與遠端通知的請求合併在同一個方法中。

若專案有用到遠端推送,需相應調整:

6. UICollectionView 的效能優化

UICollectionView 在專案中的使用比例越來越高,但卡頓與載入慢的問題一直存在,因此 iOS 10 針對它做了新一輪優化,重點包括:

· cell 預加載(pre-fetching)機制
· UICollectionView 與 UITableView 新增 prefetchDataSource API
· 對 self-sizing cells 的改善
· 互動式排序(interactive reordering)

問題根源在於舊有的重用機制:iOS 10 之前,當 cell 準備進入螢幕時整批 cell 都已完成載入並在螢幕外待命,等於一次就備好一整列,快速滑動時掉幀就很明顯。要讓使用者感受不到卡頓,App 必須維持 60 fps,也就是每 16 毫秒完成一次刷新。

iOS 10 之前的 cell 生命週期:

1. 使用者滑動螢幕,螢幕外有一個 cell 準備載入,從 reuse 佇列取出並呼叫 prepareForReuse,在其中重置狀態、載入新資料;
2. 繼續滑動時呼叫 cellForItemAtIndexPath,為 cell 賦值模型後回傳系統;
3. 當 cell 即將進入螢幕,呼叫 willDisplayCell,做最後的準備;
4. willDisplayCell 執行完畢後 cell 進入螢幕,完全離開後呼叫 didEndDisplayingCell。

iOS 10 的 cell 生命週期:

1. 從 reuse 佇列取出 cell 後,prepareForReuse 的呼叫時機提前到 cell 還在螢幕外時;
2. cellForItemAtIndexPath 中的建立、填充、刷新同樣提前;
3. 直到 cell 真的需要顯示時才呼叫 willDisplayCell,原則是「何時需要顯示,何時才呼叫」;
4. cell 完全離開螢幕後呼叫 didEndDisplayingCell,與先前相同。

差別在於:舊版 cell 一旦離開螢幕就只能回到重用佇列,下次出現還得重跑一遍生命週期;iOS 10 會把 cell 在記憶體中多留一段時間,滑出去再滑回來時只需呼叫 willDisplayCell 即可重新出現。此外 iOS 10 改為逐個載入 cell,而非舊有的整列載入,效能提升明顯。

新增的 Pre-Fetching 預加載

目的是降低 cell 載入所花的時間。除了資料來源與代理協議,iOS 10 另外新增了 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);

prefetchItemsAtIndexPaths 用於非同步預取資料,傳入的 indexPaths 是有序的,代表 item 接收資料的順序;cancelPrefetchingForItemsAtIndexPaths 為可選方法,可在滑動過程中取消或降低預取優先級。要注意這個協議不能取代原本讀取資料的方法,僅是輔助。此機制同樣適用於 UITableViewCell。

7. UIColor 的新方法與廣色域

官方說明大意如下:系統中多數繪圖框架(Core Graphics、Core Image、Metal、AVFoundation)都大幅改善了對延伸範圍像素格式與廣色域色彩空間的支援。UIKit 也統一採用新的 extended sRGB 色彩空間,讓 sRGB 色彩與其他更廣色域的色彩混用時不再需要付出明顯效能代價。實務上的建議重點是:iOS 10 的 UIColor 使用 extended sRGB,初始化時不再把元件值夾在 0.0 到 1.0 之間;若你的 App 依賴 UIKit 幫忙做夾值,就必須自行調整行為。自行繪製或處理影像時,也建議明確指定色彩空間與像素格式。

過去我們大多用 RGB 設定顏色, iOS 10 官方建議改用 sRGB,效能更好、色彩更豐富。若你替 UIColor 寫過分類,可以考慮替換,類別中新增了兩個 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. 字體隨系統字級自動更新

系統字級改變後,App 內的 label 也能跟著變化。以往得自己寫不少程式監聽並重設字體,iOS 10 提供了 adjustsFontForContentSizeCategory 屬性直接搞定。

UILabel *myLabel = [UILabel new];
/* preferredFontForTextStyle: 指定一種樣式,並讓字體大小符合使用者設定的字級 */
myLabel.font = [UIFont preferredFontForTextStyle: UIFontTextStyleHeadline];
/* 決定對應元素是否要在 UIContentSizeCategory 改變時自動更新字體。
   此屬性要生效,該元素字體必須來自 +preferredFontForTextStyle: 或
   +preferredFontForTextStyle:compatibleWithTraitCollection:,且傳入有效的 UIFontTextStyle。 */
myLabel.adjustsFontForContentSizeCategory = YES;

9. UITextContentType

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

iOS 10 為 UITextField 加入了 textContentType 列舉,用來標示輸入區域期望的語義。有了這個資訊,系統可以在某些情況下自動選擇合適的鍵盤配置,並改善自動校正與和其他 App 的整合體驗。例如把輸入框標為郵件地址類型,系統就知道使用者要填的是信箱。

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

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

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

因此建議使用前兩種;而 floatValue 這種寫法本身也不可靠,歷史上曾出現 8.3 系統回傳 8.2 的情況,所以最穩妥的是直接取用 [[UIDevice currentDevice] systemVersion] 字串做比較。

Swift 則可直接用版本判斷語法:

if #available(iOS 10.0, *) {
    print("iOS 10.0")
} else {
    // 相容舊版本
}

11. UIScrollView 內建 refreshControl

iOS 10 之後,只要繼承 UIScrollView 就能直接使用下拉刷新:

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

12. Xcode 8 外掛失效

升級 Xcode 8 之後,依賴第三方外掛的開發者普遍遇到外掛不能用。網路上確實有讓 Xcode 8 繼續載入外掛的做法,但這類手段通常伴隨簽章與安全疑慮,提審時也有被拒的風險,因此不建議使用。實務上 Xcode 本身提供的註解與程式碼片段功能已相當夠用。

13. 部分文字顯示不全

用 Xcode 8 與 Xcode 7.3 分別測試同一段程式碼:

Xcode 8:

Xcode 7:

建立一個 Label 並讓它自適應大小,字級同樣是 17,最後算出的寬度卻不同。對比下面的數據就能理解,為什麼升級到 iOS 10 後 App 裡部分文字會顯示不全:

進一步測試可以確認,英文字母沒有這個問題,只有中文字會。目前只能逐個調整受影響的元件,還沒有更漂亮的解法。

14. awakeFromNib 未呼叫 super 的警告

Xcode 8 之前直接寫 - (void)awakeFromNib {} 沒什麼問題,但 Xcode 8 會出現警告:

官方說明:你必須呼叫 awakeFromNib 的父類別實作,讓父類別有機會執行它們所需的額外初始化工作。
雖然該方法的預設實作什麼都不做,但許多 UIKit 類別提供了非空的實作。
你可以在自己 awakeFromNib 的任何位置呼叫 super 的實作。

15. 使用遠端通知需開啟 Remote Notifications

You've implemented -[application:didReceiveRemoteNotification:fetchCompletionHandler:],
but you still need to add "remote-notification" to the list of your supported
UIBackgroundModes in your Info.plist.

解法是在 Xcode 的 Capabilities 中開啟 Remote notifications 背景模式:

16. 「One of the two will be used. Which one is undefined.」日誌

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.

原因是 objc runtime 對 App 內所有影像共用同一個命名空間(flat namespace),運作機制如下:二進位映像被載入時會檢查依賴關係;每個映像載入的同時,其中的 objc class 會註冊進 runtime 命名空間;若同名類別被再次載入,runtime 的行為是無法預期的,其中一種可能結果就是任載入其中一份實作,也就是預設行為。

17. 16-bit 或 P3 資產導致的上架錯誤

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

在 Xcode 8 中,只要資源裡含有 16 位元圖,或圖片的顯示模式(gamma)為 P3,而 deployment target 又設在 iOS 9.3 以下,就會遇到這個錯誤。若 App 需要支援廣色域顯示,就必須把 target 提到 iOS 9.3 以上;反之若不打算支援廣色域又要相容舊系統,就得把所有 16 位元或 P3 圖片換成 8 位元 sRGB。

可以透過 assetutil 從 iTunes Connect 的錯誤訊息中找出有問題的資源,離線排查步驟如下:

1. 導出專案的 ipa 檔。
2. 將副檔名由 .ipa 改為 .zip。
3. 解壓縮,可以找到裝著 app bundle 的 Payload 目錄。
4. 開啟終端機並切換到 .app bundle 目錄:cd path/to/Payload/your.app
5. 用 find 定位 Assets.car:find . -name 'Assets.car'
6. 對每個 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. 「This version does not support documents saved in the Xcode 8 format」

專案預設用 Xcode 8 開啟,改用 Xcode 7 打開 Xib 時就會報錯:

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

結果所有被 Xcode 8 存過的 Xib 都打不開,只能用編輯器把 Xib 裡的這一段刪掉才能開啟:

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

以上內容持續補充中。

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