Vectras-VM-Android 项目完全指南

Vectras-VM-Android 是一个基于 QEMU 的 Android 虚拟机应用，可以在 Android 设备上模拟运行 Windows、Linux、macOS 和 Android 等多种操作系统。该项目提供了完整的虚拟化解决方案，包括虚拟机管理、远程桌面访问、系统监控等功能。

项目目录结构

Vectras-VM-Android 项目的目录结构组织清晰，主要包含以下核心模块：

Vectras-VM-Android/
├── app/                      # 主应用模块
│   ├── src/main/
│   │   ├── java/com/vectras/ # 核心业务代码
│   │   ├── res/             # 资源文件
│   │   └── AndroidManifest.xml
│   └── build.gradle
├── library/                  # 库模块
├── terminal-emulator/        # 终端模拟器
├── terminal-view/           # 终端视图组件
├── shell-loader/            # Shell 加载器
├── web/                     # Web 相关资源
├── 3dfx/                    # 3DFX 相关文件
└── gradle/                  # Gradle 配置

核心模块说明

1. 主应用模块 (app/)

主应用模块包含应用程序的主要代码和资源：

• Java 源代码：位于 app/src/main/java/com/vectras/，包含所有主要的业务逻辑
• 资源文件：包括布局文件、图片、字符串等资源
• 原生库：提供 ARM64、ARMv7、x86、x86_64 架构的本地库支持

2. 虚拟机管理核心

项目包含完整的虚拟机管理功能：

• VMManager：虚拟机创建、编辑、删除和管理
• QEMU 集成：通过 QMP（QEMU Machine Protocol）与 QEMU 进程通信
• 设备管理：支持 CD-ROM、软盘驱动器、SD 卡等可移动设备管理

3. 图形界面系统

项目提供多种图形界面访问方式：

• VNC 客户端：内置 VNC 客户端用于远程桌面访问
• X11 服务器：支持 X11 图形界面显示
• 触摸控制：完整的触摸手势支持和输入处理

项目启动流程

启动文件

项目的启动入口是 SplashActivity，它负责应用程序的初始化和文件设置：

public class SplashActivity extends AppCompatActivity {
    public void setupFiles() {
        // 初始化必要的文件
    }
    
    public static void setupFolders() {
        // 设置工作目录
    }
}

主界面

MainActivity 是应用程序的主界面，负责显示虚拟机列表和管理界面：

public class MainActivity extends AppCompatActivity {
    @Override
    public void onConfigurationChanged(@NonNull Configuration newConfig) {
        // 处理配置变化
    }
    
    public static void startVM(String vmName, String env, String itemExtra, String itemPath) {
        // 启动虚拟机
    }
}

配置文件说明

AndroidManifest.xml

应用程序的配置文件定义了权限、活动和服务：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.vectras.vm">
    
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <!-- 其他权限 -->
    
    <application>
        <activity android:name=".SplashActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <!-- 其他活动和服务 -->
    </application>
</manifest>

build.gradle

构建配置文件定义了编译选项和依赖关系：

android {
    compileSdk = 36
    defaultConfig {
        applicationId "com.vectras.vm"
        minSdk minApi
        targetSdk targetApi
        versionCode 34
        versionName "3.3.0"
    }
}

dependencies {
    implementation 'androidx.appcompat:appcompat:1.7.1'
    implementation 'com.google.android.material:material:1.14.0-alpha06'
    implementation 'com.squareup.okhttp3:okhttp:5.3.0'
    // 其他依赖
}

核心功能组件

虚拟机控制

Vectras VM 提供完整的虚拟机生命周期管理：

• 创建虚拟机：支持自定义硬件配置和系统镜像
• 启动/停止：完整的虚拟机启动和停止流程
• 快照管理：支持虚拟机状态保存和恢复
• 设备连接：管理虚拟硬件设备

网络功能

项目包含强大的网络功能：

• 网络配置：支持多种网络模式和端口转发
• 远程访问：通过 VNC 和 X11 提供远程桌面功能
• 文件共享：支持主机和虚拟机之间的文件传输

用户界面

应用程序提供直观的用户界面：

• 主题支持：深色和浅色主题切换
• 多语言：支持多种语言界面
• 响应式设计：适配不同屏幕尺寸和设备类型

开发环境搭建

系统要求

• Android Studio 最新版本
• JDK 21 或更高版本
• Android SDK 36
• NDK 21

编译步骤

1. 克隆项目到本地：

git clone https://gitcode.com/gh_mirrors/ve/Vectras-VM-Android

2. 导入到 Android Studio
3. 配置签名证书（使用项目提供的 vectras.jks）
4. 编译并运行

项目特色功能

多架构支持

Vectras VM 支持多种 CPU 架构：

• ARM64-v8a（现代 Android 设备）
• ARMv7（旧款设备）
• x86 和 x86_64（模拟器和 PC）

高性能虚拟化

通过优化的 QEMU 配置提供接近原生的性能：

• 硬件加速支持
• 内存优化管理
• 磁盘 I/O 性能优化

扩展性设计

项目采用模块化设计，易于扩展：

• 插件系统支持
• 自定义设备驱动
• 可扩展的 UI 组件

使用示例

创建新虚拟机

// 创建新虚拟机示例
VMManager.createNewVM(
    "Windows 10",          // 虚拟机名称
    "thumbnail_path",      // 缩略图路径
    "drive_path",          // 磁盘镜像路径
    "x86_64",             // 架构
    "cdrom_path",         // 光驱路径
    "additional_params",   // 附加参数
    "vm_id",              // 虚拟机ID
    5900                  // VNC 端口
);

启动虚拟机

// 启动虚拟机示例
MainActivity.startVM(
    "Windows 10",         // 虚拟机名称
    "environment_vars",   // 环境变量
    "extra_params",       // 额外参数
    "image_path"         // 镜像路径
);

Vectras-VM-Android 项目为 Android 平台提供了完整的虚拟化解决方案，无论是用于开发测试还是生产环境，都能提供稳定可靠的虚拟机服务。