2026-11-02 02:40:32 +07:00
|
|
|
# GaCy Android
|
|
|
|
|
|
2026-11-02 03:10:06 +07:00
|
|
|
[ภาษาไทย](../README.md) | [English](./README_EN.md) | 简体中文
|
|
|
|
|
|
|
|
|
|
|
2026-11-02 02:40:32 +07:00
|
|
|
|
|
|
|
|
GaCy Android 是 GaC-hkrpg-go
|
|
|
|
|
的 Android 辅助应用和本地服务器管理器。移植仍在进行中：应用可通过前台服务启动
|
|
|
|
|
Go SDK 和游戏服务器，也可连接已有的远程服务器。
|
|
|
|
|
|
|
|
|
|
## 当前状态
|
|
|
|
|
|
|
|
|
|
- 已在实体手机上测试 ARM64 调试版：用户确认可以登录游戏、使用游戏内地图传送，
|
|
|
|
|
以及在更新后重新启动服务器。
|
|
|
|
|
- Go SDK、共享数据、游戏服务器和 KCP 测试已通过；这不代表所有游戏功能均已在
|
|
|
|
|
Android 客户端验证。
|
|
|
|
|
- 旧版 ppSR 的角色设置尚未接入 Go 运行时。Go 命令 API 尚不支持 `/give` 和 `/heal`。
|
|
|
|
|
|
|
|
|
|
## 功能
|
|
|
|
|
|
|
|
|
|
- 启动、停止和重启本地服务器；连接远程服务器并监控 SDK 健康状态。
|
|
|
|
|
- 查看和复制服务器日志、发送 GM 命令，以及打开 SRTool 网页。
|
|
|
|
|
- 使用游戏内地图传送；应用导航中没有单独的传送页面。
|
|
|
|
|
- 提交 Unstuck 请求。只有服务器返回请求 ID 时，应用才显示请求已排队；
|
|
|
|
|
这不表示游戏已经处理成功。
|
|
|
|
|
- 在设置中配置主机和端口，并显示应用的实际版本。
|
|
|
|
|
|
|
|
|
|
`/max` 修改角色等级、晋阶和星魂，同时保留存档的其他字段。
|
|
|
|
|
`/teleport <plane_id> [floor_id]` 保存下次连接时使用的场景。
|
|
|
|
|
两者已通过自动测试，但尚未在游戏内验证。由于当前队伍不能为空，
|
|
|
|
|
`/clear lineup` 会被拒绝。
|
|
|
|
|
|
|
|
|
|
## 构建
|
|
|
|
|
|
|
|
|
|
需要 Android SDK 35、JDK 17 或 21、Go、Python，以及本地 GaC-hkrpg-go 源码。
|
|
|
|
|
应用最低支持 Android 8.0（API 26）；普通调试版本面向 ARM64。
|
|
|
|
|
|
|
|
|
|
```powershell
|
|
|
|
|
python tools/package_go_runtime.py <path-to-GaC-hkrpg-go>
|
|
|
|
|
.\gradlew.bat testDebugUnitTest assembleDebug
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
打包脚本使用当前 Go 源码和资源，并从已提交的默认文件初始化玩家数据。
|
|
|
|
|
APK 输出至 `app/build/outputs/apk/debug/app-debug.apk`，同时复制到项目根目录，
|
|
|
|
|
文件名为 `GaCy-Android-<versionName>-debug.apk`。APK 已被 Git 忽略。
|
|
|
|
|
|
|
|
|
|
如果使用 x86_64 模拟器，请在打包时添加 `--emulator`，并在 Gradle 命令中添加
|
|
|
|
|
`-PgacyEmulator`。模拟器测试程序不包含在普通 ARM64 构建中。
|
|
|
|
|
|
|
|
|
|
## 运行时与网络配置
|
|
|
|
|
|
|
|
|
|
Go 运行时数据保存在应用私有目录 `files/gacy-go`，与旧版 ppSR 数据分开。
|
|
|
|
|
更新时保留玩家数据和已有 hotfix 条目，同时加入新版本。若之前查询失败留下完全为空的
|
|
|
|
|
缓存条目，SDK 会优先使用可用的内置 hotfix 数据。
|
|
|
|
|
|
|
|
|
|
在设置中将 Host 填为游戏客户端连接手机所使用的地址；两者在同一台设备上运行时可使用
|
|
|
|
|
`127.0.0.1`。按需配置 SDK 和游戏端口，修改后重启服务器生效。游戏客户端的 dispatch
|
|
|
|
|
流量重定向仍需单独设置。连接测试使用当前输入的值；远程模式在 SDK 健康检查连续三次
|
|
|
|
|
失败后报告错误。
|
