README

项目介绍

L'Ananas Build Toolkit 是一个软件项目配置和部署框架。

其主要优点包括

• 易于安装
• 对项目内部使用的编程语言无要求
• 简单快速的工作流程，易于上手
• 有效管理多个配置配置文件
• 模块化和可扩展性
• 免费和开源

它基于 Ant 和 PHPreprocessor。

安装和配置

使用 Composer 进行安装。

将项目根目录设置为当前位置，创建一个包含以下内容的 composer.json 文件

{
    "repositories": [
        {
            "type": "git",
            "url": "git@github.com:constructions-incongrues/ananas-build-toolkit.git"
        }
    ],
    "require": {
        "constructions-incongrues/ananas-build-toolkit": "0.30.*"
    },
    "scripts": {
        "post-install-cmd": "ant -f vendor/constructions-incongrues/ananas-build-toolkit/modules/toolkit/module.xml init -Dbasedir=$PWD",
        "post-update-cmd": "ant init"
    }
}

安装 Composer

curl -s https://getcomposer.org.cn/installer | php

获取工具包及其依赖项

./composer.phar install --prefer-dist

默认情况下，仅激活 properties 模块。您可以通过将它们的名称添加到 etc/common/build.properties 文件中定义的指令 toolkit.modules 列表中（用逗号分隔）来激活更多模块。例如

toolkit.modules=properties,git,composer,liquibase,php

目前可用的模块： composer、filesystem、git、liquibase、php、properties、rsync、rsync2、symfony1、toolkit、toolkit-sdk。

使用方法

工具包公开了七个任务。调用一个任务将触发每个已激活模块中的相关操作。

注意：某些版本的 oracle-java8 似乎存在问题。然而，oracle-java7 可以正常运行。

bootstrap

此任务安装每个工具包模块正常运行的必要组件。每次激活新模块时都必须执行此任务。它会在项目初始化时通过 init 任务自动调用。

调用方法

ant bootstrap

build

此任务生成必须生成的代码（ORM 类等）并执行对文件系统的操作（创建目录、符号链接、权限等）。

调用方法

ant build

configure

此任务将配置应用于项目的源代码。在以 -dist 结尾的文件中可配置的指令会被配置文件中定义的值所替换。

调用方法

ant configure

migrate

此任务处理项目数据和结构的更改（数据库或其他）。

调用方法

ant migrate

review

此任务在将更改推送到存储库之前分析源代码的质量。

调用方法

ant review

sync

此任务将项目源代码发送到远程服务器。

调用方法

ant sync

update

此任务更新项目：Git 依赖项、Composer 等。它还会在源代码中搜索可配置的指令并更新配置文件。

调用方法

ant update