如何将使用autotools（含Makefile.am）的包集成到OpenWRT构建中？

我刚好搞定过把autotools构建的软件集成到OpenWRT的事儿，其实核心就是写一个符合OpenWRT规范的package Makefile，再微调下原软件的配置适配嵌入式环境。下面给你一步步讲清楚：

首先得在OpenWRT源码里给你的软件建个专属目录：

• 进入OpenWRT源码根目录下的package/文件夹，新建一个和你的软件同名的目录，比如package/my-autotools-app/
• 在这个目录里创建两个核心内容：
  • 一个名为Makefile的文件（这是OpenWRT的包配置文件，不是你原软件里的Makefile.am）
  • 可选的files/目录：用来存放需要打包进固件的自定义配置文件、init脚本等
  • 可选的patches/目录：如果原软件需要打补丁适配OpenWRT，把.patch文件放这里，OpenWRT会自动应用

这是最关键的一步，这个Makefile会告诉OpenWRT怎么拉取源码、编译、安装你的软件。下面是一个通用模板，你可以根据自己的软件修改：

include $(TOPDIR)/rules.mk

# 基础信息定义
PKG_NAME:=my-autotools-app
PKG_VERSION:=1.2.3
PKG_RELEASE:=1

# 源码获取配置（二选一即可）
# 方式1：从远程服务器拉取源码包
PKG_SOURCE_URL:=https://example.com/software/
PKG_SOURCE:=$(PKG_NAME)-$(PKG_VERSION).tar.gz
PKG_HASH:=abcdef1234567890...  # 可选，填源码包的SHA256哈希值用于校验
# 方式2：使用本地源码（适合开发调试）
# PKG_BUILD_DIR:=$(BUILD_DIR)/$(PKG_NAME)
# PKG_SOURCE_PROTO:=git
# PKG_SOURCE_URL:=file:///path/to/your/local/source

# 引入OpenWRT的构建规则，重点是autotools.mk
include $(INCLUDE_DIR)/package.mk
include $(INCLUDE_DIR)/autotools.mk

# 定义软件包在OpenWRT菜单里的分类和描述
define Package/my-autotools-app
  SECTION:=utils
  CATEGORY:=Utilities
  TITLE:=My Awesome Autotools App
  DEPENDS:=+libpthread +libopenssl  # 填你的软件依赖的OpenWRT软件包，用+号开头
endef

define Package/my-autotools-app/description
  A short description of what your software does,
  maybe a line or two about its features.
endef

# 自定义configure参数（可选）
# 如果原软件的configure需要额外参数，在这里添加
define Build/Configure
	$(call Build/Configure/Default, \
		--disable-debug \
		--disable-static \
		--enable-shared \
		--prefix=/usr \
		--target=$(GNU_TARGET_NAME) \
		--host=$(GNU_TARGET_NAME) \
	)
endef

# 定义安装规则：把编译好的文件放到固件的对应位置
define Package/my-autotools-app/install
	# 创建目标目录
	$(INSTALL_DIR) $(1)/usr/bin
	# 复制编译好的二进制文件
	$(INSTALL_BIN) $(PKG_BUILD_DIR)/src/my-app-bin $(1)/usr/bin/
	# 可选：复制配置文件
	# $(INSTALL_DIR) $(1)/etc/my-app
	# $(INSTALL_CONF) ./files/my-app.conf $(1)/etc/my-app/
endef

# 注册构建规则
$(eval $(call BuildPackage,my-autotools-app))

几个关键要点：

• include $(INCLUDE_DIR)/autotools.mk是核心：它会自动帮你处理autotools的./configure、make、make install流程，包括交叉编译环境的配置（比如CC、CFLAGS这些变量不用你手动设）
• Package/xxx块里的DEPENDS一定要填对：如果你的软件依赖其他库，必须在这里声明，OpenWRT会自动帮你编译并打包依赖
• Package/xxx/install里的$(1)代表固件的根目录，所有安装路径都要基于它，比如$(1)/usr/bin对应固件里的/usr/bin

大部分情况下，OpenWRT的autotools.mk会自动处理交叉编译，但如果原软件的配置有问题，可能需要微调：

• 检查原软件的configure.ac：如果有硬编码的路径（比如/usr/local），改成$(prefix)，这样配合OpenWRT的--prefix=/usr就能正确安装
• 如果原软件有一些桌面环境特有的功能，在configure.ac里添加AC_ARG_ENABLE选项，方便在OpenWRT的Makefile里通过--disable-feature关闭
• 如果编译时出现依赖检查失败，确认你在DEPENDS里已经声明了对应的OpenWRT软件包，或者在Build/Configure里添加--without-unwanted-dependency跳过不需要的依赖

完成上面的步骤后，就可以测试编译了：

• 进入OpenWRT源码根目录，运行make menuconfig，在你指定的分类（比如Utilities）里找到你的软件，选中它
• 运行make package/my-autotools-app/compile V=s：V=s会显示详细的编译日志，方便排查错误
• 如果编译成功，固件里就会包含你的软件了，你也可以用make package/my-autotools-app/install把它安装到开发板上测试

OpenWRT官方文档里关于autotools软件包集成的关键内容包括：

• 所有软件包必须遵循OpenWRT的package Makefile规范，使用官方提供的构建宏和变量
• 对于autotools构建的软件，优先使用autotools.mk来简化流程，避免手动处理交叉编译环境
• 必须正确定义安装路径，确保文件被放到OpenWRT固件的标准目录下
• 依赖声明必须准确，否则会导致编译失败或固件运行异常

内容的提问来源于stack exchange，提问作者AmiguelS