iOS 10 問世後,我們優先開發加入了新版的推播通知功能。本文分享整個功能開發過程中遇到的各類問題與解法。
Xcode 8 改動很大,直接打開舊工程編譯運行時,會發現拿不到 Push token,從 didFailToRegisterForRemoteNotificationsWithError 印出的錯誤可以看到:
fail to register with error Error Domain=NSCocoaErrorDomain Code=3000 "no valid 'aps-environment' entitlement string found for application" UserInfo={NSLocalizedDescription=no valid 'aps-environment' entitlement string found for application}查詢後得知這是 Xcode 8 的變化:entitlements 改由主 Target 的 Capabilities 管理,而 Push Notification 預設是關閉的,必須手動開啟。

工程新增了 Notification Content 與 Notification Service 兩個 Extension,Signing 預設為自動模式。

據說 Xcode 8 的簽名管理比 Xcode 7 更智慧,於是筆者試了一下。選好 Team 後它自動產生了授權檔,但同時也幫我多生了一張新憑證,等於多加了一位開發人員,結果就是原本的憑證不在舊授權檔裡,導致原先手動配置的授權檔必須重新產生。

若想繼續沿用原本的手動配置,除了要取消 Automatically manage signing,還得到 Key Chains 把新產生的憑證刪掉,再回到網站重新產生授權檔。使用 Automatically manage signing 時,建議每個 Target 都採用相同方式。
如果你建立 Target 時選了 Swift,預設會使用 Swift 3.0。Xcode 8 同時支援 3.0 與 2.3,若你還沒熟悉 3.0 的 API 變化、想繼續用 2.3,只要在對應 Target 的 Build Setting 中把 Use Legacy Swift Language Version 設為 YES 即可。
工程配置完成後,先寫個 Hello World 跑跑看,結果 Command+R 之後編譯報錯:
Check dependencies No architectures to compile for (ONLY_ACTIVE_ARCH=YES, active arch=x86_64, VALID_ARCHS=i386).
原因是 VALID_ARCHS 中缺少對應的 active arch。此時需在對應 Target 的 Build Setting 的 Valid Architectures 中補上 arm64。

接著開始寫程式,大部分參考喵神的〈活久見的重構 - iOS 10 UserNotifications 框架解析和 Demo〉以及 WWDC 708 Advanced Notifications。在 Service 中,我們會把後端推過來的數據裡的圖片下載到本機,再作為 attachments。
以往我們的推播只顯示一句 alert,但推播 JSON 中的 alert 可以是字串,也可以是字典;若是字典,除了 body,在 iOS 8.2 之後還能加入 title、subtitle 等。為了讓推播更豐富,我們想把原本的 body 改成 title,再把文章摘要放進 body。但若直接改動 aps 內的 alert,8.2 以前的裝置就會顯示文章摘要。後來我們想到:Notification Service 不是能修改推播內容嗎?於是保持 aps 的 alert 不變,在 JSON 裡新增 title 與 body,Service 收到通知後再把這兩個欄位取出賦值給 bestAttemptContent。
{
"aps":{
"alert":"test test",
"mutable-content":1
},
"title": "new title",
"body": "new body"
}
若通知帶有 attachments,預設長按通知會顯示圖片或影片,但我們覺得顯示一大張圖不美觀,而且想要加上 action button,也就是下圖的效果,因此用到了 Notification Content。

其實這裡並沒有自訂通知 UI,而是直接把該 View 隱藏起來。Info.plist 中的 UNNotificationExtensionInitialContentSizeRatio 代表 View 初始的 height/width,把它設為 0.001(不能設為 0),再在 viewDidLoad 中設定 self.preferredContentSize = CGSizeZero; 就能隱藏 View。

這個 Extension 能回應多個 category,每個 category 都能註冊自己的 action buttons,因此 action buttons 與自訂 UI View 是相互獨立的,但可以透過 action buttons 來更新自訂 UI View。Action buttons 預設會開啟 App 並交由 delegate 處理;使用 Notification Content 後,我們可以直接在 Extension 內處理回應而不必開啟 App,也能選擇 forward 開啟 App 交給 delegate。
程式寫得差不多就開始除錯。Extension 除錯時偶爾會遇到 Could not attach to process ID 的錯誤。

有時重啟 Xcode 能解決,有時不行。這時有個小技巧:在這個視窗彈出後先點 OK,接著點 Debug > Attach to Process > 你的 Extension,就能成功攔截中斷點了。
測試無誤、準備提交 TestFlight 時,校驗卻出錯了。

錯誤訊息很明顯:Extension.appex 裡包含了 Frameworks 資料夾。若 Extension 使用了 Cocoapods,它就會產生這個資料夾,但實際上沒什麼用。解法是在 Build Phases 最後新增一個 Build Phase,執行一段 shell 腳本把 Frameworks 資料夾刪掉。
cd "${CONFIGURATION_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/"
if [[ -d "Frameworks" ]]; then
rm -fr Frameworks
fi
文章轉自 zhao0的簡書