> For the complete documentation index, see [llms.txt](https://developers-apps-in-toss.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers-apps-in-toss.toss.im/guide/zh/operation/deploy.md).
# 发布迷你应用
### 1. 事前检查
#### 1-1）游戏、非游戏发布指南
发布前请务必确认审核指南和检查清单。 [游戏](https://developers-apps-in-toss.toss.im/checklist/app-game)·[非游戏](https://developers-apps-in-toss.toss.im/checklist/app-nongame) 请确认所有发布指南，检查开发是否已完成。若不遵守指南，可能会在审核阶段被退回。
#### 1-2）上传应用包时的注意事项
应用包解压后大小仅可上传 100MB 以下。若包含图片、声音、视频等所有资源，可能会超出容量，因此请将资源文件与构建分开管理。
建议这样管理资源。
* 请仅将应用运行所必需的最少资源包含在包中。
* 请将大容量资源配置为从外部存储或 CDN 下载。
* 若对额外资源应用分阶段下载方式（Lazy Loading），用户体验会更好。
***
### 2. 请求审核
测试完成后，点击控制台中的“请求审核”按钮即可开始审核。审核最长需要 3 个工作日，且根据应用类别，可能会超过 7 天。
* 必须至少完成 1 次测试，请求审核按钮才会激活。
* 审核请求一次只能提交一个版本。
请求审核后如果发现需要修复的 bug，请点击“取消请求”按钮取消审核。然后上传修复后的新包（`.ait`）并重新请求审核即可。
#### 审核被退回时
点击“查看退回原因”按钮确认原因后，请上传已解决问题的新包，并重新请求审核。若对退回原因还有疑问 [Channel Talk](https://apps-in-toss.channel.io/workflows/787658)可通过此处咨询。
***
### 3. 发布
包审核通过后，我们会通过电子邮件告知审核结果。之后在控制台点击“发布”按钮，迷你应用就会向用户公开。
发布后会立即对所有用户生效。请务必充分测试后再发布。
{% hint style="info" %}
**测试环境与实际环境的差异**
测试环境与实际线上环境的 CORS 策略和网络行为可能不同。尤其以下功能，请务必在实际环境中再次确认。
* 内存·资源使用量
* 网络请求（CORS）：需要将以下域名注册到 Origin 允许列表中。\n会根据 SDK 版本而不同。
SDK 3.x
* 实际服务环境： `https://.web.tossmini.com`
* QR 测试环境： `https://.private-web.tossmini.com`
\
SDK 1.x \~ 2.x
* 实际服务环境： `https://.apps.tossmini.com`
* QR 测试环境： `https://.private-apps.tossmini.com`
* 权限处理
* 登录·会话保持
* 实际支付·认证功能
即使在测试环境中正常，实际环境中也可能出错。
{% endhint %}
***
### 4. 发布后管理
发布后，可在 앱인토스 控制台进行版本管理和更新。根据需要，可以上传新包，或者保留和管理现有版本。
#### 4-1. 发布新版本（更新）
* 如果添加了新功能或修复了错误，请以与之前相同的方式上传新的应用包（`.ait`）请上传。
* 上传的包将再次经过 请求审核 → 审批 → 发布 流程。
* 通过审核后，点击“发布”按钮，新版本将替换现有应用。
已发布的版本会立即对用户生效，请先充分测试后再上传。
#### 4-2. 回滚
* 在“应用发布”菜单中可以查看已发布版本列表。
* 如有问题，可以回滚到之前的版本。
* 请选择要回滚的版本后，点击“发布”按钮。
回滚也会立即对用户生效，请慎重选择版本。
#### 4-3. 紧急修复（Hotfix）
如果应用运行出现严重错误 [Channel Talk](https://apps-in-toss.channel.io/workflows/787658)请立即通过……联系我们。紧急情况下我们会快速响应。
#### 4-4. 发布后监控
发布后不久，可能会出现意料之外的错误或性能问题。建议重点监控以下项目。
* 主要错误日志和崩溃日志
* 通过 Sentry 设置进行 Sentry 监控
* API 响应延迟·失败率
* 用户反馈和可用性问题
* 可以通过导航栏中的“举报”功能接收用户意见。
* 收到的反馈可在控制台的“举报记录”菜单中查看。
* 外部资源·CDN 加载延迟或失败问题
#### 4-5. 事后审核
为向用户提供高水平的迷你应用体验，앱인토스 在发布后也会继续进行迷你应用审核。若在事后审核中发现需要改进的地方，可能会请求您进行改进。若发现违反法律·政策的事项，可能会根据运营政策先采取紧急停运措施。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://developers-apps-in-toss.toss.im/guide/zh/operation/deploy.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.