@tencentcloud/sdk-mcp 1.6.7 → 1.6.8

package/resource/knowledge/push/config/unreal-engine.md

@@ -1,7 +1,6 @@
 推送服务目前推送支持小米、华为、荣耀、OPPO、vivo、魅族、一加、realme、iQOO 、FCM 和 Apple 等厂商通道。
 
 > **注意：**
->
 > 每个厂商仅支持配置 1 个证书。
 >
 
@@ -28,7 +27,6 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 确认并生成密钥：在确认页面核对您的密钥信息，然后单击 **Register** 。接下来，您将看到一个页面提示您下载密钥。单击 **Download**，将生成的 .p8 文件保存到您的计算机上。
 
 > **说明：**
->
 > - p8 证书只可以下载一次，请妥善保存。
 > - 请妥善保管下载的 p8 文件，因为您将无法再次下载该文件。您可以使用此 p8 证书配置您的 iOS 应用程序以接收推送通知。
 
@@ -42,7 +40,6 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 4. 选择 .p8 证书
 
 > **说明：**
->
 > - **Key ID**：这是您的 APNs Auth Key 的唯一标识符。当您在 Apple Developer Center 创建一个新的 APNs Auth Key 时，系统会为您生成一个 Key ID。您可以在 "Certificates, Identifiers & Profiles" 部分的 "Keys" 中找到它。
 > - **Team ID**：这是您的开发者账户的唯一标识符。您可以在 Apple Developer Center 的账户详情页面找到它。点击右上角的 "Membership"，在 "Membership Details" 部分可以找到您的 Team ID。
 > - **Bundle ID**：这是您的应用程序的唯一标识符，也称为应用程序 ID。您可以在 Apple Developer Center 的 "Certificates, Identifiers & Profiles" 部分找到它。选择 "Identifiers"，然后在您的应用程序列表中找到对应的 Bundle ID。
@@ -74,8 +71,6 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 #### 生成证书
 1. 选中您的 AppID，选择 **Configure**。
 
-2. 可以看到在 **Apple Push Notification service SSL Certificates** 窗口中有两个 `SSL Certificate`，分别用于开发环境（Development）和生产环境（Production）的远程推送证书，如下图所示：
-
 3. 我们先选择开发环境（Development）的 **Create Certificate**，系统将提示我们需要一个 Certificate Signing Request（CSR）。
 
 4. 在 Mac 上打开**钥匙串访问工具（Keychain Access）**，在菜单中选择**钥匙串访问** > **证书助理** > **从证书颁发机构请求证书**（`Keychain Access - Certificate Assistant - Request a Certificate From a Certificate Authority`）。
@@ -114,7 +109,6 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 4. 选择证书类型，上传 iOS 证书（.p12），设置证书密码，单击**确认**。
 
 > **说明：**
->
 > - 上传证书名最好使用全英文（尤其不能使用括号等特殊字符）。
 > - 上传证书需要设置密码，无密码收不到推送。
 > - 发布 App Store 的证书需要设置为生产环境，否则无法收到推送。
@@ -139,7 +133,6 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc) ，在**推送服务 Push > 推送设置 > 厂商配置**功能栏添加各个厂商推送证书，并将您在步骤一中获取的各厂商的 AppId、AppKey、AppSecret 等参数配置给添加的推送证书。
 
 > **注意：**
->
 > 关于**点击后续动作**选项, 如需使用本插件提供的点击跳转能力, 请保持默认值不变, 即通常是 `打开应用内指定页面` 并带有默认配置.
 >
 > 如需使用上报统计功能, 也请保持此项默认值不变,
@@ -147,10 +140,6 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 
 【小米】
 
-|厂商推送平台|IM 控制台配置|
-|---------|---------|
-|||
-
 【华为】
 | 厂商推送平台 | IM 控制台配置 |
 | --- | --- |
@@ -158,34 +147,14 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 
 【OPPO】
 
-|厂商推送平台|IM 控制台配置|
-|---------|---------|
-|||
-
 【vivo】
 
