145 lines
4.7 KiB
Markdown
145 lines
4.7 KiB
Markdown
# 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` 存在行尾状态提示；忽略行尾后无业务差异。
|