构建 DataTables
DataTables 主要由一个大型 Javascript 文件组成,但其源代码被分割成多个可管理的单独文件,最后将这些文件组合在一起以创建主函数库文件。这是 DataTables 构建过程,如果您想根据源代码修改 DataTables,则需要经历此过程。
环境和软件
DataTables 构建过程受支持的系统包括 Mac、Linux 和 Windows (WSL)。构建 DataTables 需要以下软件
- Bash
- Node.js
- PHP 7+
获得源代码
DataTables 源代码可在 GitHub 上获取,获取代码的方法很简单,键入
git clone https://github.com/DataTables/DataTablesSrc.git
然后需要安装构建依赖项
cd DataTablesSrc
npm install
构建
要构建代码,请运行
npm run build
debug
部分是可选的(这就是其显示在方括号中的原因)。当启用 debug 时,将跳过使用 Closure 编译器的缩小化处理,进而缩短构建时间,但不会生成缩小化文件,这意味着仅可用于调试。
构建过程输出将类似于
DataTables build (2.1.4) - branch: master
Deploying to build repo
JS js
Minification - js
File size: 93174
JS mjs
Minification - mjs
File size: 104504
Styling frameworks JS
JS processing dataTables.bootstrap5
Creating ES module
Minification - mjs
File size: 1102
Creating UMD
Minification - js
File size: 1470
Linting UMD
...
Types
Examples
Lint
Pass
Updating package descriptors
Done
输出
输出文件(Javascript、CSS、图像和示例)会被放置到 built/DataTables
目录中。如要使用浏览器加载它们,请运行
npm run serve
扩展
DataTables 扩展使用此脚本也会经历相同的构建过程,不过在这种情况下
./make.sh extension {name} [debug]
其中 debug
再次是可选的,在这种情况下,{name}
是扩展名称。该脚本会从 DataTables 存储库 自动克隆扩展,然后构建扩展及其示例。
输出
构建完毕的扩展会被放置到 built/DataTables/extensions
目录中,此时,可从本地计算机直接运行示例。