store-pack 是做什麼的?
在專案根目錄中產生 store/ 資料夾:包含圖示、帶框螢幕截圖、功能圖、商店文案、控制台表單回答以及一份阻礙因素 README。絕不提交、上傳或部署;這些留給使用者自行處理。
需求:Python 3、Flutter SDK(影像合成工具是 Flutter 測試,無需應用程式本體)、以及 macOS(用於影像檢查與圖示尺寸的 sips 指令)。原始螢幕截圖來自應用程式本身。
工作流程
- 檢查應用程式的事實(絕不虛構):套件/綑綁 ID、版本、權限(AndroidManifest, Info.plist)、pubspec、Cargo.toml 或 package.json 中的 SDK(廣告、分析、崩潰回報、計費、登入)、帳號與付款機制、隱私權政策與支援 URL、簽署配置、裝置系列。請閱讀專案自身的貢獻者文件以了解其規則。
- 原始螢幕截圖。 從真實應用程式中捕捉,使用真實但虛構的數據。絕對不要使用生產環境數據或生產環境帳號。
- Flutter:一個 widget 測試框架,使用真實字型(
debugDisableShadows = false,否則陰影會渲染為硬邊緣);手機 440x956 在 3x 解析度 = 1320x2868。 - 網頁、桌面或混合式應用程式:在暫存資料庫上執行應用程式自己的伺服器,透過 API 植入數據,並使用瀏覽器自動化工具驅動。使用獨立的瀏覽器上下文,設定
deviceScaleFactor為 3(手機,視口 440x956)或 2(平板,1032x1376),並在每次截圖前隱藏捲軸:*::-webkit-scrollbar{display:none!important}*{scrollbar-width:none!important}。 - 只終結一個監聽在你自己的暫存連接埠上的程序(
lsof -ti tcp:PORT -sTCP:LISTEN),不要用名稱來終結。 - 目視檢查每張截圖。如果某個寬度下有截圖損壞,就捨棄該截圖並通知使用者。
- Flutter:一個 widget 測試框架,使用真實字型(
store/app.json(參見docs/config-reference.md),然後執行python3 scripts/make_pack.py store/app.json。它會將螢幕截圖裱框在品牌漸層背景上並加上說明文字,建構功能圖與圖示,並執行scripts/check_pack.py。- 圖示:通常只存在帶有內建圓角或文字的圖案;
icon工作會將標記裁剪到平坦的滿版背景上。告知使用者仍然需要向量圖或乾淨的 1024 像素來源。
- 圖示:通常只存在帶有內建圓角或文字的圖案;
- 商店文案:
store/listings.json,然後執行python3 scripts/write_listings.py store/listings.json(fastlane 佈局,強制字數限制)。只描述該建置真的做了什麼,以及該平台建置包含了什麼。 - 文件:
store/README.md(首先列出阻礙因素表格)、google-play/console-forms.md、app-store/connect-forms.md。
商店規格(請在控制台中確認;Apple 的頁面可能無法載入)
- Play:圖示 512 像素(<= 1 MB);功能圖 1024x500,無透明通道;2-8 張手機截圖,每邊 320-3840 像素,長邊 <= 短邊的 2 倍(使用 1080x1920);可選 7"/10" 平板截圖(1200x1920,1600x2560);標題 30 字元、簡短說明 80 字元、完整說明 4000 字元。
- App Store:iPhone 6.9" 1320x2868(必填)、6.5" 1284x2778;iPad 13" 2064x2752(如果支援 iPad);每種最多 10 張;無透明通道;圖示 1024 像素,無透明通道;名稱 30 字元、副標題 30 字元、促銷文字 170 字元、關鍵字 100 字元。
- 兩者都會拒絕帶有透明通道的螢幕截圖;合成工具會寫入 RGB PNG。
每個應用程式中都應檢查的阻礙因素(經驗累積)
- 付款: 在應用程式內部透過網頁付款提供者銷售數位解鎖或授權,會違反 Play Billing / Apple IAP 規定。對於 iOS,上傳時不包含購買 UI,或者加入 StoreKit。行動裝置建置中不得出現價格或購買連結。
- 帳號刪除: 任何會建立帳號的應用程式都需要一個應用程式內的刪除路徑,以及(Play)一個公開的網頁 URL 來說明其流程。
- Apple 登入: 只要 iOS 上提供了 Google 或其他第三方登入,就必須要有 Apple 登入。
- 測試廣告 ID 遺留在正式發行版本中;缺少真實的廣告 ID。
- Play 應用程式簽署: 將 Play 的應用程式簽署 SHA-1 加入 Google OAuth Android 用戶端,否則透過 Play 安裝的應用程式會無法登入。
- 受限制或需宣告的權限:
REQUEST_IGNORE_BATTERY_OPTIMIZATIONS、前台服務類型(需要宣告與影片)、位置(即使使用maxSdkVersion)、藍牙neverForLocation。 - 審查者存取權: 需要伺服器或授權的應用程式需要一個展示伺服器、PIN 碼與操作步驟(Play 應用程式存取權、Apple 準則 2.1)。
- 隱私權政策 URL 必須存在;提供聯絡地址與電話以符合 EU/UK 商家身份。
- 正式發行簽署已配置;版本號碼遞增;Play 使用 AAB;Apple 團隊與綑綁 ID;
ITSAppUsesNonExemptEncryption;隱私權資訊清單。 - 新的個人 Play 帳號: 在正式發佈前,需要一個 12 名測試者、為期 14 天的封閉測試。
- 資料安全: 「僅暫時處理」僅用於在記憶體中處理且從不儲存的資料(例如傳送給 AI 服務的照片);電子郵件或 ID 存放在伺服器上則不屬於暫時處理。廣告 ID:只有在沒有廣告或轉換 SDK 且已移除廣告 ID 權限時,才回答「否」。
- 目標受眾:除非應用程式是真正為兒童設計,否則應設定為 18 歲以上。
- 最小化縮減器 (R8) 可能在選用函式庫上失敗: 如果正式發行建置因「Missing classes」而失敗,請為指定的套件新增
-dontwarn規則。
檔案
scripts/make_pack.py:執行所有工作;scripts/compose/:Flutter 合成工具(STORE_JOBS=jobs.json flutter test);scripts/build_icons.py;scripts/check_pack.py;scripts/write_listings.py。templates/app.example.json、templates/listings.example.json:要複製的配置範本。examples/:一個完整的實際範例,包含一個虛構應用程式及其輸出。docs/:入門指南、配置參考、運作原理。