Question

如何编译OpenWrt

Answer 1

　　Openwrt 官方正式的发行版是已编译好了的映像文件（后缀名bin或trx、trx2），此映像文件可从Openwrt官方网站的下载页面中轻松获取到，连接地址为 OpenWrt官方网站。这些编译好的映像文件是基于默认的配置设置，且只针对受支持的平台或设备的。因此，为什么要打造一个自己的映像文件，理由有以下四点：
　　您想拥有一个个性化的配置OpenWrt（彰显个性，在朋友圈子里显摆显摆，开个玩笑）；
　　您想在实验性的平台上测试OpenWrt；
　　您参与测试或参与开发OpenWrt的工作；
　　或者，最简单的目的就是为了保持自己的Openwrt为最新版本；
　　若想实现上述目的，其实很简单，按下述文字即可成功编译出一个您的Openwrt来。
　　准备工作
　　在开始编译Openwrt之前需要您做些准备工作；与其他编译过程一样，类似的编译工具和编译环境是必不可少的：
　　一个构建OpenWrt映像的系统平台，简单说就是准备一个操作系统（比如Ubuntu、Debian等）；
　　确保安装了所需的依赖关系库， （在debian系统中就是安装各种需要的软件包）
　　OpenWrt源代码副本
　　首先， 开机登陆到支持编译Openwrt的操作系统（废话了）。实体机或者虚拟机(Vmware 或者 Qemu)里的操作系统都行，这里推荐使用Linux系统。 bsd和mac osx系统也可以编，但不推荐，且未验证是否可编译成功。下文假定您使用的是Debian操作系统，使用 apt-get 来管理包. 替代的选择是 Ubuntu (分支 Kubuntu, Xubuntu 等即可)。
　　第二步, 就是安装所需要的各种软件包, 包括编译器,解压工具,特定的库等. 这些工作可以简单的通过键入以下命令 (通常需要root 或者是 sudo 权限)，以root权限安装下列软件包(可能并不完整，会有提示，提示缺少即装就可以了）:
　　32位(x86)请执行下列命令:
　　# apt-get install build-essential asciidoc binutils bzip2 gawk gettext \
　　git libncurses5-dev libz-dev patch unzip zlib1g-dev
　　
　　64位(x86_64)请执行下列命令（多装了哪些库或软件包呢？请您仔细看一看哦）:
　　# apt-get install build-essential asciidoc binutils bzip2 gawk gettext \
　　git libncurses5-dev libz-dev patch unzip zlib1g-dev ia32-libs \
　　lib32gcc1 libc6-dev-i386
　　
　　参考 本列表中 所列的编译环境所需要软件包或库。
　　某些依赖的为库或软件包也许操作系统中已经安装过，此时apt-get会作出提示（提示您忽略或重新安装的），别紧张，放轻松些，编译Openwrt不会像编译DD－WRT那样难的（至少本人是体会到了编译DD－WRT的难）。
　　最后下载一份完整的 Openwrt 源码到编译环境中。关于Openwrt的源代码下载，途径有二，一是通过 svn ，一是通过 git，建议使用 svn ，因为Openwrt主要以 svn 来维护Openwrt系统的版本。另外，请注意Openwrt中不同的分支版本，一个是用得较多的开发快照，俗称 trunk，二是稳定版，俗称 backfire。
　　安装Subversion
　　若你想通过svn下载源代码,你需安装 Subversion。Subversion,或称SVN, 是OpenWrt的project中用来控制版本的系统,它非常类似的 CVS的界面和使用条款。 执行下述命令即可安装SVN，很容易的：
　　# apt-get install subversion
　　
　　Subversion安装完毕，通过SVN命令可获取得到一份OpenWrt纯净源代码。您还得创建一个目录以便存放获取得到的Openwrt源代码，要获取源代码你还得输入subversion命令来获取 (svn里这种操作称之为'check out') 。命令很简单的，继续看下去就能见到了，别着急，耐心点儿。
　　编译流程
　　编译专属于您的设备的特定Openwrt固件以一下五个步骤：
　　通过Subversion命令获得源代码；
　　更新(或安装) package feeds〔package feeds无法确切翻译，待译吧）；
　　创建一个默认配置以检查编译环境是否搭建好了 (假如需要的话)；
　　用Menuconfig来配置即将编译生成的固件映像文件的配置项；
　　最后开始编译固件；
　　下载源代码
　　最后，下载一份完整的OpenWrt源代码。你可选择：
　　下载稳定发行版，或
　　下载开发版 (俗称"trunk"版)。
　　使用发行版的源码
　　截止本文时, Openwrt公开发行的稳定版为 OpenWrt 10.03 "backfire"。此版本是最稳定的，但也许不包括最新更新的补丁或最新编写的出的新功能。
　　下述代码即举例说明了通过svn从brandkfire获得backfire源代码（此版本意思是从trunk分支的补丁也在backfire版本中了，即包含修复补丁）：
　　# mkdir OpenWrt/
　　# cd OpenWrt/
　　# svn co svn://svn.openwrt.org/openwrt/branches/backfire
　　
　　注解: 上述svn命令将在当前目录创建一个 OpenWrt/backfire/ 子目录，此目录包含此命令获取到的源代码。
　　您也可以通过下述命令，下载不含修复补丁的backfire的原版源码：
　　# svn co svn://svn.openwrt.org/openwrt/tags/backfire_10.03
　　
　　使用开发版源代码
　　当前的开发版本分支(trunk)已包含最新的实验补丁。此分支或许还突破了Openwrt原来所不支持的硬件设备的限制哦，惊喜的同时也有风险存在。因此，编译trunk版，慎之～
　　# mkdir OpenWrt/
　　# cd OpenWrt/
　　# svn co svn://svn.openwrt.org/openwrt/trunk/
　　
　　更多详细资料详见： https://dev.openwrt.org/wiki/GetSource.
　　跟进并更新源代码
　　因Openwrt的源代码随时都会变动，故此命令将确保您所获取得到的源码的最新性。下述假设您用的是backfire版本的源码：
　　## Here, backfire is the directory name of the current release branch you're tracking
　　# cd OpenWrt/backfire/
　　# svn up
　　
　　'svn up' 命令用于更新SVN上更新了，但本地尚未更新的这部分源代码（本人实践证明此命令会将本地源码与SVN上的源码先比较，若SVN有更新才会下载更新的部分，很实用的一个命令）。如果未指定目标路径，则此命令将更新当前目录及当前目录的子目录内的源码。
　　Feeds下载
　　Feeds即为包含到你的OpenWrt环境中的额外软件包的索引之类的。（feed译名很多，莫衷一是，至2008年底为止，还没有一个十分通用而备受认可的中文译名；所以此文当中我们用英文feed来称呼）。 最主要的Feeds有以下三个：
　　'packages' - 路由的基本功能,
　　'LuCI' - OpenWrt默认的GUI（WEB管理界面）, 及
　　'Xwrt' - 其他的GUI。
　　一般情况，你至少需要含 'packages' 和 'LuCI'两个Feeds。
　　下载完feeds之后， (为编译OpenWrt的recipies额外的预定义包) 您可以检查哪些feeds要包括在内。编辑在你的编译环境的根目录下的'feeds.conf.default'文件。
　　然后使用下列命令开始下载（注：可能你需要先运行cd trunk进入trunk目录才能成功执行下列命令）：
　　# ./scripts/feeds update -a
　　
　　在此之后，下载的软件包需要安装。亦即指的下边的命令啦。若路过下边的install命令则后续make menuconfig将无法成功执行！（注：可能你需要先运行cd trunk进入trunk目录才能成功执行下列命令）：
　　# ./scripts/feeds install -a
　　
　　只需编辑Feeds的配置文件或运行更新命令，即可很方便地更新或添加新的实验性的packages到源码中并编译到OpenWrt固件去。
　　注意：请老坛友及旧的新闻组成员们注意了，这一步取代了创建符号链接symlinks的老办法哦。
　　更新Feeds
　　诸如此类源码,你得定期更新Feeds。 通过如上相同的命令:
　　# ./scripts/feeds update -a
　　# ./scripts/feeds install -a
　　
　　注意:若你清楚地知道你不需添加新的packages到menuconfig中去，那么你可在更新Feeds时跳过这一步。
　　生成配置
　　You may not have to make configration always after updating sources and feeds, but making it ensures that all packages from source and feeds are correctly included in your build configuration.
　　Defconfig
　　下一步是检查编译环境，若可进行编译则生成默认配置：
　　# make defconfig
　　
　　若defconfig回显提示缺少软件包或编译库等依赖，则按提示安装所缺软件包或库等即可，不难的，细心点就行。
　　Menuconfig
　　menuconfig是一个基于文本的工具，它处理选择的目标（需要还是不需要）、编译生成软件包（openwrt下是IPKG格式）以及内核选项（编译成模块还是内核）等等
　　# make menuconfig
　　
　　在你离开并保存配置文件（默认都是.config）后，将自动配置依赖关系，让你可以着手编译更新的固件。
　　大众可通过'menuconfig'这一简单的图形化的配置环境，非常轻松地编译出专属您本人的OpenWrt固件。
　　可以用'menuconfig'，以开发的意图来编译OpenWrt的固件，为自己（个人）创造一个结构简单但是功能强大的环境。（上句实在难翻译，只能意译。并且也请大家都学习下编译OP固件，让以OP固件盈利的人丢掉那肮脏的饭碗！）
　　Menuconfig或多或少有些难以说明的地方，即使是最专业的配置，也可以寻求帮助并加以解决。 需要你指定何种目标平台，要包含的package软件包和内核模块等均需要你指定，配置标准的过程中会包括修改：
　　目标平台（即路由器何种架构，BCM呢还是AR均可选择）
　　选择要包含的package软件包
　　构建系统设置
　　内核模块
　　Target system is selected from the extensive list of supported platforms, with the numerous target profiles – ranging from specific devices to generic profiles, all depending on the particular device at hand. Package selection has the option of either 'selecting all package', which might be un-practical in certain situation, or relying on the default set of packages will be adequate or make an individual selection. It is here needed to mention that some package combinations might break the build process, so it can take some experimentation before the expected result is reached. Added to this, the OpenWrt developers are themselves only maintaining a smaller set of packages – which includes all default packages – but, the feeds-script makes it very simple to handle a locally maintained set of packages and integrate them in the build-process.
　　假如你需要LuCI, 要到Administration 菜单里,在LuCI组件的子菜单下, 并选择: luci-admin-core, luci-admin-full, and luci-admin-mini组件包。
　　假如你不需要PPP,你可到Network菜单下取消对它的选择，以便编译时不包含此组件。
　　Menuconfig用法: 确保这些组件包是以 '*'星号标记而不是 'M'标记。
　　如果你是以星号 '*'标记该组件包, 则该组件包将编译进最终生成的OpenWrt固件中。
　　如果你仅以 'M'标记该组件包, 则该组件包将不会编译进最终生成的OpenWrt固件中。
　　The final step before the process of compiling the intended image(s) is to exit 'menuconfig' – this also includes the option to save a specific configuration or load an already existing, and pre-configured, version.
　　Exit and save.
　　Source Mirrors
　　The 'Build system settings' include some efficient options for changing package locations which makes it easy to handle a local package set:
　　Local mirror for source packages
　　Download folder
　　In the case of the first option, you simply enter a full URL to the web or ftp server on which the package sources are hosted. Download folder would in the same way be the path to a local folder on the build system (or network). If you have a web/ftp-server hosting the tarballs, the OpenWrt build system will try this one before trying to download from the location(s) mentioned in the Makefiles . Similar if a local 'download folder', residing on the build system, has been specified. The 'Kernel modules' option is required if you need specific (non-standard) drivers and so forth – this would typically be things like modules for USB or particular network interface drivers etc.
　　编译固件
　　万事具备，只欠东风,通过下面简单的make命令来编译:
　　# make
　　
　　在多核电脑中编译
　　具有多核CPU处理器的电脑进行编译，使用下述参数可令编译过程加速。 常规用法为 <您cpu处理器的数目 + 1> – 例如使用3进程来编译 (即双核CPU), 命令及参数如下:
　　# make -j 3
　　
　　后台编译
　　若你在这个系统内编译OpenWrt的同时还处理其他，可以让闲置的I/O及CPU来在后台编译固件 (双核CPU):
　　# ionice -c 3 nice -n 20 make -j 2
　　
　　编译简单的基本的软件包
　　当你为OpenWrt开发或打包软件包,编译简单的基本的软件包可以很轻易地编译该软件包 (例如， 软件包cups):
　　# make package/cups/compile V=99
　　
　　一个在Feeds里的软件包大约是这样子的:
　　# make package/feeds/packages/ndyndns/compile V=99
　　
　　编译错误
　　如果因某种不知道的原因而编译失败,下面有种简单的方法来得知编译到底错在哪里了:
　　# make V=99 2>&1 |tee build.log |grep -i error
　　
　　上述编译命令意为：V99参数，将出错信息保存在build.log，生成输出完整详细的副本（with stdout piped to stderr），只有在屏幕上显示的错误。
　　举例说明:
　　# ionice -c 3 nice -n 20 make -j 2 V=99 CONFIG_DEBUG_SECTION_MISMATCH=y 2>&1 \
　　|tee build.log |egrep -i '(warn|error)'
　　
　　The above saves a full verbose copy of the build output (with stdout piped to stderr) in build.log and outputs only warnings and errors while building using only background resources on a dual core CPU.
　　一键编译
　　即使用脚本来编译Openwrt固件。许多朋友编译Openwrt是用的脚本来编译的，详见: https://forum.openwrt.org/viewtopic.php?id=28267
　　生成的固件在哪
　　编译成功后所生成的固件文件位于bin目录下，可用如下命令查看：
　　# cd bin/
　　# ls */
　　
　　清理
　　编译OpneWrt时你可能需要一个清洁干净的编译环境。 以下操作有利用编译工作:
　　清洁
　　清洁trunk/ 目录，在编译过程中使用“make clean”命令即可。 此命令将删除bin目录和build_dir目录下的所有文件及文件夹。
　　## See CAUTION below
　　# make clean