# clawdroid

**Repository Path**: teachitback/clawdroid

## Basic Information

- **Project Name**: clawdroid
- **Description**: clawdroid android app
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-04
- **Last Updated**: 2026-04-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ClawDroid

> **AI-Native Android App for TeachItBack Ecosystem**

ClawDroid 是 TeachItBack 的 Android 客户端，一个 AI 原生消息生态系统，用户可以通过 AI 助手探索世界并获得反馈。

## 功能特性

- **四大主空间**: 聊天、联系、市场、设置
- **AI 助手集成**: 与 LLM 驱动的 AI 助手聊天
- **空间模板**: 预配置的学习空间
- **Zenoh 通信**: 与服务器实时 P2P 消息传递
- **A2UI 协议**: AI 响应动态渲染 UI

## 快速开始

### 前置要求

- Android Studio (最新版本)
- JDK 17+
- Android 设备或模拟器 (API 26+)
- Python 3.10+ (用于华为设备自动安装)

### 开发环境设置

1. **克隆仓库**
   ```bash
   git clone https://gitee.com/teachitback/clawdroid.git
   cd clawdroid
   ```

2. **在 Android Studio 中打开**
   - 打开 Android Studio
   - 选择 "Open an existing project"
   - 导航到克隆的目录

3. **构建项目**
   ```bash
   ./gradlew assembleDebug
   ```

4. **安装到设备/模拟器**
   ```bash
   # 华为设备自动安装 (推荐，自动处理安全弹窗)
   python install_huawei.py
   
   # 或直接使用 adb (非华为设备)
   adb install app/build/outputs/apk/debug/app-debug.apk
   ```

### 运行测试

**单元测试**
```bash
./gradlew test
```

**E2E 测试 (需要连接设备)**

使用 e2e-installer skill 自动化安装和测试：
```
# 在 Trae IDE 中调用 e2e-installer skill
```

或手动执行：
```bash
# 构建并安装
./gradlew assembleDebug
python install_huawei.py

# 运行 E2E 测试
./gradlew connectedAndroidTest
```

**运行特定 E2E 测试**
```bash
adb shell am instrument -w -e class com.clawdroid.e2e.ChatFirstE2ETest com.clawdroid.test/androidx.test.runner.AndroidJUnitRunner
```

## 项目结构

```
clawdroid/
├── app/
│   ├── src/
│   │   ├── main/           # 主要源代码
│   │   │   └── java/com/clawdroid/
│   │   │       ├── data/       # 数据层 (DAO, Repository, Entity)
│   │   │       ├── service/    # 服务层 (Zenoh, Sync)
│   │   │       └── ui/         # UI 层 (Screens, ViewModels, Components)
│   │   ├── test/           # 单元测试
│   │   └── androidTest/    # E2E 测试
│   └── build.gradle.kts
├── scripts/                # 辅助脚本
├── install_huawei.py       # 华为设备自动安装脚本
└── README.md
```

## 架构

ClawDroid 采用 MVVM 架构和 Jetpack Compose：

- **UI 层**: Compose 界面与 ViewModels
- **数据层**: Room 数据库与 Repository 模式
- **服务层**: Zenoh 通信、同步服务

## 相关项目

- [ClawServer](../clawserver) - Python 后端服务器
- [ClawRouter](../clawrouter) - Zenoh 路由器 (NAT 穿透)
- [TeachItBack](..) - 主项目文档

## 许可证

MIT License