> 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/release-note/changelog-zh/release-note.md).

# 发布说明

{% updates format="full" %}
{% update date="2026-08-18" tags="3.0.4,sdk" %}

## 提升 web 框架的稳定性和开发体验

本次版本中，我们更稳定地调整了迷你应用的基础行为，并改善了 CLI 和 Devtools 的开发体验。

* `webView.pullToRefreshEnabled`的默认值改为 `false`。这是为了防止滚动时出现意外刷新，如有需要， `apps-in-toss.config.ts` 中的 `defineConfig`请直接设置为 `true`。
* 全面改进了 ait --help。以实际的 bin 名称 ait 为基准整理了示例，并增强了韩语/英语输出、颜色检测、ait --version 和主要命令说明。
* 构建时 `appName`, `brand`, `webBundle` 的配置进行验证。 `brand.primaryColor` 也追加了默认值。
* 改善了 AIT Devtools 的 mock 自定义选项和测试还原度。

  可以直接在打包器配置中构成 mock 初始状态，也可以添加和编辑 IAP 商品目录。订阅商品 mock、熄屏防止、配件按钮事件也能更接近实际运行进行测试。
  {% endupdate %}

{% update date="2026-08-04" tags="3.0.2,sdk" %}

## 提供新的测试环境

新增了可在本地浏览器中直接测试迷你应用的 AIT Devtools 包。

如果是新脚手架项目，或从 2.x 版本迁移到 3.x 版本，会自动设置。

详细内容请参考 [SDK 3.x 迁移文档](/documentation/integration/sdk-3.x.md)。
{% endupdate %}

{% update date="2026-08-03" tags="3.0.1,sdk" %}

## WebView 项目结构得到了改进

参数和返回值与现有 SDK 2.x 相同，因此无需额外修改代码即可应用。

* 配置文件结构变更：配置文件名称和部分属性已更改。
* 基于服务器处理：将 SDK 内部处理逻辑改为在服务器端而非客户端处理。
* 稳定应对问题：即使发生 SDK 问题，也可以在 앱인토스 服务器上修复并反映，无需合作方重新发布。

这是为了提高迷你应用生态的稳定性，并将 SDK 保持在稳定版本的更新。

详细内容请参考 [SDK 3.x 迁移文档](/documentation/integration/sdk-3.x.md)。

{% endupdate %}

{% update date="2026-07-28" tags="2.10.8,sdk" %}

## React Native 迷你应用的横幅图片规格已修改

现在横幅图片会以与 WebView 迷你应用相同的规格展示。
{% endupdate %}

{% update date="2026-07-21" tags="2.10.7,sdk" %}

## 修复了在 iOS 中访问迷你应用时出现白屏的问题

有部分重度使用 Toss App 的用户在 iOS 环境下访问基于 WebView 的迷你应用时，会偶尔出现白屏。\
更新到最新版本后，该现象会消失。
{% endupdate %}

{% update date="2026-07-13" tags="2.10.6,sdk" %}

## 修复了 WebView 闪烁问题

已解决在使用底部弹窗时，WebView 偶尔闪烁的现象。
{% endupdate %}

{% update date="2026-07-10" tags="2.10.5,sdk" %}

## 修复了导航栏透明模式下底部触控问题

导航栏选项中的 `transparent` 在值为 true 时，修复了屏幕底部无法触控的问题。\
现在即使在透明模式下，也可以正常触摸屏幕底部。
{% endupdate %}

{% update date="2026-07-16" tags="api" %}

## 在促销、智能发送、Toss Pay API 中支持用户识别键（hash）认证

此前只能使用通过 Toss 登录获取的 userKey 来识别用户。\
现在也可以用通过用户识别键发放功能获得的 hash 值调用以下 API。<br>

