openwrt系统编译简述

深藏阁楼爱情的钟 2023-06-28 13:28 73阅读 0赞

## OpenWrt编译要求 ##

以**生成安装`8M`的`OpenWrt`固件镜像**为例：

1.  在你的操作系统上安装OpenWrt的编译系统和一些必要的东西；
2.  确保有`3-4 GB`的可用空间；
3.  环境变量：
    
     *  不应该设置SED，如果有在编译之前执行`unset SED`；
     *  `GREP_OPTIONS`不该有`–initial-tab`或者其他选项影响其输出
     *  在文件`~/.bashrc.`中的变量`PATH`添加路径 `<buildroot dir>/staging_dir/host/bin` and `<buildroot dir>/staging_dir/toolchain-<platform>-<gcc_ver>-<libc_ver>/bin` ；`staging directory`在启动构建后不久创建，`toolchain directory`在工具链构建开始时创建。构建会生成多个`shell`，其中一些`shell`期望工具链二进制文件出现在`PATH`中。

## 编译步骤 ##

1.  更新`OpenWrt`源；
2.  更新安装`package feeds`(订阅包）；
3.  确认你想获得的固件镜像；
4.  开始编译。这回自动编译工具，交叉编译源，打包 包，并且最终生成可以刷写的镜像。
5.  执行安装`OpenWrt`。

### 检出源 ###

如果你想用主干分支，使用下面指令：

git clone https://www.github.com/openwrt/openwrt

如果你想使用发布的源，使用这个：

git clone https://www.github.com/openwrt/openwrt -b chaos_calmer

**请在GIthub中确认发布的分支名，目前最新的发布分支是**  
![在这里插入图片描述][20200109143632797.png]  
如果要检出以往的分支请查阅`tags`下可用分支。

### 使用GIt更新源 ###

`OpenWrt`源更新很频繁，推荐使用最新的源。

git pull

**使用Tags目录下检出的源可以跳过此步**

### 更新订阅 ###

详见[feeds][]

在`./scripts/feeds`脚本中的 安装 意味着“使软件包在make menuconfig中可用”，而不是真正地安装或编译软件包。

1.  更新源：

./scripts/feeds update -a

**执行该步骤国内推荐挂代理执行，不然有些配置可能会更新失败，要多次尝试**  
2. 使包在`make menuconfig`中可用

#single package:
    ./scripts/feeds install <PACKAGENAME>
    #all packages:
    ./scripts/feeds install -a

这可能需要额外的时间，如果您打算创建自己的包存储库，这是必需的。

## 镜像配置 ##

典型的操作：

1.  执行`make menuconfig`并且设置“`Target System`","`Subtarget`","`Target Profile`";
2.  执行`make defconfig`;
3.  执行`make menuconfig`并且修改设置包；
4.  执行`scripts/diffconfig.sh >mydiffconfig`,存储你的改变到文本文件`mydiffconfig`中；
5.  执行`make download`(在最终make之前下载所有的依赖文件，并且使多核编译可用）
6.  执行`make V=s`（编译`OpenWrt`并且在控制台打印日志，你可以看到你在哪失败了)

### `make menuconfig` ###

`OpenWrt`编译系统配置界面处理目标平台的选择和编译的包以及需要打包进固件的文件，还有一些内核选项等等。  
使用以下指令打开`OpenWrt`编译系统配置界面：

make menuconfig

这将会自动更新你已现有配置的依赖项，你现在可以构建更换新后的镜像了。

你有三个选项：`y,m,n`分别代表以下含义：

*  按y设置`<*>`设置嵌入标签，这个包将会编译包含在镜像固件内部；
 *  按m设置`<M>`设置模块标签，这个包不会包含在镜像固件文件内；（例如:刷写固件到设备后通过 `opkg` 指令安装)
 *  按n设置`< >`设置不包含标签，源代码不会被处理

当你保存你的配置时，会依据你的配置生成文件`<buildroot dir>/.confi`。

### 解释 ###

随着`menuconfig`的开发，从一开始就打算为配置单个OpenWrt构建环境创建一个简单而强大的系统。menuconfig或多或少是自解释的，即使是最专门的配置需求也可以通过使用它来满足。根据特定的目标平台、包需求和内核模块需求，标准配置过程将包括修改：

1.  Target system
2.  Package selection
3.  Build system settings
4.  Kernel modules

