tysdk-intergration/docs/enjoypay-change-summary.md

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

改动：

"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 存在行尾状态提示；忽略行尾后无业务差异。