发布应用
发布前，建议先使用实时预览检查页面、数据、用户状态和交互。实时预览不需要打包；开始发布后，系统才会编译客户端并生成预发布版本。
发布前检查
开始发布前，确认以下内容已经完成：
- 页面、组件和前端行为在目标客户端环境下正常运行。
- 页面入参、路径参数和查询参数传递正确。
- 登录状态、用户角色和数据权限符合预期。
- 数据库结构、行为流、第三方 API 和 AI 智能体已经完成配置。
- 行为流入参或出参发生变化时，调用方已同步更新。
- 成功时、失败时和空数据等分支均已测试。
部署方式
单客户端项目
单客户端项目提供两种部署方式：
| 部署方式 | 发布内容 | 适用场景 |
|---|---|---|
| 同步变更 | 只发布后端，包括数据库结构、权限、行为流、第三方 API 和 AI 智能体等配置 | 只修改了后端，不需要更新前端页面 |
| 发布 | 同时发布前端与后端 | 修改了页面、组件、前端行为或前后端绑定 |
同步变更完成后，后端修改会立即影响使用该后端的线上应用。执行发布时，系统先生成预发布版本供测试；确认无误后，再将客户端发布到生产环境。
多客户端项目
多客户端项目采用前后端分离发布：
- 在后端编辑器中点击发布，只发布后端变更。
- 在客户端编辑器中点击发布，只编译并发布当前客户端。
后端由所有客户端共享，因此后端发布后可能同时影响多个线上客户端。详细说明参阅搭建多客户端应用。
发布 Web 应用
生成预发布版本
打开发布面板并开始发布。系统会编译当前 Web 客户端，生成测试链接和访问二维码。
验证预发布版本
使用测试链接检查页面、响应式布局、登录、权限、数据请求和交互流程。涉及前后端变更时，应重点检查页面绑定与行为流出参是否一致。
发布到生产环境
确认预发布版本无误后，点击去发布。发布完成后，通过正式地址再次检查首页、登录和主要业务流程。
如需使用自己的域名，参阅使用自定义域名。需要设置搜索引擎收录信息时，参阅Web 应用 SEO。
发布微信小程序
微信小程序支持第三方授权发布和私钥自主发布。第三方授权发布由 Zion 协助上传和提交审核；私钥自主发布将代码上传至微信后台，由你在微信公众平台完成提审和发布。
第三方授权发布
准备微信小程序
- 前往微信公众平台 注册“小程序”类型的账号。
- 完善小程序名称、类目、图标等基本信息。
- 按微信要求完成小程序备案。
- 如果应用需要微信支付，确认小程序主体满足微信支付的开通要求。
备案要求参阅微信小程序备案操作指引 。
授权小程序
- 打开 Zion 的发布面板并选择微信小程序。
- 点击小程序授权。
- 使用对应小程序的管理员微信扫码并确认授权。
授权失败时，检查扫码账号是否为该小程序的管理员，以及小程序是否仍授权给其他第三方平台。
如需更换 AppID，先在发布面板中解绑当前小程序，再重新授权。
生成预发布版本并真机测试
开始发布后，系统会编译小程序并生成真机预览二维码。使用微信扫码，检查页面、登录、授权、支付以及其他小程序专属能力。
如果扫码后仍显示旧页面，可从微信最近使用的小程序列表中删除该小程序，再重新扫码以清理本地缓存。
提交审核并发布
- 在发布面板中提交微信审核。
- 填写版本号、管理员微信、审核所需页面和测试说明。
- 根据界面要求上传真机截图。
- 审核通过后，在发布面板中发布审核版本。
审核要求以微信公众平台的当前规则为准。提交失败时，根据微信返回的类目、资质、内容或技术错误修改后重新提交。
更新已发布应用
根据变更范围选择部署方式：
| 变更内容 | 部署方式 |
|---|---|
| 只修改数据库结构、权限、行为流、第三方 API 或 AI 智能体 | 同步变更 |
| 修改页面、组件、前端行为或前端绑定 | 发布 |
| 同时修改行为流入参或出参与调用它的前端 | 更新调用方后发布 |
多客户端项目需要从后端编辑器发布后端，并从各客户端编辑器分别发布受到影响的客户端。
常见发布问题
发布失败时，先根据错误发生的阶段检查：
- 后端发布失败：检查数据库结构、权限、行为流、第三方 API 和 AI 智能体配置。
- 客户端构建失败：检查编辑器中的校验错误、页面引用和前端绑定。
- 预发布版本异常：对比实时预览的初始化数据、用户状态和客户端环境。
- 生产环境异常：确认发布是否完成，并检查网络请求和运行日志。