Merge pull request #23 from BlackishGreen33/bg/upstream-chore-release-prepare-1-2-5

chore(release): prepare 1.2.5

Author: konodioda727

CHANGELOG.md

@@ -2,6 +2,14 @@
 
 历史版本更新从 README 中拆出，便于首页专注接入说明与使用导航。
 
+## v1.2.5 (2026-04-15)
+
+- Android `manifestPlaceholders` 改为在宿主现有配置后追加，保留非冲突的已有键
+- Android `app/build.gradle` 注入不再依赖 `versionName` 文本锚点
+- iOS `AppDelegate.swift` 中的 JPush 调试日志仅在 `DEBUG` 构建启用
+- 移除插件内部的历史全局配置 helper，并对齐 `createRunOncePlugin` 版本元数据
+- 更新 prebuild、测试与本地发布流程文档
+
 ## v1.2.4 (2026-03-27)
 
 - 修复 `app.config.js` 配置不生效的问题

DEVELOPMENT.md

@@ -84,7 +84,7 @@ npm run lint
 - `utils.test.ts`：生成区段与源码定位 helper 的幂等/回收测试
 - `androidTransforms.test.ts`：Android 纯转换函数与 vendor 开关回收测试
 - `iosTransforms.test.ts`：`Info.plist`、`AppDelegate`、Bridging Header 的纯转换测试
-- `nativeAndroidMods.test.ts` / `nativeIos*.test.ts`：fixture 项目上的原生回归测试
+- `nativeAndroidMods.test.ts` / `nativeIos*.test.ts`：fixture 项目上的原生回归测试，覆盖真实 `compileModsAsync` 路径
 
 ### 4. 清理
 
@@ -249,19 +249,28 @@ describe('withMyPlugin', () => {
 这种方式的价值在于：
 
 - 能覆盖正则锚点与模板兼容性
+- 能覆盖宿主已有 `manifestPlaceholders`、缺少 `versionName`、非字面量 `versionName` 等真实 Gradle 边界场景
 - 能验证重复执行时的幂等行为
 - 比只检查 helper 返回值更接近真实 `expo prebuild`
 
 ## 发布流程
 
-### 1. 更新版本
+发布由独立 release PR 负责，不在发布机器上额外执行 `npm version patch`。推荐流程如下：
 
 ```bash
-npm version patch  # 1.0.2 -> 1.0.3
-npm version minor  # 1.0.2 -> 1.1.0
-npm version major  # 1.0.2 -> 2.0.0
+git switch main
+git pull --ff-only
 ```
 
+### 1. 准备 release PR
+
+- 先通过拆分 commit / 堆叠 PR 合入功能改动
+- 在 release PR 中统一更新：
+  - `package.json`
+  - `plugin/src/index.ts`
+  - `app.plugin.js`
+  - `CHANGELOG.md`
+
 ### 2. 构建
 
 ```bash
@@ -275,12 +284,27 @@ npm test -- --runInBand
 npm run lint
 ```
 
-### 4. 发布
+### 4. 检查发布包
+
+```bash
+npm pack
+```
+
+### 5. 发布
 
 ```bash
 npm publish
 ```
 
+### 6. 打 tag
+
+只有 `npm publish` 成功后，才在同一提交上补 tag：
+
+```bash
+git tag v1.2.5
+git push origin v1.2.5
+```
+
 ## 常见问题
 
 ### Q: 为什么使用 TypeScript？

README.md

@@ -172,6 +172,7 @@ export default ({ config }: ConfigContext): ExpoConfig => {
 - Android `manifestPlaceholders` 优先读取环境变量或 `gradle.properties`，缺失时会回退到插件配置里的 `appKey` / `channel` / `packageName`
 - 如果宿主已经定义了 `manifestPlaceholders`，插件会通过 `manifestPlaceholders += [...]` 追加 JPush 字段
   非 JPush 的宿主键会被保留；如果宿主和插件都声明了同名的 `JPUSH_*` 键，后追加的 JPush 默认值会生效
+- Android `app/build.gradle` 注入不再依赖 `versionName` 所在行；缺少 `versionName` 或使用 Gradle 变量时也能稳定 `prebuild`
 - `vendorChannels` 决定要注入哪些厂商 SDK 与占位符；若声明某个厂商通道，就必须提供该厂商要求的必填字段
 - 厂商密钥仍然建议交给环境变量，避免把敏感信息直接提交到仓库
 
@@ -350,10 +351,8 @@ mx-jpush-expo/
 │   │   │   └── gradleProperties.ts
 │   │   └── utils/
 │   │       ├── codeValidator.ts
-│   │       ├── config.ts
 │   │       ├── generateCode.ts
-│   │       ├── sourceCode.ts
-│   │       └── vendorChannels.ts
+│   │       └── sourceCode.ts
 │   ├── __tests__/
 │   │   ├── fixtures/
 │   │   ├── iosFixture.ts
@@ -375,6 +374,8 @@ mx-jpush-expo/
 - iOS `UIBackgroundModes` 改为合并写入，不再覆盖宿主已有后台模式
 - Swift `Bridging Header` 支持优先复用、缺失自动创建，并保持幂等
 - 补齐 iOS / Android fixture-based 原生回归测试
+- Android `manifestPlaceholders` 改为在宿主现有配置后追加，不再依赖 `versionName` 文本锚点
+- iOS `AppDelegate.swift` 中的 JPush 调试日志只在 `DEBUG` 构建启用
 - 加入 ESLint 与 CI 质量闭环
 - 对齐 Expo SDK 53 的版本声明与仓库开发基线
 - Android 敏感参数支持环境变量 / `gradle.properties` 读取，不再明文写入构建脚本

app.plugin.js

@@ -5,7 +5,7 @@
  * 支持 Expo SDK 53+ 和 React Native 0.79.5+
  * 
  * @author MuxiStudio
- * @version 1.2.4
+ * @version 1.2.5
  * 
  * 参考文档：
  * - JPush 集成 Expo: https://juejin.cn/post/7423235127716659239

package.json

@@ -1,6 +1,6 @@
 {
   "name": "mx-jpush-expo",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "description": "Expo 集成极光推送（JPush）一体化解决方案，支持 iOS/Android 厂商通道",
   "main": "app.plugin.js",
   "types": "plugin/build/index.d.ts",

plugin/src/index.ts

@@ -5,7 +5,7 @@
  * 支持 Expo SDK 53+ 和 React Native 0.79.5+
  * 
  * @author MuxiStudio
- * @version 1.2.4
+ * @version 1.2.5
  * 
  * 参考文档：
  * - JPush 集成 Expo: https://juejin.cn/post/7423235127716659239
@@ -80,4 +80,4 @@ const withJPush: ConfigPlugin<JPushPluginProps> = (config, props) => {
 /**
  * 导出插件（使用 createRunOncePlugin 确保插件只运行一次）
  */
-export default createRunOncePlugin(withJPush, 'mx-jpush-expo', '1.2.4');
+export default createRunOncePlugin(withJPush, 'mx-jpush-expo', '1.2.5');