> 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-09-21" tags="3.5.0,sdk" %} ## 可以在运行时更改导航栏 可在运行中更改返回·主页按钮和标题显示与否、透明背景、背景色、主题的 `NavigationBar.setOptions` 添加了 API。仅会应用传入的字段，省略的字段会保留上次应用的值，首次调用前则会使用小程序设置中的 `navigationBar` 值。也可以在 AIT Devtools 中以 mock 方式查看此 API。 {% endupdate %} {% update date="2026-09-15" tags="3.4.1,sdk" %} ## `Promotion.openContactsInvite` 请停止使用该 API 提供好友邀请（分享奖励）功能的 `Promotion.openContactsInvite`添加了 deprecated 标记。\ API 不会立即删除，但请不要再继续使用。该 API 提供的功能今后将由其他功能替代。 {% endupdate %} {% update date="2026-09-02" tags="3.2.0,sdk" %} ## 改进游戏和本地存储 API #### 新增游戏信息覆盖层隐藏订阅 API 可订阅游戏信息覆盖层消失时机的 `Game.subscribeInfoOverlayHidden` 新增了 API。 #### 新增一次读取和保存多个 Storage 值的 API 可一次查询并保存本地存储多个值的 `Storage.getItems`, `Storage.setItems` 新增了 API。 {% endupdate %} {% update date="2026-08-25" tags="3.1.1,sdk" %} ## 更改 WebView 小程序的服务 Origin 从 SDK 3.1.1 起，将以与现有 SDK 2.x 相同的 Origin 提供服务。
环境更改前更改后
实际服务环境https://{appName}.web.tossmini.comhttps://{appName}.apps.tossmini.com
控制台 QR 测试环境https://{appName}.private-web.tossmini.comhttps://{appName}.private-apps.tossmini.com
[查看社区公告]() {% endupdate %} {% update date="2026-08-18" tags="3.0.4,sdk" %} ## 改善 web-framework 的稳定性和开发体验 本次发布中，我们进一步稳定调整了小程序的默认行为，并改善了 CLI 和 Devtools 的开发体验。 * `webView.pullToRefreshEnabled`的默认值 `false`已更改为 false。此更改旨在防止滚动时发生意外刷新，如有需要可在 `apps-in-toss.config.ts` 中的 `defineConfig`中直接 `true`设置为 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/api-and-sdk-zh/integration/sdk-3.x.md)参考。 {% endupdate %} {% update date="2026-08-03" tags="3.0.1,sdk" %} ## WebView 项目结构得到改进 参数和返回值与现有 SDK 2.x 相同，因此无需单独修改代码即可应用。 * 配置文件结构变更：配置文件名称和部分属性发生了变化。 * 基于服务器的处理：已更改为将 SDK 内部处理逻辑放在服务器而非客户端处理。 * 稳定的问题应对：即使 SDK 出现问题，也可以无需合作方重新发布，直接在 Apps in Toss 服务器上修复并生效。 这是为提升小程序生态稳定性并将 SDK 维持在稳定版本而进行的更新。 详情请 [SDK 3.x 迁移文档](/documentation/api-and-sdk-zh/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" %} ## 已修复网页视图闪烁问题 使用底部弹窗时，解决了网页视图偶发闪烁的现象。 {% endupdate %} {% update date="2026-07-10" tags="2.10.5,sdk" %} ## 已修复导航栏透明模式下底部触控问题 导航栏选项中的 `transparent` 在 transparent 为 true 的状态下，屏幕底部无法触摸的问题已修复。\ 现在即使在透明模式下，也可以正常触摸屏幕底部。 {% endupdate %} {% update date="2026-07-16" tags="api" %} ## 在 Promotion、智能发送、TossPay API 中支持用户识别键（hash）认证 以前只能通过 Toss 登录获取的 userKey 来识别用户。\ 现在也可以使用通过用户识别键发放功能获得的 hash 值调用以下 API。
* **Promotion** : [通过服务器发放 Promotion 积分](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) * **TossPay 一次性支付** : [开发 TossPay 一次性支付](https://developers-apps-in-toss.toss.im/tosspay/develop.html) * **TossPay 定期支付** : [开发 TossPay 定期支付](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" %} ## TossPay 定期支付（自动扣款）功能已上线 用户首次注册一次支付方式后，之后即可无需额外认证，按周期自动扣款。\ 通过发放 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" %} ## 应用 bundle 发布命令新增了 --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)请参考。 #### 新增 TossPay 定期支付（自动扣款）功能 用户首次注册一次支付方式后，之后即可无需额外认证，按周期自动扣款。\ 通过发放 billing key，仅凭 API 调用即可进行重复扣款，可用于订阅服务·定期配送·会员等多种重复计费模式。\ \ 详情请参考 [TossPay 定期支付开发文档](https://developers-apps-in-toss.toss.im/tosspay/auto-pay.html)请参考。 {% endupdate %} {% update date="2026-04-09" tags="2.4.5,sdk" %} ## 新增非游戏用户识别键发放功能 以前只有在游戏中才能无需服务器发放唯一的基于哈希的用户识别键。\ 现在非游戏场景也可以用同样方式发放用户识别键。\ 此外，已将原有“游戏登录”名称更改为“用户识别键发放”。 {% 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) 文档
{% 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" %} ## Promotion 发放功能改进 现在即使在非游戏环境中也可以无需服务器进行 Promotion 发放。\ 详情请参考 [Promotion 指南](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) 文档
{% 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` 新增了 PAYMENT\_COMPLETED 状态。 {% endupdate %} {% update date="2025-08-05" tags="api" %} ## 推出应用内支付功能 可在应用内直接购买付费商品的 **应用内支付功能**已上线。\ 可轻松销售数字商品、内容、权限等，并通过更短的购买流程快速提升收入。 {% endupdate %} {% update date="2025-04-28" tags="api" %} ## 推出 Promotion 功能 以用户特定行为为依据发放 Toss 积分的 **Promotion 功能**已上线。\ 通过 Promotion 促进转化，并提升复访·传播等整个漏斗的效果。 {% endupdate %} {% update date="2025-04-25" tags="api" %} ## 推出 TossPay 功能 可在 Toss App 内快速且安全支付的 **TossPay 功能**已上线。\ 请便捷完成实物商品·服务支付。 {% 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=&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.