denx-b / bitrix-version-builder
生成1С-Битри克斯模块更新存档
2.2.1
2024-01-14 18:03 UTC
Requires
- php: ^7.0||^8.0
- ext-iconv: *
- ext-zip: *
- gitonomy/gitlib: ^1.3
- symfony/console: ^5.4
Requires (Dev)
- symfony/var-dumper: ^5.4
This package is auto-updated.
Last update: 2024-09-28 12:42:38 UTC
README
该库承担了生成基本结构和收集1С-Битри克斯模块更新的日常工作
- 自动创建模块结构;
- 自动创建模块新版本的存档;
- 根据git提交历史确定已更改的文件;
- 自动将UTF-8编码的西里尔语言文件解码为windows-1251;
- 自动从最后提交的注释中提取更新描述(description.ru)。
使用
使用composer安装库
composer require denx-b/bitrix-version-builder
模块根目录必须存在git
git init
构建新版本
./vendor/bin/console bitrix:version-build
创建模块的基本结构
./vendor/bin/console bitrix:create-module
最终,模块结构可能如下所示
/* aspro.max/ ├─ .versions/ | ├─ .last_version.zip | ├─ 1.1.3.zip | └─ 1.1.4.zip ├─ install/ ├─ lang/ ├─ vendor/ ├─ composer.json ├─ composer.lock ├─ include.php ├─ options.php └─ options_conf.php */
生成命令 bitrix:create-module
启动后会向您提出一些问题,以生成安装类、模块代码、模块名称、模块描述等。您可以将该库用于具有自己结构和文件的现有模块,即可以跳过结构生成步骤,仅使用版本构建 bitrix:version-build
更新构建如何工作?
版本存档存放在 .versions 目录中
/* aspro.max/ ├─ .versions/ | ├─ .last_version.zip | ├─ 1.1.3.zip | └─ 1.1.4.zip */
版本名称取自模块的 /install/version.php 文件
<?php
$arModuleVersion = array(
"VERSION" => "1.1.4", // <-- 1.1.4.zip
"VERSION_DATE" => "2019-12-04 18:52:00"
);
更新存档中包含最后一个和前一个标签之间的文件,或者如果没有两个标签,则包含所有文件(.last_version.zip);
更多关于文件存档和命名信息。
epilog_after.php
开发您的模块,提交代码,专注于任务,将日常工作委托给构建器!准备好发布新版本时,只需再次执行命令 ./vendor/bin/console bitrix:version-build