Open eCard 项目使用指南

1. 项目目录结构及介绍

Open eCard 项目是一个开源的电子身份识别（eID）解决方案，其目的是提供一个跨平台的 eCard-API-Framework 实现。项目的目录结构如下：

• addon: 包含一些附加功能的代码。
• bindings: 包含不同编程语言的绑定。
• buildSrc: 构建系统的配置文件。
• clients: 包含客户端应用程序，如 richclient。
• common: 公共模块，提供通用功能。
• crypto: 加密模块，处理安全相关的操作。
• doc: 文档资源。
• gui: 图形用户界面相关的代码。
• i18n: 国际化支持。
• ifd: IFD（终端接口设备）模块，处理与智能卡 reader 的通信。
• management: 管理模块，负责项目管理和构建过程。
• releases: 与项目版本发布相关的资源。
• sal: SAL（服务访问层）模块，实现与 smart card 的交互。
• src/qa/checkstyle: 质量保证相关的配置和脚本。
• wsdef: Web 服务定义。

除此之外，项目还包含了各种配置文件、许可证文件、README 文件和构建脚本等。

2. 项目的启动文件介绍

项目的启动主要是通过 gradlew 文件来进行的。gradlew 是一个 Gradle Wrapper 脚本，它允许你使用 Gradle 工具构建项目，而不需要在本地安装 Gradle。以下是一些基本的启动命令：

• ./gradlew build: 构建整个项目。
• ./gradlew :clients:richclient:run: 运行 richclient 客户端应用程序。

在 Windows 系统中，应使用 .\gradlew.bat 文件。

3. 项目的配置文件介绍

项目的配置主要通过 build.gradle.kts 和 gradle.properties 文件进行。以下是配置文件的简要介绍：

• build.gradle.kts: 这是 Kotlin 编写的 Gradle 构建脚本，用于配置项目的构建过程。它定义了项目的依赖项、任务和构建逻辑。
• gradle.properties: 这是一个属性文件，用于存储项目的全局配置，如 Gradle 插件的版本号、JVM 参数等。

项目的配置还包括了 settings.gradle.kts 文件，它用于配置项目的整体结构和插件。

在开始构建和运行项目之前，确保所有的依赖项都已正确配置，并且你的开发环境中安装了必要的构建工具。