* **促销** : [通过服务器发放促销积分](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EB%B9%84%EA%B2%8C%EC%9E%84/promotion.html#%EC%84%9C%EB%B2%84%EB%A5%BC-%ED%86%B5%ED%95%B4-%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98-%ED%8F%AC%EC%9D%B8%ED%8A%B8-%EC%A7%80%EA%B8%89%ED%95%98%EA%B8%B0)
* **智能发送** : [开发智能发送](https://developers-apps-in-toss.toss.im/smart-message/develop.html)
* **Toss Pay 一次性支付** : [开发 Toss Pay 一次性支付](https://developers-apps-in-toss.toss.im/tosspay/develop.html)
* **Toss Pay 定期支付** : [开发 Toss Pay 定期支付](https://developers-apps-in-toss.toss.im/tosspay/auto-pay.html)

还提供可验证用户识别键是否有效的验证 API。
{% endupdate %}

{% update date="2026-07-01" tags="2.10.4,sdk" %}

## 可在导航栏中隐藏图标和应用名称

`navigationBar`中 `withTitle` 选项已新增。\
`withTitle`将 `false`设置为后，导航栏中的图标和应用名称会一起隐藏。\
\
详细内容请参考 [导航栏](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/UI/NavigationBar.html) 文档。
{% endupdate %}

{% update date="2026-06-19" tags="api" %}

## 推出了 Toss Pay 定期支付（自动扣款）功能

用户首次注册一次支付方式后，之后无需额外认证即可周期性自动扣款。\
通过获取 billing key，仅调用 API 就能进行重复扣款，可用于订阅服务、定期配送、会员制等多种循环计费模式。
{% endupdate %}

{% update date="2026-06-19" tags="2.9.2,sdk" %}

## 在游戏应用中按下 X 按钮时会弹出退出确认模态框

在游戏应用中按下导航栏的 X 按钮时，会显示退出确认模态框。\
非游戏应用则会直接退出，不显示退出确认模态框。
{% endupdate %}

{% update date="2026-06-16" tags="2.9.0,sdk" %}

## 应用包分发命令新增了 --timeout 选项

`ait deploy` 命令中可使用用于调整部署状态确认最大等待时间的 `--timeout` 选项。\
详细内容请参考 [测试 Toss App](https://developers-apps-in-toss.toss.im/development/test/toss.html) 文档。
{% endupdate %}

{% update date="2026-06-16" tags="2.8.0,sdk" %}

## 新增了非游戏导航栏主题设置功能

只需在配置文件中添加简单的值，就能设置非游戏导航栏的主题。\
支持透明模式和深色模式。\
\
详细内容请参考 [导航栏](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/UI/NavigationBar.html) 文档。
{% endupdate %}

{% update date="2026-06-12" tags="2.7.0,sdk" %}

## 推出了用户信息功能

在获得用户同意后，读取存储在 Toss 中的信息的 `getConsentedUserData`已新增。\
可请求姓名、手机号码、地址等最多 8 项内容。\
无需单独服务器，仅靠 SDK 就可使用。\
\
详细内容请参考 [用户信息](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9C%A0%EC%A0%80%20%EC%A0%95%EB%B3%B4/getConsentedUserData.html) 文档。
{% endupdate %}

{% update date="2026-06-10" tags="2.6.2,sdk" %}

## 修复 IAP 订阅支付回调 bug

在网页端 `IAP.createSubscriptionPurchaseOrder` 支付完成时 `processProductGrant` 回调未被调用的问题已修复。\
\
为防止发放错误，建议同时接入 [购买恢复逻辑](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/subscription.html#purchase-recovery)。
{% endupdate %}

{% update date="2026-05-27" tags="2.6.1,sdk" %}

## 移除迷你应用退出模态框

按下导航栏的 X 按钮时显示的退出确认模态框已被移除。
{% endupdate %}

{% update date="2026-05-19" tags="2.6.0,sdk" %}

## 新增相册媒体选择 · PDF 查看器功能

从用户相册中选择照片·视频的 `fetchAlbumItems`和将 PDF 数据在原生查看器中打开的 `openPDFViewer` 函数已新增。\
\
详细内容请参考 [相册](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%82%AC%EC%A7%84/album.html)与 [打开 PDF 查看器](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/PDF/openPDFViewer.html) 文档。
{% endupdate %}

{% update date="2026-05-12" tags="2.5.0,sdk" %}

## 新增请求通知同意文案功能

在发送需要事先同意的通知，例如补货通知、活动通知之前，可以向用户请求接收同意 UI。\
可以通过回调获取同意结果，并决定是否发送通知。\
\
详细内容请参考 [智能发送开发文档](https://developers-apps-in-toss.toss.im/smart-message/develop.html)。

#### 新增 Toss Pay 定期支付（自动扣款）功能

用户首次注册一次支付方式后，之后无需额外认证即可周期性自动扣款。\
通过获取 billing key，仅调用 API 就能进行重复扣款，可用于订阅服务、定期配送、会员制等多种循环计费模式。\
\
详细内容请参考 [Toss Pay 定期支付开发文档](https://developers-apps-in-toss.toss.im/tosspay/auto-pay.html)。
{% endupdate %}

{% update date="2026-04-09" tags="2.4.5,sdk" %}

## 新增非游戏用户识别键发放功能

此前只有在游戏中才能在无需服务器的情况下发放基于唯一 hash 的用户识别键。\
现在在非游戏场景中也可以用同样的方式发放用户识别键。\
同时，原有的“游戏登录”名称已更改为“用户识别键发放”。
{% endupdate %}

{% update date="2026-04-02" tags="2.4.1,sdk" %}

## SDK 2.4.1 稳定性改进更新

发现并修复了 React 19 环境下部分 API 的运行错误。\
已发布修复相关问题的 SDK 2.4.1。
{% endupdate %}

{% update date="2026-04-01" tags="2.4.0,sdk" %}

## 新增了评论请求功能

可在用户充分感受到应用价值的时机请求评论的 `requestReview` 功能已新增。\
合作方可通过该功能，在用户体验正向的瞬间自然引导评论，从而提升迷你应用的价值。\
\
详细内容请参考 [迷你应用评论请求](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%ED%84%B0%EB%A0%89%EC%85%98/requestReview.html) 文档。

<figure><img src="https://2374533303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUxeyFoMOPFK5sHyiSOqF%2Fuploads%2FDp863EC3sZKVXegTM48h%2Fimage.png?alt=media&#x26;token=6f582333-907b-4205-b4a2-3af50f6dba07" alt=""><figcaption></figcaption></figure>
{% endupdate %}

{% update date="2026-03-30" tags="2.3.0,sdk" %}

## 加强 ait CLI 帮助并新增发布备注选项

`ait` CLI 的 `--help` 内容已更加清晰地补充。\
另外，在执行 `deploy` 命令时，可以通过 `-m "发布备注"` 选项一并传递发布备注。
{% endupdate %}

{% update date="2026-03-30" tags="2.2.0,sdk" %}

## 新增订阅状态查询函数

现在可以使用用于查询订阅订单当前状态的 `getSubscriptionInfo`。\
该功能可在 Toss App Android 5.253.0、iOS 5.253.0 及以上版本中使用。
{% endupdate %}

{% update date="2026-03-24" tags="2.1.0,sdk" %}

## 改进字体大小及权限设置

已稳定字体大小行为并新增权限设置功能。

* 修复了横幅广告字体大小会根据系统字体设置而变化的问题。
* 修复了 Android WebView 中字体大小会根据系统设置而变化的问题。
* 新增可设置麦克风权限的功能。
  {% endupdate %}

{% update date="2026-03-18" tags="2.0.9,sdk" %}

## 提升构建及发布稳定性

修复了构建及上传过程中发生的问题。
{% endupdate %}

{% update date="2026-03-18" tags="2.0.8,sdk" %}

## 改进促销发放功能

现在在非游戏环境中也可以无需服务器发放促销。\
详细内容请参考 [促销指南](https://appsintoss.gitbook.io/appsintoss-docs/documentation/common/growth/promotion)。
{% endupdate %}

{% update date="2026-03-11" tags="2.0.5,sdk" %}

## SDK 2.0.5 稳定性改进更新

发现并修复了 SDK 2.0.4 中的额外错误。\
已发布修复相关问题的 SDK 2.0.5。
{% endupdate %}

{% update date="2026-03-10" tags="2.0.4,sdk" %}

## 改进了未能进行日志记录的问题

修复了在某些环境中日志无法正常收集的问题。
{% endupdate %}

{% update date="2026-03-10" tags="1.1.1,2.0.3,sdk" %}

## 退出确认模态框左侧按钮已改为\[关闭]

退出确认模态框左侧按钮的文案统一为\[关闭]。\
\[取消] 可能会让用户误以为当前正在进行的操作会被取消，因此不使用。\
\
详细内容请参考 [通用设置中的导航栏](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/UI/Config.html#%EB%82%B4%EB%B9%84%EA%B2%8C%EC%9D%B4%EC%85%98-%EB%B0%94) 文档。

<figure><img src="https://2374533303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUxeyFoMOPFK5sHyiSOqF%2Fuploads%2FXUAx3Yl0QGd3Dh3pV5P6%2Fimage.png?alt=media&#x26;token=57de7d44-298c-4c85-b021-94500430f1db" alt=""><figcaption></figcaption></figure>
{% endupdate %}

{% update date="2025-03-10" tags="1.1.0,2.0.2,sdk" %}

## SDK 2.0.2 稳定性改进更新

发现并修复了 SDK 2.0.1 中部分函数行为问题。\
已发布修复相关问题的 SDK 2.0.2。
{% endupdate %}

{% update date="2026-03-05" tags="feature,improvement,fix,1.0.3,2.0.1,sdk" %}

## SDK 2.0.1 版本已发布

支持 React Native 0.84 和 React 19 的 SDK 2.0.1 已发布。\
随着 Toss App RN 0.84 的更新，SDK 1.x 将不再支持。\
3 月 23 日之后，无法再将使用 1.x 构建的 bundle 上传到控制台。\
构建命令已从 `granite build`更改为 `ait build`。
{% endupdate %}

{% update date="2026-02-25" tags="api" %}

## 消息批量发送功能上线

可向多个用户一次性发送相同模板消息的 **消息批量发送功能**已上线。\
一次请求最多可发送 **2,500 条**。\
请在批量活动、通知公告等需要重复发送的场景中高效使用。
{% endupdate %}

{% update date="2025-11-12" tags="api" %}

## Toss 一键认证功能上线

**Toss 一键认证功能**已全新上线。\
现在用户无需输入个人信息，只需在 Toss App 中轻点一下即可便捷完成身份认证。\
\
本功能可通过 Toss 认证 API 的 `USER_NONE` 类型接入，且将\
`skipConfirmDoc` 参数 `true`设为后，即可跳过证书确认步骤。
{% endupdate %}

{% update date="2025-10-20" tags="api" %}

## Toss 认证功能上线

通过将用户输入的个人信息与 Toss 注册信息比对， **Toss App 认证**可用来确认身份的功能已上线。\
现在可以安全地确认 CI、姓名、手机号码等主要信息。
{% endupdate %}

{% update date="2025-09-19" tags="api" %}

## 应用内支付订单查询状态值变更

由于新增了应用内支付商品发放流程， `PAYMENT_COMPLETED` 状态已新增。
{% endupdate %}

{% update date="2025-08-05" tags="api" %}

## 应用内支付功能上线

可在应用内直接购买付费商品的 **应用内支付功能**已上线。\
请轻松销售数字商品、内容、权限等，并通过更短的购买流程快速提升营收。
{% endupdate %}

{% update date="2025-04-28" tags="api" %}

## 促销功能上线

根据用户的特定行为发放 Toss 积分的 **促销功能**已上线。\
请通过促销促进转化，并提升复访、病毒传播等整个漏斗的效果。
{% endupdate %}

{% update date="2025-04-25" tags="api" %}

## Toss Pay 功能上线

可在 Toss App 内快速且安全支付的 **Toss Pay 功能**已上线。\
请便捷地完成实物商品·服务支付。
{% endupdate %}

{% update date="2025-04-18" tags="api" %}

## Toss 登录功能上线

可使用 Toss 账号便捷登录的 **Toss 登录功能**已上线。\
只需一次同意，即可将注册、登录、信息提供一并连接起来。
{% endupdate %}

{% update date="2025-04-15" tags="api" %}

## 功能性推送功能上线

可在关键时刻重新召回用户的 **功能性推送、通知功能**已上线。\
请积极用于提升留存和促进转化。
{% endupdate %}
{% endupdates %}


---

# 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/release-note/changelog-zh/release-note.md?ask=<question>&goal=<endgoal>
```

`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.