openwrt package介绍

OpenWrt 构建系统主要围绕package的概念展开。不管是什么软件，几乎都对应一个package。 这几乎适用于系统中的所有内容：HOST工具、交叉编译工具链、Linux 内核、内核mod、根文件系统和上层的应用软件。

一个 OpenWrt package本质上是一个目录，其中包含：

• OpenWrt package Makefile，描述软件的获取、构建和打包过程（必需）
• OpenWrt package 补丁目录，用于修改package的源代码（可选）
• OpenWrt package 附带的其他静态文件，例如初始化脚本文件、默认配置、脚本或其他支持文件（可选）

├── miniupnpd
│   ├── files
│   ├── Makefile
│   └── patches

如果这个package不需要源码或者源码是在线下载的(git、svn、http方式等等)，那么只需要一个上述的OpenWrt package就可以了，否则还需要一个package 源码的目录，这个目录比较随意，可以放在任何地方，甚至可以放在OpenWrt package目录内部，不过为了方便管理，建议还是将源码和OpenWrt package分开。

├── miniupnpd
│   ├── files
│   ├── Makefile
│   ├── patches
│   └── src   # 新增源码目录

接下来依次介绍这4个部分的规范：

Makefile (必要)

Makefile文件是用来描述软件的获取、构建和打包过程，它是必需的，而且具有一定的格式。
而且这里的Makefile文件与传统的makefile文件也是有区别的，编写时需要特别注意。

PKG_*部分

