# rbot-android

**Repository Path**: cash_soldier_admin/rbot-android

## Basic Information

- **Project Name**: rbot-android
- **Description**: rbot在安卓系统的应用扩展
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-27
- **Last Updated**: 2026-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# rbot-android — rbot 安卓应用扩展库

本仓库承载 rbot 底座的**安卓扩展应用**，与 [rbot](https://gitee.com/cash_soldier_admin/rbot)（专业 Agent 底座）配套使用。rbot 基座只保留核心三件套（`rbot`、`rbotd`、`rbot-feishu`），Web 端扩展在 `rbot-extensions`，**安卓端扩展全部在本仓库**。

## 包含内容

| 目录 | 说明 |
|------|------|
| `apps/rbot-android-desktop` | 平板 WebView 壳（Java + Gradle，包 `com.rbot.desktop`）：kiosk 沉浸 + JS 桥，加载 work 工作台（:5173） |
| `apps/rbot-android-workspace` | 平板 WebView 壳 + 内嵌 Alpine Linux 沙箱（Java + Gradle，包 `com.rbot.workspace`）：PRoot 跑 rbotd，内嵌管理页 9902 + Edge-TTS，最小 rootfs 无预装 |

## 前置依赖

- **JDK 17**
- **Android SDK**（`ANDROID_HOME` 或 `~/Library/Android/sdk`；需 platform 34 + build-tools 34.0.0，可用各应用的 `setup-env.sh` 初始化）
- workspace 沙箱资产构建需要基座编译的 rbotd **musl** 产物

本仓库**以 Java + Gradle 实现为主**，不依赖 rbot 底座的任何 crate；Android 端通过 WebView + JS 桥接原生能力，workspace 通过 PRoot 直接运行 rbotd 官方二进制（musl 静态）。

仅 workspace 的沙箱资产构建（`scripts/build_sandbox_assets.sh`）需要基座编译出的 rbotd（默认 `../../rbot/target/release-linux/linux-aarch64/rbotd`，或由 `rbot/scripts/macos_build_docker_linux.sh aarch64` 生成），因此保持如下目录布局：

```
<parent>/
├── rbot/                # 基座仓库（Rust，rbotd 二进制由此编译）
├── rbot-extensions/     # Web 扩展仓库（Node.js / Electron / React）
└── rbot-android/        # 本仓库（Java + Gradle，Android SDK）
```

## 开发运行（快捷脚本）

```bash
# 环境初始化（首次：JDK 17 + Android SDK）
./apps/rbot-android-desktop/setup-env.sh
./apps/rbot-android-workspace/setup-env.sh

# 编译 debug APK
./apps/rbot-android-desktop/build.sh
./apps/rbot-android-workspace/build.sh   # 前置：先生成沙箱资产

# workspace 一键发版（构建沙箱资产 + release APK）
./apps/rbot-android-workspace/scripts/release.sh
```

## 构建

```bash
# 平板 WebView 壳（rbot-android-desktop）
cd apps/rbot-android-desktop && ./gradlew assembleDebug

# workspace（需 JDK 17 + Android SDK + 基座 rbotd musl 产物）
cd apps/rbot-android-workspace
./scripts/build_sandbox_assets.sh    # 最小 rootfs + PRoot + rbotd + www（services.tar.gz）
./gradlew assembleDebug

# 一键发版
cd apps/rbot-android-workspace && ./scripts/release.sh
```

## 文档

| 文档 | 说明 |
|------|------|
| [docs/Android程序自带Linux环境.md](docs/Android程序自带Linux环境.md) | PRoot 内嵌 Linux 方案白皮书（workspace 设计来源） |
| [docs/Rust_Termux_自动化部署方案.md](docs/Rust_Termux_自动化部署方案.md) | Termux 源码编译部署方案（desktop 依赖 Termux 环境） |
| [docs/rbot平板应用市场.md](docs/rbot平板应用市场.md) | 平板应用市场 |

## 与 rbot 底座的边界

- **不改 rbotd 核心代码**：desktop 通过 WebView 加载 work 工作台（:5173，Termux 提供服务）；workspace 通过 PRoot 跑 rbotd 官方 musl 二进制，加载其内嵌管理页（9902 本机免密）
- **rbotd 管理页 www 随基座仓库**（`rbot/apps/rbotd/www`，vanilla JS 零构建），workspace 发版时打进 `services.tar.gz`
- **Web 前端复用**：work 工作台仍在 rbot-extensions；desktop WebView 的 JS 桥通用能力封装见 `rbot-extensions/apps/rbot-work/src/lib/native.js`

## 参与贡献

欢迎任何形式的贡献——Bug 报告、功能建议、代码提交、文档改进均可。请参考 [CONTRIBUTING.md](./CONTRIBUTING.md) 与 [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md)。

## 开源许可

本项目基于 [MIT License](./LICENSE) 开源，与 rbot 基座一致。