Robonix Android Client

Robonix 的 Android 手机客户端：和机器人对话、下发任务，查看感知画面、RTDL 计划、音频和硬件健康状态。

下载安装

1. 打开 最新 Release，下载 robonix-client-android-v*.apk。
2. 在手机上打开 APK。系统提示时，允许浏览器或文件管理器「安装未知来源应用」。
3. 首次打开时允许麦克风、相机和通知权限。语音对话需要麦克风权限。

要求 Android 8.0（API 26）及以上。历史版本在 Releases 页面。

升级时直接安装新版本 APK 即可，设置和本机保存的会话会保留。如果提示「签名不一致」或「与现有软件包冲突」，说明旧版本是用别的签名装的，需要先卸载（会清掉本机数据）再安装。

连接机器人

1. 手机和机器人连到同一个局域网（同一 WiFi）。
2. 进入「设置 → 连接」，在「机器人地址」填机器人的 IP。「Atlas 端口」默认 50051，一般不用改。
3. 点「连接」。Liaison、Executor 等其他服务的地址由 Atlas 自动发现，不需要手填。

连不上时，先确认机器人上的 Atlas 已经启动，并且手机能 ping 通机器人的 IP。

功能页面

页面	用途
对话	文字或语音和机器人对话、下发与干预任务
感知	相机、深度等感知画面
RTDL	查看当前执行的计划和步骤
音频	选择麦克风、扬声器、ASR/TTS 节点
健康	硬件健康状态和 3D 部件视图
设置	连接地址、语言、开发者日志等

反馈问题时，可在「设置 → 开发者日志」中复制日志一起附上。

从源码构建

只想使用的话不需要构建，直接下载 Release 即可。开发需要：

• JDK 17
• Android SDK（compileSdk 34），或 Android Studio Hedgehog (2023.1.1) 及以上
• Windows 上可以运行 .\setup.ps1 一键安装 JDK 和 SDK

./gradlew assembleDebug     # 输出 app/build/outputs/apk/debug/app-debug.apk
./gradlew assembleRelease   # 输出 app/build/outputs/apk/release/app-release.apk

.proto 文件在构建时由 protobuf 插件自动编译。首次构建要下载较多依赖，耗时会比较长。

Release 签名

至今发布的 APK 都用 Android debug 密钥签名，证书为 CN=Android Debug，SHA-256 为 0b1526ce8624baaef38db8459ddb7cf6a5378d103e68037e65f8ea89b0650c50。换成其它密钥会让已安装的手机拒绝覆盖升级， 因此发布流程固定校验这个指纹。debug 密钥的密码是公开的 android，所以这不是防篡改的签名，Google Play 也不接受； 将来换正式密钥需要单独规划一个版本，并提示用户卸载重装。

签名配置放在 keystore/release.properties，这个文件不进仓库：

storeFile=keystore/release.jks
storePassword=android
keyAlias=androiddebugkey
keyPassword=android

keystore/release.jks 就是 ~/.android/debug.keystore 的副本。没有这两个文件时，assembleRelease 会回落到 Gradle 自己的 debug 签名配置，本机验证够用，但不要拿这种包发布。

发布新版本

1. 修改 app/build.gradle.kts 中的 versionCode（加 1）和 versionName。
2. 提交并推送到 main，等 CI 通过。
3. 打 tag v<版本> 并推送。Release workflow 会构建 APK、校验证书指纹、创建 Release 并上传。

workflow 需要仓库 secret DEBUG_KEYSTORE_BASE64，值为 base64 -w0 ~/.android/debug.keystore 的输出。 Release 正文由 --generate-notes 自动生成，发布后可以手工补充中文变更说明。

项目结构

app/src/main/
├── proto/                    # gRPC 接口定义
└── java/com/robonix/client/
    ├── data/
    │   ├── grpc/             # Atlas / Liaison / Executor 客户端
    │   ├── audio/            # 录音、播放、音频桥 + 前台服务
    │   ├── local/            # DataStore 设置持久化
    │   └── model/            # 数据模型
    ├── domain/               # Repository 层
    └── ui/                   # Compose 页面：chat / perception / audio / vitals / settings …