Closure Compiler 开源项目安装与使用指南
目录结构及介绍
在克隆或下载了 Closure Compiler 的 GitHub 仓库之后,你可以看到以下主要目录和文件:
src
: 这是编译器的主要源代码所在的位置,包括各种类、接口以及与核心功能相关的实现。test
: 包含测试案例,用于确保编译器的功能正确性和性能优化。java/com/google/javascript/jscomp/
: 此目录包含了编译器的核心 Java 类,负责解析、优化和压缩 JavaScript 代码。java/com/google/javascript/jscomp/compiler/
: 编译器引擎相关类,处理输入并产生优化后的输出。
启动文件介绍
Closure Compiler 提供了一个可执行的 JAR 文件来运行编译过程。在 out
或者 bin
目录下通常可以找到这个 JAR 文件,其名称可能是类似 compiler.jar
的形式。
如何启动
要启动 Closure Compiler,你需要具备 JDK 环境并且命令行支持运行 Java 应用程序。以下是启动 Closure Compiler 的基本命令示例:
java -jar path/to/compiler.jar --js input.js --js_output_file output.min.js
在这个命令中:
-jar
: 告诉 Java 虚拟机(JVM)从给定的 .jar 文件中读取主类。path/to/compiler.jar
: 指向 Closure Compiler 的 JAR 文件路径。--js
: 指定要被优化和压缩的 JavaScript 输入文件路径。--js_output_file
: 指定编译后的优化代码将被写入的输出文件路径。
配置文件介绍
虽然 Closure Compiler 可以通过命令行参数进行配置,但在更复杂的工作流中,使用配置文件可以使管理编译设置更加容易。配置文件允许你指定一系列选项,例如编译级别、输入和输出文件等。
一个典型的配置文件可能看起来像这样:
// ==ClosureCompiler==
// @compilation_level SIMPLE_OPTIMIZATIONS
// @language ECMASCRIPT_2018
// @output_file_name main.min.js
// @rewrite_polyfills false
// @warning_level VERBOSE
// ==/ClosureCompiler==
在这个例子中,
@compilation_level
: 定义编译器优化的程度。有三个可用级别:WHITESPACE_ONLY, SIMPLE_OPTIMIZATIONS 和 ADVANCED_OPTIMIZATIONS。@language
: 定义输入代码使用的 JavaScript 版本。@output_file_name
: 设置输出文件名。@rewrite_polyfills
: 决定是否重写 polyfills 来适应更广泛的浏览器兼容性。@warning_level
: 控制警告消息的数量,包括 QUIET、DEFAULT 和 VERBOSE。
配置文件中的每一项都以 @
符号开头,这使得它们能够在与其他 JavaScript 代码一起打包时不会被编译器误认为常规代码。通过这种方式,你可以在实际的代码库中维护这些设置,或者单独创建一个配置文件并在命令行中引用它。