J2CL 项目教程

1. 项目的目录结构及介绍

J2CL 项目的目录结构如下：

j2cl/
├── build_defs/
├── dev/
├── docs/
├── jre/
├── junit/
├── maven/
├── samples/
├── third_party/
├── tools/
├── transpiler/
├── .bazelrc
├── .bazelversion
├── .gitignore
├── BUILD
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── WORKSPACE
├── build_test.sh
├── build_test_samples.sh

目录介绍：

• build_defs/: 包含构建定义文件。
• dev/: 开发相关文件。
• docs/: 项目文档，包括入门指南、最佳实践等。
• jre/: Java 运行时环境相关文件。
• junit/: JUnit 测试相关文件。
• maven/: Maven 构建相关文件。
• samples/: 示例代码，如 helloworld 示例。
• third_party/: 第三方依赖库。
• tools/: 工具相关文件。
• transpiler/: 转译器相关文件。
• .bazelrc: Bazel 配置文件。
• .bazelversion: Bazel 版本文件。
• .gitignore: Git 忽略文件。
• BUILD: Bazel 构建文件。
• CONTRIBUTING.md: 贡献指南。
• LICENSE: 项目许可证。
• README.md: 项目介绍和使用说明。
• WORKSPACE: Bazel 工作区文件。
• build_test.sh: 构建测试脚本。
• build_test_samples.sh: 示例构建测试脚本。

2. 项目的启动文件介绍

J2CL 项目的启动文件主要是 README.md 和 docs/getting-started.md。

README.md

README.md 文件是项目的入口文件，包含了项目的基本介绍、使用说明、贡献指南、许可证信息等。用户可以通过阅读该文件快速了解项目的基本情况。

docs/getting-started.md

docs/getting-started.md 文件是项目的入门指南，详细介绍了如何开始使用 J2CL 项目。内容包括：

• 如何克隆项目仓库。
• 如何构建和运行示例代码。
• 如何使用 Bazel 进行构建。
• 如何进行 Java 和 JavaScript 的互操作。

3. 项目的配置文件介绍

J2CL 项目的主要配置文件包括 .bazelrc、BUILD 和 WORKSPACE。

.bazelrc

.bazelrc 文件是 Bazel 的配置文件，用于配置 Bazel 的行为。例如，可以配置构建选项、缓存路径、输出路径等。

BUILD

BUILD 文件是 Bazel 的构建文件，定义了项目的构建规则和依赖关系。每个目录下的 BUILD 文件定义了该目录下的构建目标。

WORKSPACE

WORKSPACE 文件是 Bazel 的工作区文件，用于定义项目的外部依赖。通过该文件，可以指定项目依赖的第三方库和版本。

---

以上是 J2CL 项目的目录结构、启动文件和配置文件的介绍。通过这些内容，用户可以快速了解和上手 J2CL 项目。