# 编译

## 编译前准备

[下载源代码](https://ilogtail.gitbook.io/ilogtail-docs/1.2.1/installation/sources/download)

[安装docker](https://docs.docker.com/engine/install/)

## 编译目标 <a href="#vespv" id="vespv"></a>

Makefile描述了整个项目的所有编译目标，主要的包括：

| **目标**        | **描述**       |
| ------------- | ------------ |
| core          | 仅编译C++核心     |
| plugin        | 仅编译Go插件      |
| all           | 编译完整iLogtail |
| dist          | 打包发行         |
| docker        | 制作iLogtail镜像 |
| vendor        | 更新插件依赖       |
| plugin\_local | 本地编译Go插件     |

使用`make <target>`命令编译所选目标，如果需要指定生成的版本号则在编译命令前加上VERSION环境变量，如：

```shell
VERSION=1.1.1 make dist
```

## 使用镜像编译完整iLogtail

编译完整iLogtail的命令是`make all`，由于all是默认的编译目标，因此也可以直接`make`。该命令首先清理`output`目录，然后调用`./scripts/gen_build_scripts.sh`脚本生成编译用的脚本和镜像描述保存到`./gen`目录，调用 docker 制作镜像，制作的过程即镜像内的编译过程，最后将镜像内的编译结果复制到`output`目录。

以下命令可以快速编译出iLogtail的可执行程序和插件。

1\. 进入源代码顶层目录。

2\. 执行命令`make`。

3\. `output`目录结果。

```
./output
├── ilogtail (主程序）
├── libPluginAdapter.so（插件接口）
├── libPluginBase.h
└── libPluginBase.so (插件lib）
```

开发环境增量编译的方法请参考[开发环境](https://ilogtail.gitbook.io/ilogtail-docs/1.2.1/developer-guide/development-environment)。

## Go插件本地编译

Go插件可以在主机上进行直接编译，编译前，需要安装基础的 Go 1.16+ 语言开发环境，如何安装可以参见[官方文档](https://golang.org/doc/install)。 在安装完成后，为了方便后续地开发，请遵照[此文档](https://golang.org/doc/code#Organization)正确地设置你的开发目录以及 GOPATH 等环境变量。。

```bash
make vendor       # 若需要更新插件依赖库
make plugin_local # 每次更新插件代码后从这里开始
```

如果未对只是对插件依赖库进行修改，则只需要执行最后一行命令即可。