构建 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 目录中,此时,可从本地计算机直接运行示例。