update:enjoy-pay 接入

docs/enjoypay-change-summary.md

@@ -0,0 +1,144 @@
+# EnjoyPay 本次接入改动记录
+
+## 本次目标
+
+为 Android 测试工程增加 EnjoyPay 渠道切换与打包配置，使 Unity 菜单可以切换到 EnjoyPay 并使用俄罗斯包参数进行打包测试。
+
+## 参数来源
+
+- wiki MCP 文档：
+  - `https://wiki.bamboogames.top/doc/5oqa5pyv5rkf6yca-dF8FesCMt3`
+  - `https://wiki.bamboogames.top/doc/sdk-PiMyYd30k5`
+- PDF 参数文档：
+  - `D:/.devup/【128-FishingTravel】【Google俄罗斯】接入支持.pdf`
+- Firebase 配置：
+  - `D:/.devup/google-services (1).json`
+  - `D:/.devup/google-services (2).json`
+
+两份 `google-services` 文件经 `fc` 对比完全一致，已使用其中一份作为 EnjoyPay 渠道配置。
+
+## 已确认参数
+
+- 渠道名：`EnjoyPay`
+- Android 包名：`com.arkgame.ft.ep`
+- 客户端支付类型：`enjoypay.global.h5.web`
+- clientId：`Android_5.00_tyGuest,facebook.googleplay.0-hall20587.googleplay.FishingMasterRussia`
+- Firebase project id：`fishing-travel-ep-1ab1e`
+- Firebase package name：`com.arkgame.ft.ep`
+
+## 代码改动
+
+### 1. 增加 EnjoyPay 切渠道入口
+
+文件：
+
+- `sdk-intergration/Assets/Editor/ChannelBuildTool.cs`
+
+改动：
+
+- `SupportedChannels` 增加 `EnjoyPay`。
+- 增加菜单 `Tools/Switch Channel/EnjoyPay`。
+- 增加菜单 `Tools/Build Android (Channel)/EnjoyPay`。
+- 增加菜单 `Tools/Build Android (Channel)/EnjoyPay Debug`。
+- `SwitchChannel("EnjoyPay")` 设置 Android bundle id 为 `com.arkgame.ft.ep`。
+
+### 2. 增加 EnjoyPay 支付类型映射
+
+文件：
+
+- `sdk-intergration/Packages/tysdk/Runtime/ChannelConfig.cs`
+
+改动：
+
+```csharp
+"EnjoyPay" => "enjoypay.global.h5.web",
+```
+
+说明：
+
+- 客户端传给 SDK 的 `paytype` 使用 `enjoypay.global.h5.web`。
+- PDF 中的 `enj` 是后台支付方式配置类型，不作为客户端 `paytype`。
+
+### 3. 增加 EnjoyPay 渠道配置目录
+
+目录：
+
+- `ExtraPluginCfgs/Android/enjoypay`
+
+包含：
+
+- `AndroidManifest.xml`
+- `ChannelEntry.java`
+- `ConfigManager.java`
+- `launcherTemplate.gradle`
+- `mainTemplate.gradle`
+- `settingsTemplate.gradle`
+- `gradleTemplate.properties`
+- `Files/google-services.json`
+- `Plugins/Android/tuyoosdk_1.0.0.aar`
+
+关键配置：
+
+- `AndroidManifest.xml`
+  - package：`com.arkgame.ft.ep`
+  - `CHANNEL = EnjoyPay`
+- `ChannelEntry.java`
+  - `CHANNEL = "EnjoyPay"`
+  - 不创建专用 adapter，继续走默认 Tuyoo SDK 流程。
+- `ConfigManager.java`
+  - `SDK_CLIENTID = "Android_5.00_tyGuest,facebook.googleplay.0-hall20587.googleplay.FishingMasterRussia"`
+- `Files/google-services.json`
+  - 来自 `D:/.devup/google-services (1).json`
+  - package name：`com.arkgame.ft.ep`
+
+### 4. Firebase / Gradle 配置核对
+
+Unity Gradle 模板对应关系：
+
+- 项目级 Gradle：
+  - `sdk-intergration/Assets/Plugins/Android/baseProjectTemplate.gradle`
+  - 当前已有 `com.google.gms.google-services` 插件版本声明。
+- 应用模块 Gradle：
+  - `ExtraPluginCfgs/Android/enjoypay/launcherTemplate.gradle`
+  - 当前已应用 `com.google.gms.google-services` 插件。
+- UnityLibrary 模块 Gradle：
+  - `ExtraPluginCfgs/Android/enjoypay/mainTemplate.gradle`
+  - 当前包含 Firebase Analytics 依赖。
+
+## 未改动 / 延后项
+
+- 当前测试工程不新增 EnjoyPay 商品列表逻辑。
+- 正式项目接入时，再从正式项目本地 json table / 商品表构造 SKU。
+- 当前不新增 EnjoyPay 专用 Billing adapter。
+- 当前不复用 Flexion / RuStore 的 pending、consume、receipt 验签逻辑。
+- 后台支付方式无需本次配置。
+
+## 打包前检查
+
+在 Unity 执行 `Tools/Switch Channel/EnjoyPay` 后，检查：
+
+1. `sdk-intergration/Packages/tysdk/Plugins/Android/ChannelEntry.java`
+   - `CHANNEL = "EnjoyPay"`
+2. `sdk-intergration/Packages/tysdk/Plugins/Android/ConfigManager.java`
+   - `SDK_CLIENTID` 为俄罗斯包 clientId。
+3. `sdk-intergration/Assets/Plugins/Android/AndroidManifest.xml`
+   - package 为 `com.arkgame.ft.ep`
+   - `CHANNEL = EnjoyPay`
+4. `sdk-intergration/Packages/tysdk/Files/google-services.json`
+   - package name 为 `com.arkgame.ft.ep`
+5. `sdk-intergration/Packages/tysdk/Plugins/Android/tuyoosdk_1.0.0.aar`
+   - 应同步为 EnjoyPay 目录中的新版 AAR。
+
+## 打包步骤
+
+1. 打开 Unity 工程：`sdk-intergration`
+2. 执行菜单：`Tools/Switch Channel/EnjoyPay`
+3. 执行菜单：`Tools/Build Android (Channel)/EnjoyPay Debug`
+4. 安装生成的 APK。
+5. 验证初始化、登录、支付拉起和 SDK 回调。
+
+## 已知注意点
+
+- `google-services.json` 的 package name 是 `com.arkgame.ft.ep`，所以 EnjoyPay 包名必须与其一致。
+- 已删除历史脚本 `ExtraPluginCfgs/Android/switch-channel.sh`，正式入口是 Unity 菜单中的 `ChannelBuildTool.SwitchChannel`。
+- 当前仓库内 `SDKTest.cs` 存在行尾状态提示；忽略行尾后无业务差异。