用 SwiftUI 實現(xiàn)一個開源的 App Store
App Store 在 iOS 11 之前，App 排行榜一直是衡量開發(fā)者 App 活躍度的指標(biāo)，但在 iOS 11 后蘋果弱化了榜單功能，改為了二級入口，導(dǎo)致查詢榜單困難，編者通過深入調(diào)研最終實現(xiàn)了一個查看 App 榜單、搜索、信息、發(fā)布生效等強(qiáng)大功能的開源 App。
一、前言
App Store 一直以來都是 iPhone 生態(tài)的最重要一環(huán)，在初代 iPhone 商店，因為 App 比較少，當(dāng)時就有 Top 25 榜單：
然后在后續(xù)的 App Store 迭代中，排行榜(Top Charts)一直是一個主要的入口，新用戶基本都會從榜單下載 App，所以，榜單的重要性不容忽視。
直到 2017 年，雖然占了不到 30% 的手機(jī)份額，但 iPhone 的體量已經(jīng)非常大，App Store 應(yīng)用數(shù)量已經(jīng)達(dá)到 220 萬。App Store 的展示和推薦，顯然滿足不了每天巨大的新 App，有越來越多的 App 希望得到關(guān)注;而另一方面，排行榜刷榜問題一直存在;還有就是 App Store 的設(shè)計已經(jīng)滿足不了需求!比如更新(Updates) 標(biāo)簽功能單一，就是負(fù)責(zé)顯示需要更新的 App 列表。
所以，從 iOS 11 開始，蘋果將 AppStore 重新設(shè)計，增加了 Today 和 Games 游戲標(biāo)簽入口，而排行榜列表放到了 Apps 標(biāo)簽的二級入口中。蘋果加強(qiáng)了自己的編輯團(tuán)隊推薦的App，在游戲和應(yīng)用標(biāo)簽分類的前面也加入了大區(qū)域的編輯推薦 App，如今已經(jīng)看不到榜單了。
而現(xiàn)在 iOS 15 中的 App Store 增加了更多的功能，比如產(chǎn)品頁優(yōu)化、自定產(chǎn)品頁、App 內(nèi)活動(In-App Events)等，目的很明顯就是讓開發(fā)者增加活躍內(nèi)容，提升 App 日活和收入。
而排行榜功能，其實已經(jīng)不單單是一個榜單的作用，經(jīng)常這些年的沉淀，榜單基本已經(jīng)穩(wěn)定。比如大家看到的 App，常年不變，而沖到榜單的 App，會獲得更多的下載量。對于開發(fā)者來說，榜單可以用來預(yù)測應(yīng)用收入、使用量和下載量的一個重要指標(biāo)。對于用戶來說，發(fā)現(xiàn)一些有趣或者熱門的 App，依然是部分老用戶的習(xí)慣。
所以，編者希望通過實現(xiàn)一個 App Store 排行榜，方便日常查看，同時查看信息，搜索或應(yīng)用發(fā)布狀態(tài)訂閱等功能，解決了非常多的痛點問題。
二、效果展示
首先，我們先來介紹一下，目前 iAppStore 實現(xiàn)了那些功能。
iAppStroe[1] 是一款使用 SwiftUI 打造的蘋果商店工具類 App。
提供蘋果實時榜單查詢，包含 iOS 和 iPad 的熱門免費榜、熱門付費榜、暢銷榜，還有新上架榜、新上架免費榜、新上架付費榜等。
提供查詢 app 詳細(xì)頁面內(nèi)容、搜索 app、訂閱 app 狀態(tài)等功能。
支持蘋果所有國家和地區(qū)的商店，無需切換 Apple Id，即可查看!
2.1 排行榜
首先，App Store 的榜單有很多，包含 iOS 和 iPad 的熱門免費榜、熱門付費榜、暢銷榜，還有新上架榜、新上架免費榜、新上架付費榜等，我們都實現(xiàn)了這些榜單。另外，我們將 App Store 榜單的 UI 還原，同時，也增加了更多的信息展示，比如 App 所屬分類等。
最重要的是，我們把所有國家和地區(qū)的商店，都集成在一個面板中，通過下拉列表選擇，實現(xiàn)快速切換榜單。
2.2 App 詳細(xì)頁
App 詳細(xì)頁面，把開發(fā)者最關(guān)心的參數(shù)顯示在最前面。另外，復(fù)制包含或者 App ID 是一個高頻的需求，App 描述和更新方案也高仿了 App Store 的效果。預(yù)覽區(qū)包含 iPhone 和 iPad 圖片。點擊可以顯示大圖，并且可以下載和分享大圖。
2.3 搜索
搜索區(qū)，可以輸入關(guān)鍵字模糊搜索，或者 App ID 精準(zhǔn)搜索。另外，在右上角切換國家和地區(qū)，顯示不同地區(qū)的 App 搜索。
2.4 應(yīng)用狀態(tài)訂閱
這個狀態(tài)訂閱是什么意思?就是可以監(jiān)聽 App 在商店的狀態(tài)，舉例來說，App 發(fā)布了新版本，那么大概要多久才能在商店上顯示呢?所以，我們可以通過蘋果的接口，來定時的查詢 App 的狀態(tài)，從而知道 App 什么時候生效。還有新 App 剛剛發(fā)布時、或者 App 需要下架了，什么時候才從商店消失等。
2.5 其它
為了方便開發(fā)者使用，App 列表長按時，會彈出操作列表，可以已經(jīng)復(fù)制 App 的信息或者快速打開 App Store 產(chǎn)品頁，盡可能的快捷獲取內(nèi)容!另外，還支持暗黑模式，依然精美絕倫!切換圖標(biāo)可以選擇自己顯示的圖標(biāo)等。
大家想要什么功能，可以在評論區(qū)留言啊~
三、調(diào)研工作
接下來，我們說一下要實現(xiàn)以上功能，需要的 API 怎么調(diào)研出來的!通過大量的網(wǎng)頁檢索，最終測試后整理成有價值的列表：
3.1 榜單接口
查詢排行榜的 API 示例
以上內(nèi)容在蘋果公開的文檔，都沒有查詢到 API 文檔。但為蘋果網(wǎng)站到在一個頁面： Apple Services Performance Partners[6]，其中一項服務(wù)叫：Enterprise Partner Feed Relational[7](企業(yè)信息流合作伙伴?)，目前這個合作好像很難申請到。所以，相關(guān)的文檔鏈接都無法訪問到，比如 affiliate.itunes.apple.com[8]。
那么以上鏈接中幾個參數(shù)類型，因為沒有文檔，所以調(diào)研梳理如下：
榜單類型
應(yīng)用分類
更多分類，參考蘋果網(wǎng)站的 HTML 標(biāo)簽：App Store[9]
國家或地區(qū)標(biāo)識
更多分類標(biāo)識，參考蘋果網(wǎng)站的 HTML 標(biāo)簽：RSS Builder[10]
接口說明
原本接口提供 200 條數(shù)據(jù)查詢，但 20221 年 9 月 2 日，蘋果接口調(diào)整后，大幅削減 App Store 應(yīng)用排行數(shù)據(jù)分享，從 1500 名降至 200 名。目前 AppStore 總榜、應(yīng)用、游戲榜、分類榜只能查看前 200 個 App 的數(shù)據(jù)。
3.2 搜索接口
App 搜索接口比如簡單，并且有官方文檔：
- iTunes Store API[11]
- iTunes Search API: Constructing Searches[12]
接口示例：
https://itunes.apple.com/search?term=斗羅大陸&country=cn&limit=200&entity=software
term 字段就是關(guān)鍵詞，country 字段是國家或地區(qū)的標(biāo)簽，跟上面的榜單接口是同一個。entity=software 固定為搜索軟件就好。詳細(xì)的使用，可以參考官方文檔，這里就不展開了。
3.3 App 詳細(xì)信息
查詢某個 App 可以使用 lookup 接口，具體可以查看官網(wǎng)文檔：Lookup Examples[13]。
接口示例：
https://itunes.apple.com/cn/lookup?id=1558453472
3.4 App 評論內(nèi)容
查詢某個 App 的用戶評論內(nèi)容，沒有在蘋果的文檔中找到，但是根據(jù)以上的調(diào)研，接口使用問題不大。
接口示例：
https://itunes.apple.com/cn/rss/customerreviews/id=989673964/sortBy=mostRecent/json
地區(qū)、App Id、sortBy 字段，就可以搜索。如果需要分頁或者獲取更多，可以參考文末的鏈接。
四、開發(fā)思路
有了以上的 API 接口，就能實現(xiàn)我們的 App，這樣使用 SwiftUI 來構(gòu)建，現(xiàn)已開源：
- iAppStore - GitHub[14]
詳細(xì)的實踐過程就不在這樣講解了，因為 App 是工具類應(yīng)用，交互的內(nèi)容不多，所以并不是很復(fù)雜。當(dāng)然，使用 SwiftUI 構(gòu)建 UI 過程異常的快速，但是如果要調(diào)整 UI 細(xì)節(jié)，確定需要花很多心思。比如，SwiftUI 還不支持 WebView，所以用 SFSafariViewController 橋接的 View 在 SwiftUI 組件中顯示會異常。
- How do I use SFSafariViewController with SwiftUI? - Stack Overflow[15]
另外，就是蘋果 API 的坑，接口返回的字段 im:id、im:bundleId，包含冒號，讓人懷疑人生!最后，通過自定義鍵值名，解決了解析映射的問題。詳細(xì)，可以參考源代碼中 AppRank.swift[16] 類。
- struct IDAttributes: Codable {
- let imBundleID, imID: String
- // 自定義鍵值名
- enum CodingKeys: String, CodingKey {
- case imID = "im:id"
- case imBundleID = "im:bundleId"
- }
- }
綜上，如果是個人開發(fā)的 App，可以開始使用 SwiftUI 來開發(fā)，畢竟原生的體驗和原生的組件，用戶起來也很快樂。另外，不考慮支持低版本系統(tǒng)，使用 SF Symbols[17] 提供的圖標(biāo)，也非常的友好!
五、總結(jié)
iAppStore 從構(gòu)思到實現(xiàn)，花了半個月的時間，期間調(diào)研接口和調(diào)試接口花了很多時間，網(wǎng)上依然看到很多人問這些接口，相信很多開發(fā)者都不知道有這些接口，所以本文也算是一個答案總結(jié)，希望這個問題從此消失哈~ 最后，iAppStore 只是從編者需求來實現(xiàn)的一個產(chǎn)品，所以一定存在很多的問題，但同時它是一個開源項目，所以，如果大家有興趣，一起來參與，增加更多有趣或者黑科技的體驗吧!歡迎大家有任何想法或者建議，可以在評論區(qū)給我們反饋。也可以到 iAppStore - GitHub[18] 給我們 Star 鼓勵!感謝大家~
參考資料
[1] iAppStroe:
https://github.com/37iOS/iAppStore-SwiftUI
[2] RSS Builder: https://rss.applemarketingtools.com
[3] RSS Information:
https://www.apple.com/rss/
[4] Stack Overflow:
https://stackoverflow.com/questions/29997991/how-to-get-top-400-lists-from-itunes
[5] 鏈接:
https://www.kalman03.com/2015/05/04/tech/appstore_affiliates_resource/
[6] Apple Services Performance Partners:
https://affiliate.itunes.apple.com/resources/
[7] Enterprise Partner Feed Relational:
https://affiliate.itunes.apple.com/resources/documentation/itunes-enterprise-partner-feed/
[8] affiliate.itunes.apple.com:
https://affiliate.itunes.apple.com/resources/documentation/itunes-store-web-service-search-api.html
[9] App Store:
https://apps.apple.com/cn/genre/ios/id36
[10] RSS Builder:
https://rss.applemarketingtools.com/
[11] iTunes Store API:
https://affiliate.itunes.apple.com/resources/documentation/itunes-store-web-service-search-api/
[12] iTunes Search API:
Constructing Searches: https://developer.apple.com/library/archive/documentation/AudioVideo/Conceptual/iTuneSearchAPI/Searching.html#//apple_ref/doc/uid/TP40017632-CH5-SW1
[13] Lookup Examples:
https://developer.apple.com/library/archive/documentation/AudioVideo/Conceptual/iTuneSearchAPI/LookupExamples.html#//apple_ref/doc/uid/TP40017632-CH7-SW1
[14] iAppStore - GitHub:
https://github.com/37iOS/iAppStore-SwiftUI
[15] How do I use SFSafariViewController with SwiftUI? - Stack Overflow:
https://stackoverflow.com/questions/56518029/how-do-i-use-sfsafariviewcontroller-with-swiftui
[16] AppRank.swift:
https://github.com/37iOS/iAppStore-SwiftUI/blob/main/iAppStore/Models/AppRank.swift
[17] SF Symbols:
https://developer.apple.com/sf-symbols/
[18] iAppStore - GitHub:
https://github.com/37iOS/iAppStore-SwiftUI
