jelix/buildtools

构建项目包的工具

2.1.0 2021-11-12 10:17 UTC

This package is auto-updated.

Last update: 2024-09-12 16:12:27 UTC


README

JelixBuildTools 是一组脚本

  • 用于从需要预处理步骤的源文件生成最终源文件。
  • 用于生成用于分发源代码的包。
  • 用于创建类似于 PHP 的 "makefile"。

创建 "makefile"

jBuildTools 包含用于简化编写构建脚本的类。

构建脚本接受参数,即包含一些构建选项的 ini 文件的名称。

要创建脚本

  • 首先,定义一个数组,包含 ini 文件中可能包含的所有选项
  • 然后,使用数组调用 \Jelix\BuildTools\Cli\Bootstrap::start()。然后它读取 ini 文件和命令行中的其他选项。
  • 然后,您可以编写您的指令

您可以使用多个类

  • \Jelix\BuildTools\Cli\Environment 读取 ini 文件中选项的值
  • \Jelix\BuildTools\Manifest\Manager 使用清单文件。清单文件是一个包含要复制到特定目录的文件列表的文件。清单文件中的语法允许指示文件是否需要预处理以及如何预处理。

对于为低于 2.0 的 JelixBuildTools(jBuildTools)编写的脚本,请包含文件 lib/legacy/init.php 而不是旧的 jBuild.inc.php

更多文档稍后提供。

preprocess.php

这是一个预处理源文件的工具。它从包含预处理指令的其他源文件生成源文件。因此,您可以根据参数(环境变量)生成源文件。

用法

     php preprocess.php source_file target_file

mkdist.php

根据 "清单" 文件将某些源文件从一个目录复制到另一个目录。因此,它可以用于生成包。在清单中,您写入文件列表,并指示它们应该复制到何处,是否应该应用预处理器等。请参阅 http://developer.jelix.org/wiki/en/mkdist

用法

    php mkdist.php [-v] manifest_file.mn source_dir target_dir

mkmanifest.php

生成清单文件

   php mkmanifest.php [-v] source_dir [base_path] file.mn

历史

此库刚刚从一个其他存储库中提取出来,http://github.com/jelix/jelix。因此,其历史可能包含一些难以理解的提交注释,这些注释仅对 Jelix 框架有意义。此库已长时间用于构建 Jelix 的包。

依赖关系

此库包括来自 http://joliclic.free.fr/php/javascript-packer/en/ 的 JavaScript Packer 类。