apple-app-review 是做什麼的?
在審查員打開建置檔之前,先替他們做好功課。一位審查員審查新應用程式大約有 13 分鐘,更新則只有 6 分鐘(Phillip Shoemaker,2009-2016 年負責 App Review 的人)。任何他們在這段時間內找不到或無法操作的項目,都會變成拒絕理由。
Apple 對此欄位的規定(App Store Review Guidelines + App Store Connect Help)
- 備註最多可達 4000 bytes,任何語言皆可。請計算 byte 而非字元數,若超過則修剪。
- 2.3.1(a):「所有新功能、特色及產品變更,都必須在審查備註中具體描述……(籠統的描述將被拒絕)。」
- **提交前:**提供完整存取權限(活躍的示範帳號或功能完整的示範模式),審查期間保持後端服務運作,在備註中說明不明顯的功能和應用程式內購買。
- **2.1(a):**先在裝置上測試,包含示範帳號資訊並開啟後端。
- **2.1(b):**每個應用程式內購買都必須可見且可運作;如果某個應用程式內購買無法找到或審查,請在備註中說明原因。
- 登入欄位只接受一個不得過期的示範帳號。額外帳號請放入備註。
- 透過行動網路進行串流影片:提供測試串流 URL。
選擇模式
- notes(預設):即將提交應用程式或更新。輸出審查備註文字。
- answer-4.3:收到 4.3 / 4.2.6 拒絕,並附有 Apple 的 9 個問題。輸出回覆。不要告訴使用者重新提交。
- packet-2.1:收到「此應用程式由一個 App 審查記錄有限的開發者帳號提交。」輸出 6 項資料包加上錄製鏡頭清單。
- audit:在提交前,依據
GUIDE.md中的拒絕地圖對比程式碼和列表,並針對每項輸出通過/不通過及修復方式。
第一步:收集事實(先讀取程式碼,僅詢問程式碼無法告訴你的事項)
從儲存庫中找出並列出:
- 應用程式的功能、每個主畫面、每個付費或受限制的功能以及如何到達。
- 帳號流程:註冊、登入、帳號刪除(Guideline 5.1.1(v) 要求若存在帳號,則必須在應用程式內提供此功能)。
- 使用者內容:發佈、檢舉和封鎖(Guideline 1.2)。
- 應用程式內購買和訂閱(產品 ID、各解鎖內容)。
- 每個 SDK 和外部服務:驗證、支付、分析、崩潰回報、廣告、AI 提供商(註明模型供應商)、資料 API。檢查 Package.swift、Podfile、package.json、build.gradle、Info.plist、網路呼叫。
- 任何透過伺服器、遠端設定或功能標記開關的項目。直白說明;隱藏的伺服器開關會被視為誘餌和調包(Guideline 2.5.19)。
- 區域差異,或確認沒有差異。
- 此建置檔中的變更(自上次標記或發佈以來的 git log),具體描述。自 2026 年 10 月 16 日起,Apple 拒絕籠統的新功能描述。
僅向使用者詢問:目標使用者、市場缺口及附有日期的競爭對手數量、Beta 測試(建置編號、日期、改變應用程式的回饋)、帳號上的其他應用程式及其差異、發佈此應用程式的公司、應用程式的自有網站(隱私、條款、支援)、示範登入,以及代管的螢幕錄影連結。
第二步:撰寫內容
所有模式的規則:
- 使用簡單句子,用數字代替形容詞,日期使用 YYYY-MM-DD 格式。
- 切勿貼上 App Store 的行銷描述(Apple 問題 1 禁止此行為)。
- 列出開發者帳號上的每個其他應用程式,並用一句話說明其不同之處。
- 列出每個 SDK 和服務。審查員可以看到它們;漏掉一個會讓情況更糟。
- 提供證據:螢幕錄影、範例檔案、示範帳號。
- 不要陳述使用者尚未確認的內容。請留下
[TO CONFIRM: ...]。
notes 範本
功能說明
<2-3 句,說明使用者問題及應用程式如何解決>
目標對象
<已命名的群組>
測試方式
示範登入:<email> / <password>(保持啟用)
1. <到達主要功能的步驟>
2. <到達付費功能的步驟>(沙盒購買可運作 / 促銷代碼:...)
帳號刪除:設定 > <路徑>
檢舉 / 封鎖:<路徑> (或:無使用者內容)
此版本新功能
- <功能>:<位置、作用>
服務
<auth、payments、analytics、AI 提供商 + 用途>,審核後無遠端切換
區域差異:無 / <列表>
此帳號上的其他應用程式
<應用程式>:<一句話說明差異> (或:無)
網站
<網域> - 隱私 <url>、條款 <url>、支援 <應用程式自有網域的 email>
螢幕錄影(從啟動、實體裝置、最新 iOS):<無需登入的連結>
answer-4.3 範本
以一行的開頭表示:你認為此應用程式並非垃圾郵件或範本,並將直接回答每個問題。接著按 Apple 的順序列出九個有標題的答案:
- 功能 2. 目標對象 3. 缺口(附有日期的搜尋、競爭對手數量、評分) 4. Beta 測試(建置、日期、應用的回饋) 5. 獨立或套件 6. 另一個應用程式中的應用程式內購買 7. 與你其他應用程式共用的程式碼 8. 與第三方共用的程式碼 9. 為客戶製作。 最後提供螢幕錄影或範例檔案。在 App Store Connect 中回覆;除非實際上有變更,否則不要重新提交。
如果對問題 5、6 或 7 的誠實答案是「是,有重疊」,請在撰寫前告知使用者:修復方式是產品(將其合併到現有應用程式中作為一項功能,或使其不同),而非措辭。
packet-2.1 範本
Apple 要求的六項資料:螢幕錄影、目的和目標對象、設定 + 憑證 + 範例檔案、每個外部服務、區域差異、受監管行業文件。將相同的文字貼到 Resolution Center 回覆和備註欄位中。然後:保持提交不變,最多在兩週後查詢一次狀態,並在該應用程式獲得批准前暫停其他應用程式的提交。
錄製鏡頭清單:從實體裝置的主畫面開始,最新 iOS,啟動、註冊、登入、主要功能、使用者內容 + 檢舉 / 封鎖、購買 + 解鎖的內容、刪除帳號。
範例
請參閱 examples/backed-update.md 來查看一個簡短的實際備註,該備註讓一個更新在 1 分鐘內獲得批准。
第三步:提交前檢查
完整檢查清單和拒絕地圖:GUIDE.md。
輸出通過/不通過清單:應用程式的自有網站(在 App Store Connect 和應用程式內連結隱私/條款/支援)、該網域的支援電子郵件、今日測試的示範登入、帳號刪除、檢舉/封鎖、每個列出的 SDK、不需登入即可開啟的錄影連結、帳號上不超過數個相似的應用程式、新帳號一次只審查一個應用程式。