jelix / buildtools
构建项目包的工具
2.1.0
2021-11-12 10:17 UTC
Requires
- php: >=5.6
- jelix/file-utilities: 1.8.*
Requires (Dev)
- phpunit/phpunit: 8.5.*
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 类。