# xpilot_app

**Repository Path**: yangk_123/xpilot_app

## Basic Information

- **Project Name**: xpilot_app
- **Description**: demo
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-18
- **Last Updated**: 2026-05-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# XPilotTruckApp

XPilot 卡车编队控制 Android 应用

## 项目简介

本项目是一个基于 Android 平台的卡车编队控制应用，用于管理和控制卡车编队任务。

## 技术栈

- **平台**: Android
- **语言**: Java 8
- **构建工具**: Gradle 8.5
- **协议**: Protobuf (Protocol Buffers)
- **通信**: ZeroMQ (JeroMQ)

## 项目结构

```
├── .android/              # Android 调试密钥库
├── .gradle/               # Gradle 缓存目录
├── android_app/           # Android 应用主目录
│   ├── app/               # 应用模块
│   │   ├── src/main/
│   │   │   ├── java/      # Java 源代码
│   │   │   ├── proto/     # Protobuf 定义文件
│   │   │   │   ├── app/   # 应用控制协议
│   │   │   │   └── vehicle/ # 车辆信息协议
│   │   │   ├── res/       # 资源文件
│   │   │   └── AndroidManifest.xml
│   │   └── build.gradle   # 模块构建配置
│   ├── build.gradle       # 项目构建配置
│   ├── gradle.properties  # Gradle 属性
│   └── settings.gradle    # 项目设置
└── android_sdk_mock/      # Android SDK 模拟文件
```

## 主要功能

- 卡车编队任务管理
- 车辆 GPS 信息展示
- 编队控制指令发送
- 实时任务状态监控

## 环境要求

- Android SDK 34
- Gradle 8.5
- JDK 1.8+

## 编译命令

```bash
# 设置环境变量
export ANDROID_USER_HOME=/home/yk/workspace/app/.android
export GRADLE_USER_HOME=/home/yk/workspace/app/.gradle

# 进入项目目录
cd /home/yk/workspace/app/android_app

# 编译 Debug 版本
/home/yk/.gradle/wrapper/dists/gradle-8.5-bin/*/gradle-8.5/bin/gradle assembleDebug --offline --no-daemon
```

## Protobuf 协议文件

项目包含以下 Protobuf 定义：

| 文件 | 说明 |
|------|------|
| `app_control.proto` | 应用控制协议 |
| `app_formation.proto` | 编队控制协议 |
| `task_info.proto` | 任务信息协议 |
| `gps_info.proto` | GPS 信息协议 |
| `vehicle_info.proto` | 车辆信息协议 |
| `v2x_message.proto` | V2X 消息协议 |

## 依赖项

| 依赖 | 版本 | 用途 |
|------|------|------|
| protobuf-javalite | 3.25.1 | Protobuf 支持 |
| jeromq | 0.5.4 | ZeroMQ 通信 |

## 应用配置

- **包名**: `com.xbzl.xpilot.truck`
- **最低 SDK**: 24 (Android 7.0)
- **目标 SDK**: 34
- **版本号**: 1.0

## 构建输出

编译成功后，APK 文件位于：
```
android_app/app/build/outputs/apk/debug/xpilot.apk
```

## License

MIT License