开发者更新日志
此页面列出了影响 Pushwoosh 集成的 SDK 发布、API 更新和平台变更。
2026 年 8 月
Anchor link to| 日期 | 组件 | 变更 | 详情 |
|---|---|---|---|
| 8 月 31 日 | Web Push SDK v3.70.0 | 新增 | 新增了 webPopups.colorScheme ('auto'、'light' 或 'dark')，用于选择配置了深色模式的弹出窗口所渲染的调色板。了解更多 |
| 8 月 31 日 | Web Push SDK v3.70.0 | 新增 | Web 弹出窗口的主题选择器和评级块现在通过 SDK 写入：选择的内容会附加到绑定的设备标签上，评级会作为自定义事件发布。了解更多 |
| 8 月 31 日 | Web Push SDK v3.70.0 | 变更 | 带有已过期倒计时块的 Web 弹出窗口将不再显示，即使通过 show() 手动触发也是如此。了解更多 |
| 8 月 27 日 | iOS SDK v7.2.5 | 变更 | 推送链接现在仅对应用的 Associated Domains 中列出的域在应用内打开。所有其他链接都在浏览器中打开。了解更多 |
| 8 月 27 日 | iOS SDK v7.2.5 | 新增 | PushwooshInboxKit 卡片现在将推送附件显示为卡片图片。了解更多 |
| 8 月 27 日 | iOS SDK v7.2.5 | 修复 | 修复了推送链接、外部链接和应用内按钮打开错误目标或根本不打开的问题。了解更多 |
| 8 月 24 日 | Customer Journey API | 变更 | send_email 点的 email_type 字段现在只接受空字符串、marketing 或 transactional（小写），在 Journey 验证或启动时进行验证。了解更多 |
| 8 月 21 日 | Android SDK v6.11.0 | 新增 | 在 pushwoosh-inapp-ui 中新增了一个视频应用内模板。它会显示一个全屏自动播放的视频，并叠加标题、消息和操作按钮，以及静音和关闭控件。了解更多 |
| 8 月 21 日 | Android SDK v6.11.0 | 新增 | 新增了 Pushwoosh.getBaseUrl()，用于返回 SDK 当前发送请求的 Pushwoosh API 端点。了解更多 |
| 8 月 21 日 | Android SDK v6.11.0 | 变更 | 在华为/荣耀仅支持 HMS 的设备上的推送传输现在在 Cordova 和 React Native 中自动检测，与原生应用匹配。在完整的 HMS 设置下，HMS Push Kit 可开箱即用。了解更多 |
| 8 月 21 日 | Android SDK v6.11.0 | 弃用 | Pushwoosh.enableHuaweiPushNotifications() 已被弃用，不再有任何效果。推送传输现已自动检测。了解更多 |
| 8 月 19 日 | Messaging API v2 | 新增 | 在 NotifySegment 中新增了 use_latest_user_device。设置后，仅向每个匹配用户的最近活动设备发送，而不是发送到与该用户 ID 关联的每个设备。了解更多 |
| 8 月 14 日 | iOS SDK v7.2.4 | 修复 | 修复了当应用从应用内委托回调中调用 SDK 时，原生应用内消息闪烁、消失或卡在屏幕上的问题。了解更多 |
| 8 月 14 日 | iOS SDK v7.2.4 | 修复 | 修复了当原生应用内消息的按钮链接包含空格或非拉丁字符时无法显示的问题。了解更多 |
| 8 月 14 日 | iOS SDK v7.2.4 | 修复 | 修复了原生应用内消息中的个性化占位符回退到默认文本而不是设备标签值的问题。了解更多 |
| 8 月 13 日 | Messaging API v2 | 新增 | 在 FrequencyCapping 中新增了 mode 和 timezone。新的日历日模式将计数和天数窗口锚定到给定 IANA 时区的本地午夜，而不是从发送时间开始的滚动窗口。了解更多 |
| 8 月 12 日 | React Native SDK v6.1.59 | 新增 | 新增了 setEmails() 和 setUserEmails()，用于为电子邮件渠道注册用户的电子邮件地址，将推送和电子邮件投递匹配到同一用户。了解更多 |
| 8 月 11 日 | Flutter SDK v2.3.23 | 新增 | 新增了 setAppCode()/getAppCode() 用于在运行时切换 Pushwoosh 应用及其 API 端点；在 initialize() 中新增了可选的 base_url 参数；新增了 presentInApp() 用于从配置对象渲染原生应用内消息。了解更多 |
| 8 月 10 日 | iOS SDK v7.2.3 | 修复 | 修复了可能导致 Rich Media 无法显示的问题。了解更多 |
| 8 月 10 日 | iOS SDK v7.2.3 | 变更 | 提高了在运行时配置 SDK 的应用的启动集成检查的准确性。了解更多 |
| 8 月 07 日 | iOS SDK v7.2.2 | 新增 | 原生应用内消息现在支持动态内容：营销活动文本中的个性化占位符会用设备的标签值填充，与 Rich Media 相同。了解更多 |
| 8 月 07 日 | iOS SDK v7.2.2 | 修复 | 修复了读取前台推送委托时可能发生的崩溃，以及当营销活动上下文或自定义推送数据携带无效 JSON 值时 Rich Media 的渲染问题。了解更多 |
| 8 月 07 日 | iOS SDK v7.2.2 | 变更 | 增强了 SDK 对格式错误的服务器和推送负载的抵御能力，提高了收件箱操作、推送处理和注册的稳定性。了解更多 |
| 8 月 07 日 | Android SDK v6.10.2 | 新增 | 原生应用内消息现在支持动态内容：营销活动文本中的个性化占位符会用设备的标签值填充，与 Rich Media 相同。了解更多 |
| 8 月 06 日 | Messaging API v2 | 新增 | 在 SMS 负载块中新增了 subject、file_urls 和 message_at。subject 和 file_urls 会在具有 MMS 端点的提供商上将消息转换为 MMS；其他提供商会忽略这两者并发送纯文本正文。了解更多 |
| 8 月 03 日 | Android SDK v6.10.1 | 新增 | 在 pushwoosh-inapp-ui 中新增了横幅（带有可选自动关闭的紧凑条）、轮播（可滑动的卡片组）和底部卡片（底部固定的卡片，可向下滑动关闭）应用内模板。了解更多 |
2026 年 7 月
Anchor link to| 日期 | 组件 | 变更 | 详情 |
|---|---|---|---|
| 7 月 31 日 | iOS SDK v7.2.1 | 新增 | PushwooshInApp 支持底部卡片、轮播（可滑动的幻灯片）和横幅（紧凑的 toast）应用内模板，此外还支持模态、全屏和故事模板。了解更多 |
| 7 月 31 日 | Statistics API | 变更 | 当 page × per_page 超过 100,000 时，messages:list 现在会报错。请缩小日期范围或使用更小的页面。了解更多 |
| 7 月 29 日 | Messaging API v2 | 修复 | Notify 不再丢弃包含 Liquid 个性化（{{ }} / {% %}）的深层链接 URL。了解更多 |
| 7 月 28 日 | Messaging API v2 | 变更 | 同时设置 days: 0 和 count: 0 现在会完全禁用频率上限，而不是返回错误。这使得在无需额外逻辑的情况下关闭上限变得更容易。仅发送 days 或 count 中的一个仍会被拒绝。了解更多 |
| 7 月 27 日 | Web Push SDK v3.63.0 | 新增 | Web 弹出窗口现在可以完全由您自己的代码控制，新增了用于显示、隐藏和检查弹出窗口状态的 API，以及用于实时响应可见性变化的事件。了解更多 |
| 7 月 24 日 | iOS SDK v7.2.0 | 新增 | 应用内消息现在可以在设备上原生渲染。新增了 PushwooshInApp，通过 Pushwoosh.inApp API 支持模态、全屏和故事模板。了解更多 |
| 7 月 24 日 | Android SDK v6.10.0 | 新增 | 应用内消息现在可以在设备上原生渲染。新增了 pushwoosh-inapp-ui，通过 PushwooshInAppUi API 支持模态、全屏和故事模板。了解更多 |
| 7 月 24 日 | Android SDK v6.10.0 | 修复 | 修复了可能导致某些应用内消息无法显示的问题。了解更多 |
| 7 月 21 日 | User-centric API | 新增 | postEvent 现在支持 PW_Conversion 用于收入跟踪。了解更多 |
| 7 月 15 日 | iOS SDK v7.1.5 | 修复 | 修复了自定义 VoIP 铃声配置的问题，并使 SDK 对格式错误的推送负载、标签、收件箱数据和富媒体内容更具弹性。了解更多 |
| 7 月 15 日 | iOS SDK v7.1.5 | 变更 | Live Activity 推送令牌现在会在应用重新启动后重新注册，并跳过重复的令牌更新，以实现更可靠的远程更新。了解更多 |
| 7 月 14 日 | Liquid Templates | 新增 | connected_content 标签现在可以发送请求头，因此您可以在从 URL 拉取动态内容时传递授权令牌。了解更多 |
| 7 月 09 日 | Android SDK v6.9.6 | 变更 | 使 SDK 对应用内消息、Rich Media 和通知处理中的罕见问题更具弹性。在 Google Play 服务库过时或缺失的设备上，地理定位、地理围栏和 Firebase 推送注册现在也更可靠，标签更新和本地通知存储处理也得到了改进。了解更多 |
| 7 月 03 日 | Android SDK v6.9.5 | 变更 | 模态 Rich Media 动画时长现在可以通过应用内样式设置进行远程配置，无需更新应用。通知、应用内消息和 Rich Media 在此版本中也进行了稳定性改进。了解更多 |
| 7 月 03 日 | iOS SDK v7.1.4 | 新增 | Live Activities 现在可以安排在未来日期开始，并可通过 activityId 取消。模态 Rich Media 现在支持淡入淡出和无动画过渡，并可配置动画时长。了解更多 |
| 7 月 03 日 | iOS SDK v7.1.4 | 修复 | 修复了模态 Rich Media 自动关闭计时器（之前仅在首次显示时有效）以及模态 Rich Media 关闭后的资源清理问题。了解更多 |
| 7 月 01 日 | Messaging API v2 | 新增 | Notify 现在通过 viber 负载块支持 Viber 作为渠道。了解更多 |
2026 年 6 月
Anchor link to| 日期 | 组件 | 变更 | 详情 |
|---|---|---|---|
| 6 月 26 日 | Messaging API v2 | 新增 | 通过向事务性 Notify 的 android 块添加 live_update 对象（OPERATION_START/OPERATION_UPDATE/OPERATION_END，共享 live_update.id）来发送 Android Live Updates。了解更多 |
| 6 月 25 日 | iOS SDK v7.1.3 | 新增 | 为拥有 UNUserNotificationCenter 委托的应用新增了 handleWillPresentNotification() 和 handleNotificationResponse()，以及一个打印配置诊断信息的启动集成检查器。了解更多 |
| 6 月 25 日 | Android SDK v6.9.4 | 变更 | 模态应用内消息现在可以在没有过渡动画的情况下呈现。了解更多 |
| 6 月 24 日 | Messaging API v2 | 新增 | Notify 现在可以从保存的预设构建 SMS：设置负载级别的 sms_preset，而不是为每个区域设置内联 sms.body（内联 sms.body 仍然会覆盖该区域设置的预设）。了解更多 |
| 6 月 24 日 | Android SDK v6.9.3 | 修复 | 修复了模态 Rich Media 在后台转换和打开外部链接时的崩溃问题。Core 和 WebKit 现在作为传递依赖项提供。取代已撤回的 6.9.2 版本。了解更多 |
| 6 月 19 日 | Google Wallet API | 新增 | 从您的后端发行和更新 Google Wallet 通行证。更改会同步到保存了该通行证的每台设备。了解更多 |
| 6 月 18 日 | iOS SDK v7.1.2 | 新增 | PushwooshInboxKit 现在支持通过 displayType 为每条消息选择丰富的卡片类型（轮播、视频和 Apple Wallet），并为 Wallet 通行证操作提供委托回调。了解更多 |
| 6 月 18 日 | Customer Journey API | 新增 | 新的 REST/JSON Customer Journey API，用于创建、更新和管理 Journey，触发 API 入口，并读取 Journey 统计信息（基础 URL https://journey.pushwoosh.com）。了解更多 |
| 6 月 16 日 | Android SDK v6.9.1 | 新增 | 新增了 getSubscriptionAccountId() 用于 Google Play Billing 订阅归因。Firebase Messaging 现在作为传递依赖项提供。Live Updates 进度条可以隐藏，仅用于状态更新。了解更多 |
| 6 月 16 日 | Web Push SDK v3.59.0 | 新增 | 从代码中嵌入 Web 弹出窗口：从 SDK 包中导出 WebPopupsWidget。了解更多 |
| 6 月 15 日 | Messaging API v2 | 新增 | 新增了 Cancel 方法 (POST /messaging/v2/cancel)，用于通过 message_code 取消待处理、等待中或处理中的消息。了解更多 |
| 6 月 15 日 | iOS SDK v7.1.1 | 新增 | 新增了 Pushwoosh.configure.pushPrimer，这是一个在 iOS 系统权限提示前显示的可自定义的软性选择加入对话框。了解更多 |
| 6 月 15 日 | iOS SDK v7.1.0 | 新增 | 新增了 PushwooshNotificationServiceExtension，这是一个用于通知服务扩展的即用型基类。了解更多 |
| 6 月 15 日 | iOS SDK v7.1.0 | 弃用 | PWNotificationExtensionManager 已被弃用，建议使用 PushwooshNotificationServiceExtension 的子类。了解更多 |
| 6 月 11 日 | Messaging API v2 | 新增 | 在 NotifyTransactional 中新增了 use_latest_user_device：当目标为 users 时，仅向每个用户最近活动的设备发送。了解更多 |
| 6 月 11 日 | Customer Journey Statistics API | 变更 | 应用内 Journey 元素现在返回 pointStat 指标 shows、interactions 和 skipped，而不是 sent/opened/conversion。了解更多 |
| 6 月 08 日 | iOS SDK v7.0.46 | 新增 | 新增了 PushwooshNotificationUI 模块：一个即用型的全屏“故事”体验，用于展开的推送通知，通过在通知内容扩展中继承 PushwooshStoriesViewController 来渲染。了解更多 |
| 6 月 08 日 | iOS SDK v7.0.46 | 修复 | 修复了 App Store 上传被拒（错误 409）、通知服务扩展在使用 App Groups 时挂起以及格式错误的角标值导致的崩溃问题。了解更多 |
| 6 月 02 日 | Android SDK v6.9.0 | 新增 | 新增了 pushwoosh-liveupdates 模块，用于在 Android 16 (API 36+) 上实现持续的、进度式的通知，适用于订单、行程和配送等用例。了解更多 |
| 6 月 02 日 | Apple Wallet PassKit API | 新增 | 新增了 Apple Wallet 通行证作为渠道，并提供了 PassKit API 用于发行和更新通行证。更新会同步到添加了该通行证的每台设备。了解更多 |
| 6 月 01 日 | Tags API | 新增 | 新增了用于电子邮件分段的电子邮件系统标签：Last Email Open Message Code、Last Email Click Message Code、Last Email Confirm、Bounced Email 和 Unsubscribed Emails。了解更多 |
2026 年 5 月
Anchor link to| 日期 | 组件 | 变更 | 详情 |
|---|---|---|---|
| 5 月 26 日 | Messaging API v2 | 新增 | Notify 现在支持 SMS 作为一级渠道。了解更多 |
| 5 月 22 日 | Web Push SDK v3.57.0 | 新增 | 新增了 api.setLanguage(...) 用于覆盖设备区域设置。其优先级高于 initParams 和 navigator.language。了解更多 |
| 5 月 22 日 | Web Push SDK v3.57.0 | 新增 | 在 SDK init 参数中新增了对 webPopups 小部件选项的支持。了解更多 |
| 5 月 22 日 | SMTP gateway | 新增 | 新增了 SMTP 提交端点 smtp.pushwoosh.com:587 (STARTTLS + AUTH PLAIN)。消息将作为事务性电子邮件转发到 Messaging API v2。了解更多 |
| 5 月 21 日 | Android SDK v6.8.1 | 变更 | 提高了会话、空闲和退出意图跟踪的准确性。setLogLevel() 现在会保留先前的级别，并在遇到无法识别的值时记录错误而不是抛出异常。了解更多 |
| 5 月 18 日 | iOS SDK v7.0.43 | 移除 | 旧版 PushwooshInboxUI 已从构建和发布管道中移除。请迁移到 PushwooshInboxKit。了解更多 |
| 5 月 18 日 | iOS SDK v7.0.43 | 变更 | 包含 . 的应用代码现在被明确拒绝。这种格式早已被弃用。如果您仍在使用，请联系 Pushwoosh 支持。了解更多 |
| 5 月 18 日 | iOS SDK v7.0.43 | 修复 | InboxKit 刷新现在仅在真正的后台转换时运行，以防止额外的 POST 请求 |
| 5 月 14 日 | Android SDK v6.8.0 | 新增 | 新增了 setAdvertisingId() 用于将 GAID 传递给 Pushwoosh 以进行 Meta Ads MADID 匹配。需要用户同意并在您的应用中手动集成。了解更多 |
| 5 月 13 日 | iOS SDK v7.0.41 | 新增 | 新增了 setAdvertisingId() 用于将 IDFA 传递给 Pushwoosh 以进行 Meta Ads MADID 匹配。需要在您的应用中获得 ATT 同意并手动集成。了解更多 |
| 5 月 07 日 | iOS SDK v7.0.40 | 新增 | 新增了 PushwooshInboxKit，支持横幅、带标题和经典卡片布局，内联 CTA 按钮，以及滑动删除功能。了解更多 |
| 5 月 04 日 | Tags API | 移除 | 从 Tags API 响应中移除了 application_specific 字段。了解更多 |