从覆盖范围广的受支持平台列表中选择目标系统，有众多目标配置文件-从特定设备配置到通用配置文件，这一切都取决于你手头的设备。包选择有“选择所有包”选项，这在某些情况下是不实际的，或者依靠默认的一套软件包就足够了或者做出一些个别的选择。这里需要指出某些包组合可能会破坏构建过程，因此在达到预期结果之前，可能需要进行一些试验。除此之外，OpenWrt开发人员自己只维护一组更小的包，其中包括所有的默认包，但是`feeds-script`使处理一组本地维护的软件包并将它们集成到构建过程中变得非常简单。

编译所需镜像之前的最后一步是退出menuconfig，这还包括用于保存特定配置或加载已经存在且预先配置的版本的选项。

退出`TUI`，并选择保存您的设置。

### 内核配置（可选） ###

注意，`make kernel menuconfig`修改了构建树的内核配置模板，并且清除构建目录不会恢复它们。

通常情况下你不需要这样做（除非你有特定的需求例如[为Debian构建内核][Debian]),你可以这样做：

make kernel_menuconfig CONFIG_TARGET=subtarget

`CONFIG_TARGET`允许您选择要编辑的配置。可选项:`target, subtarget, env`。

(GIT)可以通过以下指令查看修改：

git diff target/linux/

通过以下指令恢复(SVN)

svn revert -R target/linux/

### 源镜像 ###

'`Build system settings`（构建系统设置）'包括一些更改包位置的有效选项，这使得处理本地包集变得很容易:

1.  Local mirror for source packages
2.  Download folder.

