远程桌面客户端开源项目指南

本指南基于GitHub上的开源项目 remote-desktop-clients，该项目提供了适用于Android和Blackberry 10设备的VNC、RDP、SPICE以及oVirt/RHEV/Proxmox客户端。本文档旨在帮助开发者理解项目结构，掌握启动与配置流程。

1. 目录结构及介绍

项目的主要目录结构如下：

remote-desktop-clients/
├── idea         # IntelliJ IDEA相关的配置
├── CustomVnc-app    # 定制版VNC客户端源码
├── Opaque-app       # oVirt/RHEV/Proxmox客户端源码
├── aRDP-app         # RDP客户端源码
├── aSPICE-app       # SPICE客户端源码
├── bVNC-app         # 主VNC客户端源码
├── bVNC             # bVNC相关代码
├── common           # 共享代码库
├── docker           # Docker相关配置文件
├── env              # 环境变量配置
├── gitignore        # Git忽略文件列表
├── BUILDING.txt     # 构建说明文档
├── COPYRIGHT*       # 版权声明文件
├── FUNDING.yml      # 开源资助信息
├── LICENSE          # 许可证文件，采用GPL-3.0
├── README.md        # 项目介绍和快速入门文档
├── build.gradle     # Gradle构建脚本
├── create-prebuilt-dependencies.sh # 预编译依赖脚本
├── download-prebuilt-dependencies.sh # 下载预编译依赖脚本
├── gradle.properties
├── gradlew          # Unix系统下的Gradle Wrapper
├── gradlew.bat      # Windows下的Gradle Wrapper
└── settings.gradle  # Gradle设置文件

每个应用（如aRDP-app, bVNC-app等）对应不同的远程桌面协议客户端，而common目录包含了跨客户端使用的通用组件。

2. 项目的启动文件介绍

项目的运行不是简单的直接执行某个文件，而是通过Gradle进行构建与部署。主要启动过程需要通过以下步骤来实现：

• 对于开发环境的启动，首先需要确保已经设置了正确的环境变量，特别是ANDROID_SDK指向你的Android SDK路径。
• 使用提供的脚本如/bVNC/prepare_project.sh准备项目，可能需要指定是使用预先编译好的依赖(I-a)、从头构建包括使用Docker(I-b)还是在Android Studio中完全手动构建(I-c)。
• 之后，通过Android Studio打开项目，同步Gradle，并选择对应的运行配置，可以在模拟器或连接的设备上运行应用。

3. 项目的配置文件介绍

主要配置文件

• LICENSE: 详细描述了项目遵循的GPL-3.0许可证条款。
• README.md: 包含了项目的简介、如何获取应用商店版本、以及基本的构建指南。
• 环境变量配置 (env): 在构建过程中用于设置必要的环境变量，比如用户ID、组ID、SDK路径等。
• 构建配置 (build.gradle, settings.gradle): Gradle构建系统的配置文件，定义了项目结构和构建规则。

特殊配置文件

• 定制VNC客户端配置: 在进行定制化VNC客户端构建时，需要在bVNC/src/main/assets/下放置一个YAML配置文件，以com.iiordanov.自定义名称.yaml命名，参照custom_vnc_client_yaml-EXAMPLE来编辑。
• 项目内特定配置: 如各个子应用内的配置文件，虽然项目没有明确列出每个客户端的具体配置文件，但根据需要，某些客户端可能会有自己的配置逻辑或资源文件。

在进行开发和配置调整时，重点在于阅读和理解README.md中的构建说明以及利用Gradle和Android Studio的集成环境来进行项目管理。项目构建涉及多个环节，从下载依赖到编译、打包直至最终的运行测试，每一步都需要按照文档指示进行。