@tencentcloud/sdk-mcp 1.6.7 → 1.7.0

package/resource/knowledge/push/integration/android.md

@@ -2,7 +2,7 @@
 
 ## 前提条件
 
-请确认已开通 Push 服务并按需完成 **Android 厂商配置**（小米 / 华为 / OPPO / vivo / 荣耀 / 魅族 / Google FCM），获取到了下列信息：
+请确认已 开通 Push 服务 并按需完成 **Android 厂商配置**（小米 / 华为 / OPPO / vivo / 荣耀 / 魅族 / Google FCM），获取到了下列信息：
 
 |**资源**|**获取位置**|**用途**|
 |---------|---------|---------|
@@ -19,25 +19,21 @@
 
 ## AI 集成
 
-通过 npm 安装 [@tencent-rtc/trtc-push-skill](https://www.npmjs.com/package/@tencent-rtc/trtc-push-skill/v/1.0.1#%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) 到本地 AI IDE 中，辅助完成 TIMPush 离线推送集成。安装后，你可以直接向 AI 输入“集成 Android 离线推送”“帮我集成 Android TIMPush”等需求，AI 将根据项目类型引导你完成环境检测、厂商通道配置、凭据填写、代码接入和验证等步骤。
+通过 npx 安装 [@tencent-rtc/trtc-push-skill](https://www.npmjs.com/package/@tencent-rtc/trtc-push-skill/v/1.0.1#%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) 到本地 AI IDE 中，辅助完成 TIMPush 离线推送集成。安装后，您可以直接向 AI 输入“集成 Android 离线推送”“帮我集成 Android TIMPush”等需求，AI 将根据项目类型引导您完成环境检测、厂商通道配置、凭据填写、代码接入和验证等步骤。
 
 > **注意：**
->
 > 使用 Push Skill AI 集成不是全自动流程，依然需要开发者在厂商配置控制台、腾讯云控制台等配置 Push 相关信息。具体的配置方法请参考下文相关章节。
 >
 
 ## 集成 TIMPush
 
-如果你想手动集成，请按下述操作步骤依次完成放置配置文件、配置 Gradle、补充 Manifest 与混淆。
+如果您想手动集成，请按下述操作步骤依次完成放置配置文件、配置 Gradle、补充 Manifest 与混淆。
 
 ### 下载并添加 TIMPush 配置文件
 
-完成厂商配置后，在腾讯云控制台下载 `timpush-configs.json`，下载路径为：
-
-下载后，将该文件添加到应用模块的 `assets` 目录。推荐存储路径：`app/src/main/assets/timpush-configs.json`，其中 app 是你项目的应用模块，可替换成实际名称。如果工程中没有 `assets` 目录，请在 `src/main/` 下手动创建。
+下载后，将该文件添加到应用模块的 `assets` 目录。推荐存储路径：`app/src/main/assets/timpush-configs.json`，其中 app 是您项目的应用模块，可替换成实际名称。如果工程中没有 `assets` 目录，请在 `src/main/` 下手动创建。
 
 > **注意：**
->
 > TIMPush 注册推送时会读取该文件中的厂商证书配置，不要放在 MainActivity 同级目录、工程根目录或 res 目录。如果文件缺失或放错目录，SDK 无法获得对应厂商通道配置，可能导致注册或收消息失败。
 >
 
@@ -50,14 +46,13 @@
 |荣耀|`mcs-services.json`|在荣耀开发者服务平台下载。修改项目、应用信息或开发服务设置后，需要重新下载。|
 |Google FCM|`google-services.json`|在 Firebase 控制台下载。|
 
-推荐放置路径如下（与应用模块的 `build.gradle` / `build.gradle.kts` 同级），其中 app 是你项目的应用模块，可替换成实际名称：
+推荐放置路径如下（与应用模块的 `build.gradle` / `build.gradle.kts` 同级），其中 app 是您项目的应用模块，可替换成实际名称：
 ``` text
 app/mcs-services.json            # 荣耀
 app/google-services.json         # Google FCM
 ```
 
 > **注意：**
->
 > 修改厂商平台项目、应用信息、证书指纹或开发服务设置后，厂商配置文件需要重新下载并替换。
 >
 
@@ -75,7 +70,6 @@ Android 工程可能使用 Groovy DSL 或 Kotlin DSL，请先根据文件后缀
 请根据工程使用的 Gradle 版本选择配置位置。如果不确定工程使用的 Gradle 版本，可在项目根目录 `gradle/wrapper/gradle-wrapper.properties` 中查看 `distributionUrl` 对应的版本号。
 
 > **注意：**
->
 > 不要把 Groovy 示例直接复制到 `.kts` 文件中。Kotlin DSL 使用双引号、括号和 `uri(...)` 写法。
 >
 
@@ -84,10 +78,11 @@ Android 工程可能使用 Groovy DSL 或 Kotlin DSL，请先根据文件后缀
 在项目级 `settings.gradle`（Groovy DSL）或 `settings.gradle.kts`（Kotlin DSL）中，同时在 `pluginManagement > repositories` 和 `dependencyResolutionManagement > repositories` 中添加仓库。
 
 【Groovy DSL (settings.gradle)】
-``` groovy
+``` java
 pluginManagement {
     repositories {
         gradlePluginPortal()
+        google()
         mavenCentral()
         maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
         maven { url "https://developer.huawei.com/repo/" }
@@ -108,10 +103,11 @@ dependencyResolutionManagement {
 ```
 
 【Kotlin DSL (settings.gradle.kts)】
-``` kotlin
+``` java
 pluginManagement {
     repositories {
         gradlePluginPortal()
+        google()
         mavenCentral()
         maven { url = uri("https://mirrors.tencent.com/nexus/repository/maven-public/") }
         maven { url = uri("https://developer.huawei.com/repo/") }
@@ -133,12 +129,13 @@ dependencyResolutionManagement {
 
 【Gradle 7.0 版本】
 
-Gradle 7.0 版本通常使用 Groovy DSL。如你的工程使用 Kotlin DSL，请将单引号改为双引号，`url "..."` 改为 `url = uri("...")`。
+Gradle 7.0 版本通常使用 Groovy DSL。如您的工程使用 Kotlin DSL，请将单引号改为双引号，`url "..."` 改为 `url = uri("...")`。
 1. 在项目级 `build.gradle` 的 `buildscript > repositories` 中添加插件仓库。
 
-``` java
+``` groovy
 buildscript {
     repositories {
+        google()
         mavenCentral()
         maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
         maven { url "https://developer.huawei.com/repo/" }
@@ -153,7 +150,7 @@ buildscript {
 ```
 2. 在 `settings.gradle` 的 `dependencyResolutionManagement > repositories` 中添加依赖仓库。
 
-``` java
+``` groovy
 dependencyResolutionManagement {
     repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
     repositories {
@@ -168,12 +165,13 @@ dependencyResolutionManagement {
 
 【Gradle 7.0 以下版本】
 
-Gradle 7.0 以下版本通常使用 Groovy DSL。如你的工程使用 Kotlin DSL，请将单引号改为双引号，`url "..."` 改为 `url = uri("...")`。
+Gradle 7.0 以下版本通常使用 Groovy DSL。如您的工程使用 Kotlin DSL，请将单引号改为双引号，`url "..."` 改为 `url = uri("...")`。
 
 在项目级 `build.gradle` 的 `buildscript > repositories` 和 `allprojects > repositories` 中添加仓库。
 ``` groovy
 buildscript {
     repositories {
+        google()
         mavenCentral()
         maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
         maven { url "https://developer.huawei.com/repo/" }
@@ -197,67 +195,144 @@ allprojects {
 }
 ```
 
+> **说明：**
+> - 如果旧工程已升级到 Gradle 8 / AGP 8，请不要继续使用 `com.huawei.agconnect:agcp:1.6.0.300`，建议改为 `com.huawei.agconnect:agcp:1.9.1.301` 或更高已验证版本。
+> - 若使用 Google FCM，`com.google.gms:google-services:4.4.2` 要求 AGP 7.3.0 及以上；如果项目的 AGP 低于 7.3.0，请改用与当前 AGP 兼容的 Google Services Gradle Plugin 版本，例如 `4.3.15`。
+
 ### 配置厂商插件
 
-华为、荣耀和 Google FCM 需要按厂商要求集成对应插件。插件的作用是在构建期读取上一步放置的厂商配置文件，并把厂商要求的资源、Manifest 信息或初始化配置合并进应用包。
-- **Gradle 7.0 / 7.0 以下**：上方仓库示例的 `buildscript > dependencies` 已包含 classpath，跳过本节。
+华为、荣耀和 Google FCM 需要按厂商要求集成对应 Gradle 插件。插件会在构建期读取上一步放置的厂商配置文件，并将厂商要求的资源、Manifest 信息或初始化配置合并进应用包。
+
+如果只集成某个厂商，只添加该厂商需要的插件和配置文件即可。例如未接入 FCM 时，不需要添加 `com.google.gms.google-services` 插件和 `google-services.json`。
+
+#### 配置项目级插件依赖
 
-- **Gradle 7.1 及以上**：仓库已挪到 `settings.gradle`，需要在项目级 `build.gradle` / `build.gradle.kts` 中追加 `buildscript > dependencies` 声明 classpath。
+项目级插件依赖用于让 Gradle 在构建期找到并加载华为、荣耀、Google FCM 等厂商插件。请先根据项目使用的 Gradle 版本选择对应配置。
 
-   项目级插件依赖示例：
+【Gradle 7.1 及以上】
+
+Gradle 7.1 及以上项目通常会在 `settings.gradle` 或 `settings.gradle.kts` 中配置依赖仓库。但如果厂商插件通过 `buildscript > dependencies > classpath` 声明，还需要在项目级 `build.gradle` 或 `build.gradle.kts` 的 `buildscript > repositories` 中同步配置插件仓库，否则可能出现厂商插件 classpath 依赖解析失败。
+
+如果项目级 `build.gradle.kts` 已通过 `plugins {}` 块声明 AGP（新建 Kotlin DSL 项目的默认方式），原有 `plugins {}` 块保留不动，不需要整体迁移到 `buildscript` 写法。由于荣耀官方示例统一使用 `buildscript > dependencies > classpath` 声明 `asplugin`，请在项目级 Gradle 文件中额外补充 `buildscript` 配置，并在 `dependencies` 中声明 `com.android.tools.build:gradle`。如果项目同时使用 Kotlin Android 插件，也请声明 `org.jetbrains.kotlin:kotlin-gradle-plugin`。
+
+请在 Android 工程的项目级 `build.gradle` 或 `build.gradle.kts` 中添加以下配置。
 
 【Groovy DSL（build.gradle）】
-``` groovy
+``` java
 buildscript {
+    repositories {
+        google()
+        mavenCentral()
+        gradlePluginPortal()
+        maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
+        maven { url "https://developer.huawei.com/repo/" }
+        maven { url "https://developer.hihonor.com/repo" }
+    }
     dependencies {
-        classpath 'com.google.gms:google-services:4.3.15'
-        classpath 'com.huawei.agconnect:agcp:1.6.0.300'
+        // 请与项目当前 Android Gradle Plugin 版本保持一致。
+        classpath 'com.android.tools.build:gradle:<AGP_VERSION>'
+        // 如果项目使用 Kotlin Android 插件，请与项目当前 Kotlin Gradle Plugin 版本保持一致。
+        classpath 'org.jetbrains.kotlin:kotlin-gradle-plugin:<KOTLIN_VERSION>'
+        // Google FCM。
+        classpath 'com.google.gms:google-services:4.4.2'
+        // 华为 AGConnect。Gradle 8 / AGP 8 项目不要继续使用 1.6.0.300。
+        classpath 'com.huawei.agconnect:agcp:1.9.1.301'
+        // 荣耀 Push。
         classpath 'com.hihonor.mcs:asplugin:2.0.1.300'
     }
 }
 ```
 
 【Kotlin DSL（build.gradle.kts）】
-``` kotlin
+``` java
 buildscript {
+    repositories {
+        google()
+        mavenCentral()
+        gradlePluginPortal()
+        maven { url = uri("https://mirrors.tencent.com/nexus/repository/maven-public/") }
+        maven { url = uri("https://developer.huawei.com/repo/") }
+        maven { url = uri("https://developer.hihonor.com/repo") }
+    }
     dependencies {
-        classpath("com.google.gms:google-services:4.3.15")
-        classpath("com.huawei.agconnect:agcp:1.6.0.300")
+        // 请与项目当前 Android Gradle Plugin 版本保持一致。
+        classpath("com.android.tools.build:gradle:<AGP_VERSION>")
+        // 如果项目使用 Kotlin Android 插件，请与项目当前 Kotlin Gradle Plugin 版本保持一致。
+        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:<KOTLIN_VERSION>")
+        // Google FCM。
+        classpath("com.google.gms:google-services:4.4.2")
+        // 华为 AGConnect。Gradle 8 / AGP 8 项目不要继续使用 1.6.0.300。
+        classpath("com.huawei.agconnect:agcp:1.9.1.301")
+        // 荣耀 Push。
         classpath("com.hihonor.mcs:asplugin:2.0.1.300")
     }
 }
 ```
+1. 请将`<AGP_VERSION>`替换为项目当前使用的 Android Gradle Plugin 版本，例如 `8.9.1`。如果项目级 `plugins {}` 块中已经声明了 `com.android.application` 版本，两个位置的 AGP 版本需要保持一致。
 
-   应用级插件配置示例：
+2. 请将`<KOTLIN_VERSION>` 替换为项目当前使用的 Kotlin Gradle Plugin 版本；如果项目未使用 Kotlin Android 插件，可删除该行。
 
-【Groovy DSL（build.gradle）】
+> **注意：**
+> 对于 Gradle 8 / AGP 8 项目，请不要继续使用 `com.huawei.agconnect:agcp:1.6.0.300`。AGP 8.0 已移除 Transform API，旧版 AGC 插件存在兼容风险，建议使用 `com.huawei.agconnect:agcp:1.9.1.301` 或更高已验证版本。若使用 Google FCM，`com.google.gms:google-services:4.4.2` 要求 AGP 7.3.0 及以上。
+>
+
+【Gradle 7.0 及以下】
+
+如果您已在上一节「配置 Gradle 仓库」中按照 Gradle 7.0 或 Gradle 7.0 以下示例配置了 `buildscript > repositories` 和 `buildscript > dependencies`，可以跳过本节的项目级插件依赖配置。
+
+如果尚未配置，请回到上一节，根据当前 Gradle 版本补充 `buildscript` 中的仓库和插件 classpath。
+
+#### 在应用模块启用厂商插件
+
+完成项目级插件依赖配置后，还需要在应用模块的 `build.gradle` 或 `build.gradle.kts` 中启用厂商插件。应用模块通常为 `app`。
+
+如果应用模块中已经存在 `plugins` 块，请在现有 `plugins` 块中追加厂商插件，不要重复添加已有的 `com.android.application` 插件。
+
+【Groovy DSL（app/build.gradle）】
+``` groovy
+plugins {
+    // Google FCM。
+    id 'com.google.gms.google-services'
+    // 华为 AGConnect。
+    id 'com.huawei.agconnect'
+    // 荣耀 Push。
+    id 'com.hihonor.mcs.asplugin'
+}
+```
+
+如果您的应用级 `build.gradle` 使用 `apply plugin` 写法，也可以写成：
 ``` groovy
 apply plugin: 'com.google.gms.google-services'
 apply plugin: 'com.huawei.agconnect'
 apply plugin: 'com.hihonor.mcs.asplugin'
 ```
 
-【Kotlin DSL（build.gradle.kts）】
+【Kotlin DSL（app/build.gradle.kts）】
 ``` kotlin
 plugins {
+    // Google FCM。
     id("com.google.gms.google-services")
+    // 华为 AGConnect。
     id("com.huawei.agconnect")
+    // 荣耀 Push。
     id("com.hihonor.mcs.asplugin")
 }
 ```
 
-   只集成某个厂商时，只添加该厂商需要的插件和配置文件即可。例如未接入 FCM 时，不需要添加 `com.google.gms.google-services` 插件。
+如果您的应用级 `build.gradle.kts` 使用 `apply` 写法，也可以写成：
+``` kotlin
+apply(plugin = "com.google.gms.google-services")
+apply(plugin = "com.huawei.agconnect")
+apply(plugin = "com.hihonor.mcs.asplugin")
+```
 
-   > **说明：**
-   >
-   > 荣耀官方示例统一使用 `buildscript > dependencies > classpath` 声明 `asplugin`，未提供 `plugins {}` 块写法。如果项目级 `build.gradle.kts` 用 `plugins {}` 块声明 AGP（新建 Kotlin DSL 项目的默认方式），请在 `buildscript > dependencies` 中**额外补上** `com.android.tools.build:gradle` 和 `org.jetbrains.kotlin:kotlin-gradle-plugin` 的 classpath（原 `plugins {}` 块保留不动）。应用级 `plugins { id(...) }` 可省略版本号（由项目级 classpath 提供），或改写为 `apply plugin: "..."`。
-   >
+完成配置后，请在 Android Studio 中单击 **Sync Now**，或选择 **File > Sync Project with Gradle Files** 触发 Gradle 同步。同步成功后，再执行构建验证。
 
 ### 集成 TIMPush 依赖
 
 在应用模块的 `build.gradle` 或 `build.gradle.kts` 中添加 TIMPush 依赖。基础包提供 TIMPush 注册、监听和通用能力；厂商包用于对接对应厂商离线推送通道。只集成基础包而不集成目标厂商包时，设备可能无法通过该厂商通道收到离线推送。
 
-下方示例中的 `VERSION` 均指 TIMPush SDK 的版本号（如 `8.9.7537`），不是 Android 系统版本或厂商 SDK 版本。获取最新版本号请查看[更新日志](https://trtc.io/zh/document/60545)。
+下方示例中的 `VERSION` 均指 TIMPush SDK 的版本号（如 `8.9.7537`），不是 Android 系统版本或厂商 SDK 版本。获取最新版本号请查看更新日志。
 
 【Groovy DSL】
 ``` groovy
@@ -306,7 +381,6 @@ dependencies {
 添加依赖后，请在 Android Studio 中单击 **Sync Now**，或选择 **File > Sync Project with Gradle Files** 触发 Gradle 同步。
 
 > **注意：**
->
 > `TIMPush`、`TUICore` 和各厂商通道包建议使用相同 `VERSION`，避免依赖冲突。项目已接入 IM SDK 或 TUIKit 时，也需要确认相关 SDK 版本兼容。
 >
 
@@ -393,14 +467,16 @@ android {
 
 ### registerPush
 
-registerPush 用于注册当前设备的推送 token。注册成功后，后台才能根据 `registrationID` 或 `userID` 向该设备下发离线推送。其中 `appKey` 的取值会影响注册方式：
+registerPush 用于向 TIMPush 注册当前设备的推送 token。推送 token 是厂商通道返回的设备凭证，通常由 SDK 自动处理。注册成功后，TIMPush 会为当前设备建立一个推送目标标识 `registrationID`；服务端、控制台接入测试和排查工具可以使用该标识向这台设备下发离线推送。若 App 同时接入 IM 并完成登录，也可以使用 `userID` 向该用户已建立推送关系的设备下发离线推送。
+
+`appKey` 的取值会影响注册方式和可用的推送标识：
 - `appKey = Push Key`：注册 TIMPush 独立推送能力。Push Key 客户端密钥。
 
 - `appKey = null`：复用 IM 登录态注册推送，必须在 IM `login` 成功后调用。
 
    请先根据业务场景确认调用顺序：
 
-| <strong>场景</strong> | <strong>调用顺序</strong> | <strong>后台可用推送标识</strong> | <strong>说明</strong> |
+| <strong>场景</strong> | <strong>调用顺序</strong> | <strong>服务端可用于发送推送的目标标识</strong> | <strong>说明</strong> |
 | --- | --- | --- | --- |
 | 仅使用 TIMPush | App 每次冷启动后调用<br><code>registerPush（appKey = Push Key）</code> | <code>registrationID</code> | 适用于营销 / 活动 / 通知推送，不接入 IM SDK。 |
 | IM SDK + TIMPush<br>先注册 Push 再登录 | <code>registerPush(appKey = Push Key)</code><br>→ IM <code>login</code> | 登录前：<code>registrationID</code>；<br>登录后：<code>registrationID</code> + <code>userID</code> | 适用于希望用户未登录时也能收到营销推送的场景。 |
@@ -408,8 +484,8 @@ registerPush 用于注册当前设备的推送 token。注册成功后，后台
 
    > **注意：**
    >
-   > 1. 如果用户退出 IM SDK，同时集成了 IM SDK + TIMPush 的场景下已建立的 `userID` 与 `registrationID` 推送关系都会失效，需要重新完成对应注册。
-   > 2. Chat 应用的密钥仅用于 IM 登录，不能作为 `registerPush` 的 `appKey`。
+   > - 如果用户退出 IM SDK，同时集成了 IM SDK + TIMPush 的场景下已建立的 `userID` 与 `registrationID` 推送关系都会失效，需要重新完成对应注册。
+   > - Chat 应用的密钥仅用于 IM 登录，不能作为 `registerPush` 的 `appKey`。
 
 【App 冷启动注册 TIMPush（appKey 传 Push Key）】
 
@@ -433,7 +509,7 @@ public class App extends Application {
 
     private void registerTIMPush() {
         int sdkAppId = 0; // TODO: Replace with your SDKAppID.
-        String appKey = "你的客户端密钥"; // TODO: Replace with your Push Key.
+        String appKey = "您的客户端密钥"; // TODO: Replace with your Push Key.
 
         TIMPushManager.getInstance().registerPush(this, sdkAppId, appKey, new TIMPushCallback<Object>() {
             @Override
@@ -466,7 +542,7 @@ class App : Application() {
 
     private fun registerTIMPush() {
         val sdkAppId = 0 // TODO: Replace with your SDKAppID.
-        val appKey = "你的客户端密钥" // TODO: Replace with your Push Key.
+        val appKey = "您的客户端密钥" // TODO: Replace with your Push Key.
 
         TIMPushManager.getInstance().registerPush(this, sdkAppId, appKey, object : TIMPushCallback<Any?>() {
             override fun onSuccess(data: Any?) {
@@ -500,14 +576,21 @@ import android.util.Log;
 
 import com.tencent.imsdk.v2.V2TIMCallback;
 import com.tencent.imsdk.v2.V2TIMManager;
-import com.tencent.timpush.TIMPushCallback;
-import com.tencent.timpush.TIMPushManager;
+import com.tencent.imsdk.v2.V2TIMSDKConfig;
+import com.tencent.qcloud.tim.push.TIMPushCallback;
+import com.tencent.qcloud.tim.push.TIMPushManager;
 
 public void loginIMAndRegisterPush(Context context) {
     int sdkAppId = 0; // TODO: Replace with your SDKAppID.
     String userID = "<YOUR_USER_ID>";
     String userSig = "<YOUR_USER_SIG>";
 
+    boolean initSuccess = V2TIMManager.getInstance().initSDK(context, sdkAppId, new V2TIMSDKConfig());
+    if (!initSuccess) {
+        Log.e("TIMPush", ">>>>> IM SDK init failed");
+        return;
+    }
+
     V2TIMManager.getInstance().login(userID, userSig, new V2TIMCallback() {
         @Override
         public void onSuccess() {
@@ -539,17 +622,24 @@ import android.content.Context
 import android.util.Log
 import com.tencent.imsdk.v2.V2TIMCallback
 import com.tencent.imsdk.v2.V2TIMManager
-import com.tencent.timpush.TIMPushCallback
-import com.tencent.timpush.TIMPushManager
+import com.tencent.imsdk.v2.V2TIMSDKConfig
+import com.tencent.qcloud.tim.push.TIMPushCallback
+import com.tencent.qcloud.tim.push.TIMPushManager
 
 fun loginIMAndRegisterPush(context: Context) {
     val sdkAppId = 0 // TODO: Replace with your SDKAppID.
     val userID = "<YOUR_USER_ID>"
     val userSig = "<YOUR_USER_SIG>"
 
+    val initSuccess = V2TIMManager.getInstance().initSDK(context, sdkAppId, V2TIMSDKConfig())
+    if (!initSuccess) {
+        Log.e("TIMPush", ">>>>> IM SDK init failed")
+        return
+    }
+
     V2TIMManager.getInstance().login(userID, userSig, object : V2TIMCallback {
         override fun onSuccess() {
-            TIMPushManager.getInstance().registerPush(context, sdkAppId, null, object : TIMPushCallback<Any?>() {
+            TIMPushManager.getInstance().registerPush(context, sdkAppId, null, object : TIMPushCallback<Any>() {
                 override fun onSuccess(data: Any?) {
                     Log.d("TIMPush", ">>>>> registerPush success, data = $data")
                 }
@@ -567,6 +657,11 @@ fun loginIMAndRegisterPush(context: Context) {
 }
 ```
 
+   > **警告：**
+   >
+   > 如果您的业务仅使用即时通信 IM 聊天能力，请勿在 IM 登录前先调用 `registerPush`。否则 SDK 可能会按独立推送场景注册 Push 类型账号，并产生对应的 Push DAU。Push DAU 超出套餐额度后，可能会产生额外费用。
+   >
+
    **验证**：
 
 1. `registerPush` 的 `onSuccess` 回调被触发。
@@ -580,7 +675,6 @@ fun loginIMAndRegisterPush(context: Context) {
 如需自定义推送标识（如使用业务侧用户 ID），可在 `registerPush` 前调用 setRegistrationID。
 
 > **注意：**
->
 > 混用场景下，自定义 `registrationID` 必须与 IM 登录使用的 `userID` 完全一致，否则会产生账号互踢导致推送丢失。
 >
 
@@ -597,7 +691,6 @@ fun loginIMAndRegisterPush(context: Context) {
 |FCM|当前腾讯云快速接入文档说明 FCM 暂不支持推送统计功能。|
 
 > **注意：**
->
 > 回执地址不配置或配置错误，都会影响触达统计。
 >
 
@@ -620,7 +713,7 @@ fun loginIMAndRegisterPush(context: Context) {
 
 【REST API 发送】
 
-如果需要通过服务端发送推送，可参考 [REST API 接口 - 发起全员/标签推送](https://cloud.tencent.com/document/product/269/100634)。
+如果需要通过服务端发送推送，可参考 [全员/标签推送](https://cloud.tencent.com/document/product/269/100634)。
 
 【SDK API 发送】
 
@@ -658,7 +751,7 @@ V2TIMManager.getMessageManager().sendMessage(
 
 `sendMessage` 属于 IMSDK 消息发送能力。仅集成 TIMPush 的用户不需要为了验证离线推送而额外接入完整 Chat 初始化、登录和消息发送流程。
 
-   **验证**：App 置于后台后发送测试消息，设备能收到离线推送通知。如果手机通知栏开启权限，通知栏会弹出离线推送消息弹框。如果收不到，请参见下文「收不到推送排障流程」逐步排查。
+ **验证**：App 置于后台后发送测试消息，设备能收到离线推送通知。如果手机通知栏开启权限，通知栏会弹出离线推送消息弹框。如果收不到。
 
 ## 处理通知点击跳转
 
@@ -699,7 +792,7 @@ V2TIMManager.getMessageManager().sendMessage(
 
 通过 [V2TIMOfflinePushInfo](https://im.sdk.qcloud.com/doc/zh-cn/classcom_1_1tencent_1_1imsdk_1_1v2_1_1V2TIMOfflinePushInfo.html) 的 `ext` 属性携带跳转参数，再随消息一起发送。`setExt` 接收 `byte[]` 入参，业务自定义的 JSON 字符串需要先转成字节数组。
 
-如果你接入了 TUIKit，TUIKit 内置的消息发送链路会自动用 `OfflinePushExtInfo` 组装 `ext`，无需手动设置。下方示例适用于自行调用 IM SDK 发送消息的场景。
+如果您接入了 TUIKit，TUIKit 内置的消息发送链路会自动用 `OfflinePushExtInfo` 组装 `ext`，无需手动设置。下方示例适用于自行调用 IM SDK 发送消息的场景。
 
 【Java】
 ``` java
@@ -781,7 +874,7 @@ V2TIMManager.getMessageManager().sendMessage(
 
 请在 `Application.onCreate()` 中调用 addPushListener 注册 `TIMPushListener`，并在 onNotificationClicked 中解析 `ext` 后跳转到业务页面。
 
-以下示例只演示解析 `ext` 的核心逻辑，跳转部分用 `TODO` 占位，请按自身业务补充。如果你接入了 TUIKit 并使用 `OfflinePushExtInfo` 组装的 `ext`，可改为 `new Gson().fromJson(ext, OfflinePushExtInfo.class)` 解析后再跳转。
+以下示例只演示解析 `ext` 的核心逻辑，跳转部分用 `TODO` 占位，请按自身业务补充。如果您接入了 TUIKit 并使用 `OfflinePushExtInfo` 组装的 `ext`，可改为 `new Gson().fromJson(ext, OfflinePushExtInfo.class)` 解析后再跳转。
 
 【Java】
 ``` java
@@ -876,7 +969,6 @@ class App : Application() {
 **验证**：点击通知后 `onNotificationClicked` 被调用，且 `ext` 内容与发送时设置的一致。如果回调未触发，请检查：控制台点击动作是否选择了「打开应用内指定界面」并保持默认填充值、监听器是否在 `Application.onCreate()` 中注册、发送消息时是否设置了 `ext`。
 
 > **说明：**
->
 > 旧版本工程中可能仍使用 `TUICore.registerEvent` 回调或 `LocalBroadcastManager` 广播处理点击通知。这两种方式在当前版本仍可工作，但新接入用户建议优先使用 `addPushListener`。如需从旧方案迁移，删除旧的事件注册或广播注册代码，改为在 `Application.onCreate()` 中调用 `addPushListener` 即可，回调中获取到的 `ext` 内容与旧方案一致。
 >
 
@@ -885,7 +977,6 @@ class App : Application() {
 厂商离线通道通常有消息分类机制。消息分类会影响推送及时性、单设备每日接收数量、夜间展示、声音、横幅和厂商通道权限。
 
 > **注意：**
->
 > 只有 IM 聊天、订单、交易、账号变更等用户预期强、需要及时触达的消息，才建议申请或使用高优先级分类。营销、广告、活动、资讯类消息不应滥用高优分类，否则可能被厂商降级、限频或冻结权限。
 >
 
@@ -1008,7 +1099,7 @@ pushInfo.setAndroidOPPOChannelID("your_oppo_private_channel_id");
 - 华为/荣耀：测试包签名（debug 或 release）的 SHA-256 必须已在厂商控制台「项目设置 > 常规 > SHA 证书指纹」中添加，指纹不一致会报 `6003: certificate fingerprint error`。
 
 #### 步骤6：确认消息分类和厂商限制
-- 是否超出厂商单日推送限额（如 vivo 运营消息每日限制、小米公信消息限额）。
+- 是否超出厂商单日推送限额（例如 vivo 运营消息每日限制、小米公信消息限额）。
 
 - 是否在夜间发送（部分厂商运营消息夜间不下发）。
 

package/resource/knowledge/push/integration/donut.md

@@ -1,22 +1,15 @@
-## 前置条件
+## 前提条件
+1. 在 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/miniapp/intro/) 中开启推送服务，默认支持在线推送。
 
-### 1. 厂商配置
+2. 如果您需要使用离线推送，请先完成对应原生平台的推送前提配置：请参见 [iOS 前提条件](https://cloud.tencent.com/document/product/269/100627#.E5.89.8D.E6.8F.90.E6.9D.A1.E4.BB.B6) 和 [Android 前提条件](https://cloud.tencent.com/document/product/269/100626#.E5.89.8D.E6.8F.90.E6.9D.A1.E4.BB.B6)。
 
-> **说明：**
->
-> 在 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/miniapp/intro/) 中开启推送服务，默认支持在线推送。如果您需要使用离线推送，请您先完成厂商配置，具体操作方法可参见 厂商配置 > 微信小程序多端框架。
->
+3. 微信开发者工具版本需 ≥ 1.06.2410152，您可进入 [下载地址](https://developers.weixin.qq.com/miniprogram/dev/devtools/nightly.html) 进行版本下载。
 
-### 2. 微信开发者工具版本要求
-
-微信开发者工具版本需 ≥ 1.06.2410152，您可进入 [下载地址](https://developers.weixin.qq.com/miniprogram/dev/devtools/nightly.html) 进行版本下载。
-
-## 集成腾讯云消息推送服务
+## 操作步骤
 
 ### 步骤1: 推送插件配置
 
 > **说明：**
->
 > 在 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/nightly.html) 中开启推送服务，默认支持在线推送。
 >
 
@@ -37,7 +30,6 @@
 ### 步骤2: 离线推送配置
 
 > **说明：**
->
 > 如果只使用在线推送，则无需进行厂商离线推送配置。
 >
 
@@ -131,7 +123,6 @@
 当您准备好以上文件后，可以按照描述填入相关信息：
 
 > **说明：**
->
 > **NSE 相关配置详细描述如下：**
 >
 > - 开启 NSE：借助 iOS 10 Service Extension 特性统计消息抵达率 及设置 APNs 离线推送的通知图片。
@@ -146,7 +137,6 @@
 ### 集成 JS API
 
 > **说明：**
->
 > 如何使用 npm 请查阅[官方文档](https://developers.weixin.qq.com/miniprogram/dev/devtools/npm.html)，此处不再赘述。
 >
 
@@ -159,8 +149,6 @@
 
 ### 使用方法
 
-将 SDKAppID 和 appKey 替换为您在 [IM 控制台 > 推送服务 Push > 概览](https://console.cloud.tencent.com/im/push-plugin-push-identifier) 获取的应用的信息。如图所示：
-
 ``` javascript
 import Push from "@tencentcloud/donut-push"
 const sdkAppID = 0; // 您的 SDKAppID
@@ -252,10 +240,6 @@ App({
 
 需要修改 project.miniapp.json 文件才能重新构建远程基座 App，改一下应用的 version code 再进行构建即可。
 
-### **我可以从哪里查看推送服务 Push 的相关计费信息？**
-
-价格及购买相关问题，请参见 [推送服务计费说明](https://cloud.tencent.com/document/product/269/110762#Push)。
-
 ### **iOS 在控制台上测试工具显示“上传 token 无效，请检查”，怎么办？**
 
 需要您检查下上传的 p12证书是否为推送证书、且 Bundle ID 应该是与主 App 一致。

package/resource/knowledge/push/integration/flutter.md

@@ -4,10 +4,9 @@
 
 ## AI 集成
 
-通过 npm 安装 [@tencent-rtc/trtc-push-skill](https://www.npmjs.com/package/@tencent-rtc/trtc-push-skill/v/1.0.1#%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) 到本地 AI IDE 中，辅助完成 TIMPush 离线推送集成。安装后，你可以直接向 AI 输入“集成 Flutter 离线推送”“帮我集成 Flutter TIMPush”等需求，AI 将根据项目类型引导你完成环境检测、厂商通道配置、凭据填写、代码接入和验证等步骤。
+通过 npx 安装 [@tencent-rtc/trtc-push-skill](https://www.npmjs.com/package/@tencent-rtc/trtc-push-skill/v/1.0.1#%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) 到本地 AI IDE 中，辅助完成 TIMPush 离线推送集成。安装后，你可以直接向 AI 输入“集成 Flutter 离线推送”“帮我集成 Flutter TIMPush”等需求，AI 将根据项目类型引导你完成环境检测、厂商通道配置、凭据填写、代码接入和验证等步骤。
 
 > **注意：**
->
 > 使用 Push Skill AI 集成不是全自动流程，依然需要开发者在厂商配置控制台、腾讯云控制台等配置 Push 相关信息。具体的配置方法请参考下文相关章节。
 >
 
@@ -217,7 +216,7 @@ iOS 如需统计推送触达数据，请在 `registerPush` 时传入 `applicatio
 
 运行 App 后，过滤 `TIMPush` 关键字查看注册日志。注册成功后，调用 `getRegistrationID()` 获取当前设备推送标识。控制台或服务端发送测试消息时，可使用该值定位设备。
 
-测试流程请参考 [Android 测试推送](https://cloud.tencent.com/document/product/269/100626#.E6.B5.8B.E8.AF.95.E6.8E.A8.E9.80.81) 和 [iOS 测试推送](https://cloud.tencent.com/document/product/269/100627#.E6.B5.8B.E8.AF.95.E6.8E.A8.E9.80.81)文档。仅集成 TIMPush 的用户，建议优先使用腾讯云控制台接入测试能力验证离线推送。
+测试流程请参考 [Android 测试推送](https://cloud.tencent.com/document/product/269/100626#.E6.B5.8B.E8.AF.95.E6.8E.A8.E9.80.81) 和 [iOS 测试推送](https://cloud.tencent.com/document/product/269/100627#.E6.B5.8B.E8.AF.95.E6.8E.A8.E9.80.81) 文档。仅集成 TIMPush 的用户，建议优先使用腾讯云控制台接入测试能力验证离线推送。
 
 如果您的项目已接入 IM SDK，可通过 SDK API 发送一条带离线推送参数的消息进行验证。Flutter 侧示例如下：
 ``` java
@@ -345,7 +344,6 @@ Future<void> removeTIMPushListener() async {
 ```
 
 > **注意：**
->
 > - `TencentCloudChatPush().registerPush` 当前仍要求传入 `onNotificationClicked` 参数，但该参数待废弃。新接入业务请不要在 `registerPush` 的 `onNotificationClicked` 中处理跳转，统一使用 `addPushListener`。
 > - `ext` 是发送方写入的业务透传字段，建议使用 JSON 字符串，例如 `{"conversationID":"user_A","conversationType":1}`。
 > - 若 App 冷启动后需要立即处理点击事件，建议尽早注册 `listener`，例如在登录流程完成后、业务首页初始化前完成注册。
@@ -356,11 +354,11 @@ Future<void> removeTIMPushListener() async {
 
 ## 收不到推送排障流程
 
-### 步骤一 原生侧排查
+### 步骤1：原生侧排查
 
 如果发送测试消息后设备没有收到推送，请先按平台文档 [Android 收不到推送排障流程](https://cloud.tencent.com/document/product/269/100626#.E6.94.B6.E4.B8.8D.E5.88.B0.E6.8E.A8.E9.80.81.E6.8E.92.E9.9A.9C.E6.B5.81.E7.A8.8B) 和 [iOS 收不到推送排障流程](https://cloud.tencent.com/document/product/269/100627#.E6.94.B6.E4.B8.8D.E5.88.B0.E6.8E.A8.E9.80.81.E6.8E.92.E9.9A.9C.E6.B5.81.E7.A8.8B) 完成原生侧排查。
 
-### 步骤二 Flutter 侧可按以下顺序补充检查
+### 步骤2：Flutter 侧可按以下顺序补充检查
 1. 确认 `registerPush` 返回 `code = 0`。如果返回非 0，请先根据错误码和 `errorMessage` 排查，不要只看 App 是否启动成功。
 
 2. 注册成功后调用 `getRegistrationID()`，确认返回值非空。控制台或服务端发送测试消息时，使用的 `RegistrationID / userID` 应与这里返回的值一致。