对于第一个选项，您只需输入托管软件包源的HTTP或FTP服务器的完整URL。下载文件夹将以相同的方式成为构建系统（或网络）上本地文件夹的路径。如果您有一个托管`tarball`(包）的`Web / FTP`服务器，则`OpenWrt`构建系统将尝试使用此服务器，然后再尝试从`Makefiles`中提到的位置进行下载。如果已指定构建系统上的本地“下载文件夹”，则情况类似。

如果您需要特定的（非标准）驱动程序等（通常是USB模块或特定网络接口驱动程序之类的东西），则 ‘`Kernel modules`’(内核模块)选项通常是必须的。

### 使用配置`diff file`(差异文件）配置 ###

除了`make menuconfig`外，另一种配置方法是使用配置差异文件。 该文件仅包含与默认配置相比的更改。 好处是可以使用基于OpenWRT的项目对文件进行版本控制。 它也受OpenWRT更新的影响较小，因为它仅包含更改。

#### 创建差异文件： ####

使用`<buildroot dir>/scripts/diffconfig.sh`脚本创建：

./scripts/diffconfig.sh > diffconfig # write the changes to diffconfig

#### 使用差异文件 ####

这些更改可以构成配置文件（`<buildroot dir> /.config`）的基础。 通过运行make defconfig，这些更改将扩展为完整的配置。

cp diffconfig .config # write changes to .config
    make defconfig # expand to full config

这些更改也可以添加到配置文件的底部(`<buildroot dir>/.config`)，通过运行make defconfig，这些更改将覆盖现有的配置。

cat diffconfig >> .config # append changes to bottom of .config
    make defconfig # apply changes

### 补丁 ###

OpenWrt构建系统集成了[Quilt][]便于补丁管理:

→[patches][]

### 自定义文件 ###

如果您想要包含一些自定义配置文件，正确的放置位置是：

<buildroot dir>/files/

例如，假设您想要一个带有自定义`/etc/config/firewall`或自定义`etc/sysctl.conf`的映像，然后将该文件创建为：

<buildroot dir>/files/etc/config/firewall
    <buildroot dir>/files/etc/sysctl.conf

例如。 如果您的`<buildroot dir>`是`/openwrt/trunk` ，并且您希望将某些文件复制到固件映像的`/etc/config`目录中，则放置它们的正确位置是`/openwrt/trunk/files/etc/config`。

### 默认配置 ###

[在你使用默认配置之前选择你的目标配置][Link 1]：

make defconfig

将生成构建系统的通用配置，包括对生成环境的依赖性和先决条件的检查，等等。  
将检查依赖项。 安装缺失，然后再次运行。

### 下载源以及多核编译 ###

在运行最终make之前，最好先发出make download命令，此步骤将预取所有依赖项的所有源代码，这使您可以使用cpu多核进行编译。(例如:`make -j10`，对于4核，8线程cpu工作得很好)。

如果您尝试在多个内核上编译OpenWrt，并且不下载所有依赖包的所有源文件，那么您的构建很可能会失败。

make download

## 构建镜像 ##

现在一切准备就绪，可以构建图像。可以简单的用一个指令：

make

或者

make world

这个简单的命令将触发一连串的活动。如前所述，它将：

1.  编译工具链
2.  然后使用工具链交叉编译源代码
3.  创建opkg包
4.  生成固件镜像准备刷写

## 编译提示 ##

### 后台编译 ###

如果打算在构建时使用系统，则可以使构建过程仅使用空闲的`I/O`和`CPU`容量，如下所示（4核，8线程CPU）：

make download
    ionice -c 3 nice -n19 make -j 10

### 构建单个包 ###

在为OpenWrt开发或包装软件时，仅构建有问题的包很方便的（例如使用 包`cups`）：

make package/cups/compile V=s

重新构建：

make package/cups/{ clean,compile,install} V=s

包位于哪个`feed`(订阅源）中都没有关系，此语法适用于所有已安装的包。

### 发现构建错误 ###

如果由于某种原因构建失败，则发现错误的最简单方法是：

make V=s 2>&1 | tee build.log | grep -i error

上面的代码在`/openwrt/trunk/build.log`中保存了构建输出的完整副本（将stdout通过管道传输到stderr），并且仅在屏幕上显示错误。

### 跳过失败的包 ###

如果您正在构建所有的东西(不仅仅是包足以制作一个可刷写的镜像)，并且在您不关心的包的停止构建，那么您可以使用IGNORE ERRORS=1跳过失败的包。

IGNORE_ERRORS=1 make <make options>

## 定位镜像 ##

成功构建之后，可以在新创建的`<buildroot_dir>/bin`目录中找到新构建的映像。编译后的文件还会根据目标平台进行分类，例如，为`ar71xx`设备构建的固件将位于`<buildroot_dir>/bin/ar71xx`目录下。

## Cleaning Up ##

您可能需要不时地清理构建环境。 以下make目标对于该工作很有用：

### Clean ###

make clean

删除目录/bin和/build\_dir的内容。make clean并没有删除工具链，它还避免了清除除.config中所选择的架构/目标之外的架构/目标.

### Dirclean ###

make dirclean

删除目录/bin和/build\_dir以及另外/staging\_dir和/toolchain(=交叉编译工具)和/日志的内容。“Dirclean”是你基本的“完全清洁”操作。

### Distclean ###

make distclean

核对您已编译或配置的所有内容，并删除所有下载的提要内容和软件包源。  
\*\*注意：\*\*除此之外，这将删除您的构建配置(<buildroot\_dir>/.config)、您的工具链和所有其他源代码。小心使用!

### Clean small part（清除一小部分） ###

更多的时候，您可能不想清理太多的东西，因此可以使用下面的一些命令来清理：

**Clean linux objects**

make target/linux/clean

**Clean package base-files objects**

make package/base-files/clean

**Clean luci**

make package/luci/clean

## 示例 ##

1.  [https://forum.openwrt.org/viewtopic.php?pid=129319\#p129319][https_forum.openwrt.org_viewtopic.php_pid_129319_p129319]
2.  [https://forum.openwrt.org/viewtopic.php?id=28267][https_forum.openwrt.org_viewtopic.php_id_28267]

## 原文链接： ##

1.  [OpenWrt build system – Usage][OpenWrt build system _ Usage]
2.  补充发现的官方的中文文档：[OpenWrt编译 – 说明][OpenWrt_ _]

[20200109143632797.png]: https://img-blog.csdnimg.cn/20200109143632797.png
[feeds]: http://oldwiki.archive.openwrt.org/doc/devel/feeds
[Debian]: http://oldwiki.archive.openwrt.org/doc/howto/building_kernels_for_debian_binaries
[Quilt]: https://en.wikipedia.org/wiki/Quilt_%28software%29
[patches]: http://oldwiki.archive.openwrt.org/doc/devel/patches
[Link 1]: https://forum.archive.openwrt.org/viewtopic.php?id=31125&p=1#p140470
[https_forum.openwrt.org_viewtopic.php_pid_129319_p129319]: https://forum.openwrt.org/viewtopic.php?pid=129319#p129319
[https_forum.openwrt.org_viewtopic.php_id_28267]: https://forum.openwrt.org/viewtopic.php?id=28267
[OpenWrt build system _ Usage]: http://oldwiki.archive.openwrt.org/doc/howto/build
[OpenWrt_ _]: https://openwrt.org/zh-cn/doc/howto/build#openwrt%E7%BC%96%E8%AF%91_%E8%AF%B4%E6%98%8E