PKG_NAME - 包的名称，可以通过menuconfig 查看,是人为定义的name
PKG_VERSION - 需要下载的package版本号，通常和PKG_SOURCE配合使用
PKG_RELEASE - 当前package Makefile 的版本
PKG_LICENSE - 软件包可用的许可证，SPDX 形式。
PKG_LICENSE_FILES-包含许可证文本的文件
PKG_BUILD_DIR -package编译目录，在哪里编译这个package,默认为$(BUILD_DIR)/$(PKG_NAME)
PKG_SOURCE - package的源码压缩包名(busybox-$(PKG_VERSION).tar.bz2)
PKG_SOURCE_URL - 从哪里下载package的源码
PKG_HASH - package的源码压缩包的校验和。MD5或SHA256格式，默认使用 SHA256，请参阅 script/download.pl
PKG_CAT - 如何解压缩源文件（zcat、bzcat、unzip）
PKG_BUILD_DEPENDS - 需要在此包之前构建的包。如果当前package在构建时需要依赖另一个package的文件或者库，则需要使用此选项指定依赖package的目录名称（即 openssl）而不是二进制包名称（即 libopenssl）。
PKG_CONFIG_DEPENDS - 指定哪些配置选项影响构建配置并应在更改时触发重新运行构建/配置
PKG_INSTALL - 将其设置为'1'将调用"make install"进行编译后的安装动作，并将安装目标路径前缀设置为PKG_INSTALL_DIR
PKG_INSTALL_DIR - 指定make install的目标路径如果是从git, bzr, svn等获取package源代码，还需要定义如下信息PKG_SOURCE_PROTO -获取package源码使用的协议(git, svn等)
PKG_SOURCE_URL -package源码存储库地址。URL方案必须与PKG_SOURCE_PROTO一致(例如git://)，但现在大多数VCS都接受http://或https:// URL。
PKG_SOURCE_VERSION -基于哪个commit hash 获取package 源码
PKG_SOURCE_DATE—一个类似2019-09-01的日期，用于生成的tarball的名称中(uci-2019-09-01-415f9e48.tar.xz)
PKG_MIRROR_HASH -从源码存储库获取的tarball的SHA256校验(以前称为PKG_MIRROR_MD5SUM)
PKG_SOURCE_SUBDIR—从源码存储库获取的tarball临时存放目录，默认为$(PKG_NAME)-$(PKG_VERSION)

Package/

Package/用于定义package在menuconfig中的一些信息，常见的参数如下：

SECTION - （未使用）软件包类型
CATEGORY - package所在的menuconfig一级菜单(可以自定义)
SUBMENU - CATEGORY的下级菜单(可以自定义)
TITLE - menuconfig中对软件包的简短描述
DESCRIPTION -（已废弃）软件包的详细描述
URL - （可选）package的源网址(一般是提供这个package的官网，但不是直接下载package的网址)
MAINTAINER -（新软件包需要）package的联系人(Imre Kaloz <kaloz@openwrt.org>)
DEPENDS -（可选）此package依赖的其他package(目录，而不是package名字)
EXTRA_DEPENDS -（可选）运行时依赖项，不会被编译，只会添加到软件包控制文件中
PROVIDES - （可选）允许定义一个虚拟软件包，它可能由多个实际软件包提供
PKGARCH -（可选）将其设为 "all"（全部），以生成 "Architecture: all"（架构：全部）的软件包（见下文
USERID -（可选）在安装软件包时创建的用户名：组名对。（例如ubus=81:ubus=81）

Package/<Package Name>/description

Package的详细描述信息，它将出现在menconfig的Help选项中。

Build/Prepare(可选)

定义编译之前的准备工作。
默认动作是解压源码并给解压后的源码打patch。如果未定义此参数，则会执行默认的动作。

Build/Configure (可选)

定义如何配置源码。
如果源代码存在configure命令，默认动作则会执行configure对源码进行配置。你也可以自定义此参数在编译之前进行一些自定义配置。

Build/Compile (可选)

定义如何编译源码。
在大多数情况下，不需要定义此参数，因为这时将使用默认值，该值将调用make。你也可以自定义此参加进行自定义编译。
这里需要特别注意：这一步不是定义源码该如何编译出二进制，而是定义进入哪个目录编译，需要携带哪些编译参数(-Wall,-g等等)。

Build/Install (可选)

定义如何安装编译后的产物。
默认动作是调用“make install”，前提是需要定义PKG_INSTALL:=1。
如果PKG_INSTALL:=1,但是源码的makefile中并没有提供install目标，会提示如下编译报错。

make[3]: *** No rule to make target 'install'.  Stop.

解决方案有两种：
1.自定义Build/Install参数，不使用make install进行安装
2.取消定义PKG_INSTALL:=1，在Build/InstallDev或者Package/install中实现安装步骤。

Build/InstallDev (可选)

定义如何安装编译后的产物，和Build/Install类似。

Build/Clean (可选)

用于清理package，默认只会删除编译目录。

Package/install(可选)

用于将文件复制到ipkg，ipkg由$(1)目录表示。
这里的文件可以是源码中的文件，也可以是编译产物。
注意这里不是调用make install进行安装的，只是用的cp、mv之类shell命令。
也可以使用上面Build/Install或者Build/InstallDev 方法进行安装，都可以达到同样的效果。

Package/preinst(可选)

opkg install xxx.ipk之前要执行的脚本。不要忘记包含#!/bin/sh。如果需要中止安装，让脚本返回false。

Package/postinst(可选)

opkg install xxx.ipk之后要执行的脚本。不要忘记包含#!/bin/sh。

Package/prerm(可选)

opkg remove xxx.ipk之前要执行的脚本。不要忘记包含#!/bin/sh。如果需要中止删除，请让脚本返回false。

Package/postrm(可选)

opkg remove xxx.ipk之后要执行的脚本。不要忘记包含#!/bin/sh。

小结

• 之所以有些定义的前缀是 “Package/xxx”，而另一些定义的前缀是 “Build/xxx”，是因为同一份源代码可能生成多个二进制文件。
• OpenWrt 的工作假设是每个Package Makefile只有一个源代码，但您可以根据需要使用源代码编译生成任意多个二进制文件。由于只需编译一次源代码，因此只有一组全局的"Build/xxx"定义，但您可以通过增加对BuildPackage的调用来添加任意数量的 "Package/xxx"的定义。
• Build/InstallDev 和Build/Install以及Package/hello/install这三种方法作用是差不多的，在实际使用中，至少需要实现其中一种，因为编译产物需要安装到什么位置必须由我们自己决定。

files (可选)

这个目录存放package静态文件(如OpenWrt特定的初始化脚本或配置文件)，这些静态文件的命名没有明确规定。

patches (可选)

该目录必须与Makefile放在同一个父目录中，目录名必须固定为小写的patchs，并且只能用于修改压缩包形式的源代码。

补丁文件必须采用统一的diff格式，并带有扩展名。文件名还必须带有数字前缀，以表示必须应用补丁文件的顺序。补丁文件名应简洁，避免使用ASCII字母数字和连字符以外的字符。

合法的补丁文件名如下所示:

000-patch-makefile.patch
010-backport-frobnicate-crash-fix.patch
999-add-local-hack-for-openwrt-compatibility.patch

src (可选)

这个目录是否存在取决于这个package是否需要源码以及源码是否在线下载的，如果需要源码且源码不是在线下载的，那就需要一个目录来存放源码，但这个目录比较自由，理论上可以放在任何地方。
如果你将源码放在Package Makefile同级的src目录下，那编译时会自动拷贝src/*到$(PKG_BUILD_DIR)，否则，你需要手动将源码拷贝到$(PKG_BUILD_DIR)。

helloworld package示例

下面是一个Makefile的示例：

include $(TOPDIR)/rules.mkPKG_NAME:=helloworld
PKG_VERSION:=1.0.0
PKG_RELEASE:=1
PKG_LICENSE:=GPL-2.0
PKG_LICENSE_FILES:=GPL
#PKG_INSTALL:=1include $(INCLUDE_DIR)/package.mkdefine Package/helloSECTION:=Utilities CATEGORY:=UtilitiesSUBMENU:=appsDEPENDS:=TITLE:= example package part 1 
endefdefine Package/hello/descriptionA simple example package
endefdefine Package/worldSECTION:=Utilities CATEGORY:=UtilitiesSUBMENU:=appsDEPENDS:=TITLE:= example package part 2
endefdefine Package/world/descriptionA simple example package
endefdefine Build/Prepare$(Build/Prepare/Default)$(INSTALL_DIR) $(PKG_BUILD_DIR)/files[ ! -d ./files/ ] || $(CP) ./files/* $(PKG_BUILD_DIR)/files/
endef#define Build/Install
#	$(INSTALL_DIR) $(1)/etc/init.d
#	$(INSTALL_BIN) $(PKG_BUILD_DIR)/files/helloworld.init $(1)/etc/init.d/helloworld.init
#endefdefine Build/InstallDev$(INSTALL_DIR) $(1)/etc/init.d$(INSTALL_BIN) $(PKG_BUILD_DIR)/files/helloworld.init $(1)/etc/init.d/helloworld.init
endef#define Build/Clean
#	rm -rf $(PKG_BUILD_DIR)
#endefdefine Package/hello/install$(INSTALL_DIR) $(1)/usr/bin$(INSTALL_BIN) $(PKG_BUILD_DIR)/hello $(1)/usr/bin
endefdefine Package/world/install$(INSTALL_DIR) $(1)/usr/bin$(INSTALL_BIN) $(PKG_BUILD_DIR)/world $(1)/usr/bin
endef#define Package/hello/preinst
#    #!/bin/sh
#		echo "hello-preinst" 
#endef$(eval $(call BuildPackage,hello))
$(eval $(call BuildPackage,world))

helloworld会根据源码编译生成2个可执行文件，源码采用本地目录的方式。
#注释掉的部分都是非必要的，没有注释的部分也并非都是必要的,例如Build/InstallDev里面的步骤也可以放在Package/xxx/install里面做。

├── helloworld
│   ├── files   # 配置文件目录
│   │   └── helloworld.init
│   ├── Makefile
│   ├── patchs
│   └── src   # 源码文件
│       ├── hello.c
│       ├── makefile  # 这个源码的编译规则，需要自行编写
│       └── world.c# src/makefile  示例
all: hello  world
hello:$(CC) hello.c $(CFLAGS) -o hello
world:$(CC) world.c $(CFLAGS) -o world
clean:rm -rf hello.o hello world.o world

总结

OpenWrt 系统本质是一个package管理器（类似.deb or .rpm包管理），几乎所有的软件都对应一个package，package里面的Makefile文件非常重要，它的语法也比较特殊，在创建新的package时，Makefile文件尽量参考已有的package。
package Makefile和源码的makefile不是一回事，前者是定义Package的一些信息，后者是具体的编译规则，package Makefile的语法也比较灵活，大家可能要根据实际情况决定是否需要自定义某些参数。

参考

OpenWrt packages