` 内。
**示例**：
```xml
```
**说明**：CocoaPods 上 JPush 官方 pod 的版本以 [CocoaPods JPush](https://cocoapods.org/pods/jpush) 为准。修改后执行 `cordova build ios` 或进入 `platforms/ios` 执行 `pod install` 即可拉取对应版本。
### 2. 更新 Android SDK 版本（Maven）
根据输入的版本号，在 `plugin.xml` 的 Android 平台下修改 `` 中的版本号。
**位置**：约第 252–253 行。
**示例**：
```xml
```
**说明**：依赖从 Maven Central 拉取，无需替换本地 jar。修改后执行 `cordova build android` 即可使用新版本。
### 3. 查找 SDK 新增 API
**⚠️ 重要：必须逐项查看更新日志，不要因为看到「更新各厂商 SDK」等描述就跳过新增 API 的检查。**
执行本步时按文末「文档内容获取方式」获取下方更新日志页面的内容，逐条阅读，不要仅依赖网页搜索。
#### Android SDK
- 访问 [极光推送 Android SDK 更新日志](https://docs.jiguang.cn/jpush/jpush_changelog/updates_Android) 查找目标版本的新增对外 API。
- **检查方法**：
1. 找到目标版本（如 5.9.0）的更新内容。
2. **逐条阅读**每一条，不要跳过。
3. 重点看包含「新增」「新增接口」「新增 API」「新增方法」或 Java 方法签名的条目。
4. 对每个疑似新增 API，记录：方法名、完整方法签名、功能说明。
- 在 [Android SDK API 文档](https://docs.jiguang.cn/jpush/client/Android/android_api) 中确认用法、参数和示例。
#### iOS SDK
- 访问 [极光推送 iOS SDK 更新说明](https://docs.jiguang.cn/jpush/jpush_changelog/updates_iOS) 查找目标版本的新增对外 API。
- **检查方法**：
1. 找到目标版本的更新内容。
2. **逐条阅读**每一条。
3. 重点看包含「新增」「新增接口」「新增 API」或 Objective-C 方法签名的条目。
4. 对每个疑似新增 API，记录：方法名、完整方法签名、功能说明。
- 在 [iOS SDK API 文档](https://docs.jiguang.cn/jpush/client/iOS/ios_api) 中确认用法、参数和示例。
**检查清单**（完成后勾选）：
- [ ] 已找到目标版本的更新日志
- [ ] 已逐条阅读所有更新内容（含次要更新）
- [ ] 已识别所有含「新增」「API」「接口」「方法」等的条目
- [ ] 已记录所有新增 API 的方法名和签名
- [ ] 已在对应平台 API 文档中确认每个新增 API 的用法
- [ ] 已区分「需在插件中封装的对外 API」与「仅内部实现、无需封装」的更新
**常见误区**：
- ❌ 看到「更新各厂商 SDK」就认为没有新增 API → ✅ 仍要逐条检查
- ❌ 只扫一眼主要更新 → ✅ 必须逐条检查
- ❌ 靠搜索判断有没有新增 API → ✅ 以官方更新日志为准
- ❌ 文档有缺字/错字时直接忽略 → ✅ 需到官方文档核实
### 4. 封装新增 API（如有）
**⚠️ 若无新增 API，需明确写「经检查，该版本无新增对外 API」，再跳过本步。**
若有新增 API，需在插件中封装：
- 在 `www/JPushPlugin.js` 中增加 JavaScript 接口
- 在 `src/android/JPushPlugin.java` 中实现 Android 逻辑
- 在 `src/ios/Plugins/JPushPlugin.m` 或 `AppDelegate+JPush.m` 中实现 iOS 逻辑
**封装原则**：
- Android 与 iOS 为同一功能时，封装为一个插件方法
- 不同功能分别封装
- **直接调用 SDK API，不要用反射**
- 若无新增 API，**必须写明「已检查并确认无新增 API」后跳过**
**封装步骤**：
1. 确认 API 的完整签名与参数类型
2. 确认调用时机（是否需在 init 之前调用）
3. 在对应平台实现
4. 在 JS 层增加方法，风格与现有 API 一致
5. 补充必要的错误处理与日志
### 5. 更新 API 文档
若新增了插件方法，需更新文档：
- `doc/Common_detail_api.md`：通用或跨平台方法
- `doc/Android_detail_api.md`：仅 Android 方法
- `doc/iOS_API.md`：仅 iOS 方法
若无新增方法，跳过此步。
### 6. 在 example/index.html 中添加示例（若有新增 API）
**若有新增插件方法**，需在示例工程中增加可操作示例，便于开发者验证与参考：
- 在 `example/index.html` 中为每个新增 API 增加：
1. **按钮**：在合适位置的 `` 中增加 ``（id 与 API 含义对应）。
2. **点击逻辑**：在 `initiateUI` 内用 `$("#xxx").click(...)` 调用 `window.JPush.新方法(...)`，在回调中用 `alert` 或 `$("#某结果区").html(...)` 展示结果。
3. 若有结果展示，可复用已有结果区域或新增 `