-|厂商推送平台|IM 控制台配置|
-|---------|---------|
-|||
-
 回执配置请参考：[消息触达统计配置-vivo](https://cloud.tencent.com/document/product/269/100626#daa658b0-1ac0-44a8-8a47-7ec8822ebe82)
 
 【魅族】
 
-|厂商推送平台|IM 控制台配置|
-|---------|---------|
-|||
-
 回执配置请参考：[消息触达统计配置 > 魅族](https://cloud.tencent.com/document/product/269/100626#daa658b0-1ac0-44a8-8a47-7ec8822ebe82)
 
 【荣耀】
 
-|厂商推送平台|IM 控制台配置|
-|---------|---------|
-|||
-
 【Google FCM】
-
-|厂商推送平台|IM 控制台配置|
-|---------|---------|
-|||

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

@@ -19,10 +19,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 输入“集成 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 相关信息。具体的配置方法请参考下文相关章节。
 >
 
@@ -32,12 +31,9 @@
 
 ### 下载并添加 TIMPush 配置文件
 
-完成厂商配置后，在腾讯云控制台下载 `timpush-configs.json`，下载路径为：
-
 下载后，将该文件添加到应用模块的 `assets` 目录。推荐存储路径：`app/src/main/assets/timpush-configs.json`，其中 app 是你项目的应用模块，可替换成实际名称。如果工程中没有 `assets` 目录，请在 `src/main/` 下手动创建。
 
 > **注意：**
->
 > TIMPush 注册推送时会读取该文件中的厂商证书配置，不要放在 MainActivity 同级目录、工程根目录或 res 目录。如果文件缺失或放错目录，SDK 无法获得对应厂商通道配置，可能导致注册或收消息失败。
 >
 
@@ -57,7 +53,6 @@ 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/") }
@@ -136,9 +132,10 @@ dependencyResolutionManagement {
 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 {
@@ -174,6 +171,7 @@ Gradle 7.0 以下版本通常使用 Groovy DSL。如你的工程使用 Kotlin DS
 ``` 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）】
 
@@ -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 置于后台后发送测试消息，设备能收到离线推送通知。如果手机通知栏开启权限，通知栏会弹出离线推送消息弹框。如果收不到。
 
 ## 处理通知点击跳转
 
@@ -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 聊天、订单、交易、账号变更等用户预期强、需要及时触达的消息，才建议申请或使用高优先级分类。营销、广告、活动、资讯类消息不应滥用高优分类，否则可能被厂商降级、限频或冻结权限。
 >
 

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 相关信息。具体的配置方法请参考下文相关章节。
 >
 
@@ -345,7 +344,6 @@ Future<void> removeTIMPushListener() async {
 ```
 
 > **注意：**
->
 > - `TencentCloudChatPush().registerPush` 当前仍要求传入 `onNotificationClicked` 参数，但该参数待废弃。新接入业务请不要在 `registerPush` 的 `onNotificationClicked` 中处理跳转，统一使用 `addPushListener`。
 > - `ext` 是发送方写入的业务透传字段，建议使用 JSON 字符串，例如 `{"conversationID":"user_A","conversationType":1}`。
 > - 若 App 冷启动后需要立即处理点击事件，建议尽早注册 `listener`，例如在登录流程完成后、业务首页初始化前完成注册。

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

@@ -1,8 +1,22 @@
+## 前提条件
+
+请确认已 开通 Push 服务 并完成 厂商配置，获取到了下列信息：
+
+|资源|获取位置|用途|
+|---------|---------|---------|
+|`SDKAppID`|腾讯云控制台 > 即时通信 IM > **推送服务 Push** > **概览**|调用 `registerPush`。创建 Push 应用后，腾讯云控制台会自动创建相同 `SDKAppID` 的 Chat 应用。|
+|Push Key|腾讯云控制台 > 即时通信 IM > **推送服务 Push** > **概览** > **客户端密钥**|独立 Push 场景下，作为 `registerPush` 的 `appKey` 参数。|
+|Chat Key|腾讯云控制台 > 即时通信 IM > **消息服务 Chat** > **概览** > **密钥**|Chat 登录使用。不要把 Chat Key 当作 `registerPush` 的 `appKey` 传入。|
+|Push 服务开通状态|腾讯云控制台 > 即时通信 IM > **推送服务 Push** > **概览**|创建 Push 应用不等于已开通 Push 服务，请确认 Push 服务已开通。|
+|TIMPush iOS `VERSION`|更新日志|`VERSION` 是 Podfile 中 TIMPush 依赖的版本号占位符，例如 `8.9.7537`、`8.8.7357`、`8.7.7201` 等，请以实际接入版本为准。|
+
+本文示例中的 `VERSION`、`SDKAppID`、`AppKey`、`businessID`、App Group ID 均为占位符，请勿在代码仓库中提交真实密钥。
+
 ## 操作步骤
 
 ### 步骤1：集成 TIMPush
 
-完成 [厂商配置](https://cloud.tencent.com/document/product/269/108856) 后，集成 SDK：
+集成 SDK：
 ``` java
 // 版本号 “VERSION” 请前往  中获取配置。
 // oh-package.json5 中配置集成包
@@ -15,13 +29,6 @@ dependencies: {
 ### 步骤2：注册推送
 
 调用接口推送注册成功后，就可以收到离线推送通知了。
-
-> **说明：**
->
-> 注册接口必填参数 SDKAppID 和客户端密钥 AppKey 的获取路径是 [IM 控制台 > 推送服务 Push > 概览](https://console.cloud.tencent.com/im/push-plugin-push-identifier)，如下图所示：
->
->
-
 ``` java
 import { TIMPushListener, TIMPushManager, TIMPushMessage } from '@tencentcloud/timpush';
 
@@ -43,14 +50,13 @@ TIMPushManager.getInstance()
 
 ### 步骤4：发送推送消息
 
-您可以在 [控制台 > 接入测试](https://console.cloud.tencent.com/im/push-plugin-push-check) 指定 `RegistrationID/userID` 进行离线推送测试。REST API 接口详细说明可参见：[REST API 接口 > 发起全员/标签推送](https://cloud.tencent.com/document/product/269/100634)。
+您可以在 [接入测试](https://console.cloud.tencent.com/im/push-plugin-push-check) 指定 `RegistrationID/userID` 进行离线推送测试。REST API 接口详细说明可参见：[全员/标签推送](https://cloud.tencent.com/document/product/269/100634)。
 
 ### 步骤5：解析离线推送消息
 
 收到推送消息后点击通知栏，组件会回调该点击事件和透传离线消息。
 
 > **注意：**
->
 > 1. 注册回调时机必须放在应用 [UIAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/uiability-lifecycle) 的 onCreate() 函数中。
 > 2. 控制台配置点击后续动作按如下配置，选择**打开应用内指定界面**，请勿修改默认值。
 >
@@ -65,9 +71,4 @@ let pushListener: TIMPushListener = {
 TIMPushManager.getInstance().addPushListener(pushListener);
 ```
 
-恭喜您已经完成了推送插件的接入，需要提醒您：推送插件**试用或购买到期后，将自动停止提供推送服务（包括普通消息离线推送、全员/标签推送等服务）**。为避免影响您业务正常使用，请提前 [购买](https://buy.cloud.tencent.com/avc)/[续费](https://console.cloud.tencent.com/account/renewal)。
-
-> **说明：**
->
-> - 接入完成收不到推送，请先自助使用 [排查工具](https://cloud.tencent.com/document/product/269/100629) 查看下具体原因。推送指标数据查看，请使用 [数据统计](https://cloud.tencent.com/document/product/269/100628) 查询。
-> - 全员/标签推送功能请参见：[REST API 接口 - 发起全员/标签推送](https://cloud.tencent.com/document/product/269/100634)。
+恭喜您已经完成了推送插件的接入。如果接入完成收不到推送，请使用 [排查工具](https://cloud.tencent.com/document/product/269/100629) 查看具体原因。