denx-b / bitrix-version-builder

生成1С-Битри克斯模块更新存档

2.2.1 2024-01-14 18:03 UTC

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

bitrix:create-module

更新构建如何工作?

版本存档存放在 .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);

bitrix:version-build

更多关于文件存档和命名信息。

epilog_after.php

开发您的模块,提交代码,专注于任务,将日常工作委托给构建器!准备好发布新版本时,只需再次执行命令 ./vendor/bin/console bitrix:version-build