
作者:劉小壯
前陣子剛進新公司,忙著開發新版本,有段時間沒寫文章了。最近正好用到 Newsstand 相關技術,這方面的參考資料不多且水準參差不齊,於是把我做專案時用到的技術與流程整理在這裡,希望大家指正其中的問題,若也能幫到你那就最好。
從 iOS 5 開始,蘋果推出了一類「輕應用」——Newsstand,主要承載報刊雜誌。系統內建的 Newsstand 就像一個書報攤,各家雜誌以封面形式陳列其中。
iBook 和 Newsstand 外觀相似,但本質不同:Newsstand 是我們自己製作的可互動應用,互動方式與內容下載都由我們決定;iBook 則是純文字閱讀器,交互與下載規則由它自己掌控,性質上更接近一個圖書商城。
Newsstand 基本上就是把原本放在桌面的應用圖示收進報刊資料夾,並以雜誌封面呈現,內部程式碼的實作差異其實不大。
注意:iOS 9 之後蘋果取消了獨立的 Newsstand 桌面應用,改以一個一般的資料夾來收納這類 App。
開發雜誌應用,首先要設定 UINewsstandApp 與圖示相關欄位。Info.plist 必須包含「Application presents content in Newsstand」(即 UINewsstandApp)並設為 YES;實際操作時直接輸入 UINewsstandApp,系統會自動補上完整 key 名。

兩者其實是同一件事。
接著要設定應用圖示,原始 key 為 UINewsstandIcon,在 Xcode 介面中顯示為 Icon files (iOS 5)。

圖示的詳細規格可參考官方文件:https://developer.apple.com/library/ios/qa/qa1686/_index.html
這個框架相對年輕,提供的 API 不多,複雜細節都已封裝在內部。要注意它只能用在 Newsstand 類型的應用,其他 App 無法使用。

框架中主要有三個類:
下載時只需呼叫 downloadWithDelegate: 設定代理,再透過 NSURLConnectionDownloadDelegate 的方法即可取得進度、支援斷點續傳、並在下載完成後拿到二進位檔路徑。內容格式可以是 HTML、JS、圖片等,也可以把整期打包成 ZIP,再由 App 依與後端約定好的規則解析。

代理方法回調

當然你也可以不用這個類,改用其他下載方式;但代價是無法在背景下載,而且 issue 得自己管理。
下載完成之後
一期內容下載完通常是一個壓縮包,我們需要解壓後放到另一個目錄。實務建議:每個 issue 都做成一個壓縮包,下載完再解壓,管理起來最省事。檔案操作一般用 NSFileManager,解壓則可搭配成熟的三方庫。
實測結果:App 退到背景後,系統會繼續幫我們下載,且程式會持續在背景運行;而因為 NewsstandKit 是系統層級的框架,即使 App 被終止,下載也不會中斷。
也就是說,一旦下載任務啟動,無論 App 在前景、背景還是被終止,下載都會繼續。所以盡量不要使用其他下載方式。
但要注意:App 被推出後,雖然下載持續,app delegate 已不存在,只剩系統層級的任務在跑。因此若想在下載完成後做一些處理,就需要在背景狀態下重新拉起 App,此時會執行 application:didFinishLaunchingWithOptions:,把我們的邏輯寫在該方法裡即可。
想實作背景下載,最好直接使用 NewsstandKit:它屬於系統層級框架,背景下載的時機由系統決定,框架本身已經把相關邏輯實作好了,而且 UIBackgroundModes 裡正好有一種模式叫 Newsstand。
專案中主要用 NKAssetDownload 下載,並遵循 NSURLConnectionDownloadDelegate 以取得進度、完成狀態與斷點續傳能力。
注意:正式上線後,背景下載每 24 小時只會被觸發一次,額外觸發都會被忽略;測試階段可用下面的方式爭取更多機會,但上線後切勿保留。另外背景下載是系統層級行為,系統只會在 Wi-Fi 環境下執行。
[[NSUserDefaults standardUserDefaults] setBool:YES
forKey:@"NKDontThrottleNewsstandContentNotifications"]首先要註冊 UIRemoteNotificationTypeNewsstandContentAvailability 類型的遠程通知。每次有新刊上線,由伺服器推送通知,通知中可帶封面圖網址;下載圖片後用 [[UIApplication sharedApplication] setNewsstandIconImage:] 更新封面。
相關邏輯可寫在 didFinishLaunchingWithOptions 與 didReceiveRemoteNotification 中。這樣一來,伺服器推下來的通知就能直接驅動 NewsstandKit 在背景下載,完成後再更新雜誌封面。
推送格式與一般遠程通知相同,差別在於必須多帶一個 key 為 content-available、值為 1 的欄位:

就是多了這一個欄位。