中文文档

建立第一个发布工作区。

本指南按照 Beralo 的真实流水线,从应用身份一直讲到商店交付。需要所有技术细节时,可切换到内容更完整的 English documentation →

最快路径

快速开始

  1. 新建项目:填写名称、iOS Bundle ID、可选的 Android Package,并选择本地文件夹。
  2. 设置语言与截图:保留 en-US,再加一种语言,定义 3–5 个能讲清产品价值的界面。
  3. 加入原始截图:通过 Auto Capture 自动运行应用,或用 Manual Import 导入已有图片。
  4. 撰写与设计:添加每种语言的标题、副标题,选择背景与设备框并实时调整。
  5. 渲染:选择目标尺寸,运行 Render,并根据 Diagnostics 修复缺图或文字溢出。
  6. 验证发布:配置至少一个商店连接器,保持 Dry Run 开启,然后运行预检。
安全默认值

Dry Run 默认开启,只验证发布计划,不会修改线上商店。

模块 1

基础

Basics 管理应用名称、Apple Bundle ID、Android Package 和商店连接状态。Locales 管理项目语言,并把项目语言代码映射到 Apple/Google 的商店语言。Shots 定义每张截图的稳定 key、显示名称、iOS/Android 深链、等待时间与是否跳过。

Beralo Studio 基础模块
应用身份、语言和截图结构是后续所有阶段的共同基础。

模块 2

采集与导入

每个 Capture Set 对应一个模拟器/模拟设备、商店目标尺寸和方向。Auto Capture 会切换语言、打开每张截图的深链、等待并保存原始图。若应用缓存语言或演示数据,可开启逐语言清除数据。

Manual Import 支持单图、多图和语言文件夹。home.png01_home.png1.png 等文件名都可自动匹配 Shot。

App Store 版本限制

沙盒版无法执行 Auto Capture,但 Manual Import 始终可用。需要自动控制模拟器时请使用直接下载的 DMG 版本。

Beralo Studio 自动采集界面
Capture Set 将已安装的应用与商店输出尺寸连接起来。

模块 3

创意

Text 以“语言 × 截图”矩阵管理标题和副标题,支持单格编辑、结构化批量粘贴、翻译提示词与从源语言填充空值。

Preview 可直接拖动截图、文字和装饰组件,并通过 Tuning 调整背景、设备框、字体、换行、描边、圆角、缩放、旋转和 3D 倾斜。先选择 Scope:改动可以作用于全部内容、当前语言、某一截图,或当前语言与截图的组合。

Beralo Studio 创意预览与调节面板
预览是最终渲染结果的依据。

Render 可按目标尺寸生成完整的语言与截图矩阵,支持暂停、继续和重新开始。Diagnostics 会在导出前显示缺失原图与文字溢出。

模块 4

商店

Listing Metadata 分别管理 Apple 的名称、副标题、URL、描述、关键词、版本说明与推广文字,以及 Google 的标题、短描述、完整描述与版本说明。字符计数器使用对应商店的真实限制。

Monetization 可同步并本地化 Apple 订阅、Google 订阅和一次性商品。Google 订阅还支持最多四条本地化权益。

Beralo Studio 订阅与内购本地化界面
主商店详情和付费商品使用一致的语言工作流。

模块 5 · 正式发布需要 Pro

发布

  1. 选择范围:Apple/Google、截图/详情文案/付费商品文案,以及截图尺寸。
  2. 运行预检:解决凭据、渲染文件、字段限制、语言映射和 Google 图片桶冲突。
  3. 先做 Dry Run:验证同一份计划,但不改线上商店。
  4. 检查变更:在支持的范围内对比本地与线上字段。
  5. 正式发布:查看 Apple/Google 批次进度,遇到商店 API 问题时复制完整日志。

Google 截图批次带有 Checkpoint,中断后可继续,不必重新提交已经成功的批次。Chromebook 截图会在本地渲染,但目前需要手动上传到 Play Console。

Beralo Studio 发布计划与预检界面
每次发布都以清晰可见的计划为准。

常见修复

常见问题

切换语言后应用仍显示旧语言

改用 System override,开启逐语言清除数据,并检查应用是否恢复了自己保存的语言设置。

截图黑屏或动画未完成

增加该 Shot 的等待时间,确认深链能打开目标状态,并确保演示数据已准备好。

翻译后文字被裁切

打开 Render → Diagnostics,然后只对该语言调整换行、文字框尺寸或字号,不要为了一个长翻译缩小所有语言。

语言无法发布

回到 Foundation → Locales 检查 Apple 与 Google 映射;先 Auto map,再手动解决没有精确匹配的地区变体。