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。 - Web、桌面或混合应用:在临时数据库上运行应用自带的服务器,通过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 px 源文件。
- 图标:通常只有带圆角或文字的艺术图;
- 上架文本:
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 px(<= 1 MB);功能图 1024x500,无透明通道;2-8 张手机截图,每边 320-3840 px,长边 <= 短边的 2 倍(使用 1080x1920);可选 7" /10" 平板截图(1200x1920,1600x2560);标题 30 字符,简短描述 80 字符,完整描述 4000 字符。
- App Store:iPhone 6.9" 1320x2868(必填),6.5" 1284x2778;iPad 13" 2064x2752(如果支持 iPad);每种最多 10 张;无透明通道;图标 1024 px,无透明通道;名称 30 字符,副标题 30 字符,宣传文本 170 字符,关键词 100 字符。
- 两个商店都拒绝包含透明通道的截图;合成器输出 RGB PNG。
每个应用都要检查的阻碍项(经验总结)
- 支付: 在应用内通过 Web 支付提供商销售数字解锁或许可证违反 Play 计费 / Apple IAP 规则。对于 iOS,发布时不包含购买界面,或添加 StoreKit。移动构建中不得包含价格或购买链接。
- 账户删除: 任何创建账户的应用都需要在应用内提供删除路径,并且(Play)需要一个公开的 Web 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 必须存在;欧盟/英国贸易商状态需要联系地址和电话。
- 发布签名 已配置;版本号递增;Play 使用 AAB;Apple 团队和束 ID;
ITSAppUsesNonExemptEncryption;隐私清单。 - 新的个人 Play 账户: 在生产发布前需要一个 12 名测试者、14 天的封闭测试。
- 数据安全: 只有那些在内存中使用且从未存储的数据才可声明为“临时处理”(例如发送给 AI 服务的照片);存储在服务器上的电子邮件或 ID 不属于临时处理。广告 ID:仅当没有广告或转化 SDK 且已移除广告 ID 权限时才回答“否”。
- 目标受众 18+,除非应用确实是面向儿童的。
- 最小化缩减器(R8)可能在可选库上失败: 如果发布构建因“缺少类”而失败,请为指定的包添加
-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/- 入门指南、配置参考、工作原理。