给Openwrt读的Makefile文件的编写 ----我的笔记(2.4)

江枫思渺然 提交于 2019-11-30 12:58:23
在openwrt/package/目录下创建一个软件包名字对应的文件夹然后里面Makefile和src,src中有Makefile和.c文件。这两个Makefile是不一样的。内部的Makefile主要是验证文件是否正确编译。
   第二步,对于第一个Makefile来说就是建立与openwrt联系,
          (1)引入文件 
    OpenWrt使用三个makefile的子文件,分别为: 
include $(TOPDIR)/rules.mk    //位于文件开头
  include $(INCLUDE_DIR)/kernel.mk //软件包为内核时不可缺少
  include $(INCLUDE_DIR)/package.mk//软件包基本信息配置完成再引入。
 (2)编写软件包的基本信息
这些软件包的信息均以PKG_开头,其意思和作用如下:  
         PKG_NAME表示软件包名称,将在menuconfig和ipkg可以看到。 
PKG_VERSION表示软件版本号。 
PKG_RELEASE表示Makefile的版本号 
PKG_SOURCE表示源代码的文件名。  
PKG_SOURCE_URL表示源代码的下载网站位置。@SF表示在sourceforge网站,@GNU表示在GNU网站,還有@GNOME、@KERNEL。獲取方式可以為:git、svn、cvs、hg、bzr等。有關下載方法可參考$(INCLUDE_DIR)/download.mk和$(SCRIPT_DIR)/download.pl。  
PKG_MD5SUM表示源代码文件的效验码。用于核对软件包是否正确下载。
   PKG_CAT表示源代码文件的解压方法。包括zcat, bzcat, unzip等。  
        PKG_BUILD_DIR表示软件包编译目录。它的父目录为$(BUILD_DIR)。如果不指定,默认为$(BUILD_DIR)/$( PKG_NAME)$( PKG_VERSION)。
還有一些有關源代碼的定義。
PKG_SOURCE_SUBDIR
PKG_SOURCE_PROTO
PKG_SOURCE_MIRROR
PKG_MIRROR_MD5SUM
PKG_SOURCE_VERSION
3、编译包定义 
 用户程序和内核模块的定义不一样。用戶態軟件包使用Package,內核模塊使用KernelPackage。 
3.1用户程序编译包定义
用户程序的编译包以Package/开头,然后接着软件名,在Package定义中的软件名可以与软件包名不一样,而且可以多个定义。下面使用$(PKG_NAME)只是做一个标示,并非真正使用$(PKG_NAME)。 
Package/$(PKG_NAME)  
SECTION表示包的类型,预留。  
CATEGORY表示分类,在menuconfig的菜单下将可以找到。 
TITLE用于软件包的简短描述  
DESCRIPTION用于软件包的详细描述,已放弃使用。如果使用DESCRIPTION將會提示
“error DESCRIPTION:= is obsolete, use Package/PKG_NAME/description”。
URL表示软件包的下载位置。  
MAINTAINER表示维护者,选项。  
DEPENDS表示与其他软件的依赖。即如编译或安装需要其他软件时需要说明。如果存在多個依賴,則每個依賴需用空格分開。依賴前使用+號表示默認顯示,即對象沒有選中時也會顯示,使用@則默認為不顯示,即當依賴對象選中後才顯示。  
   在用戶態的軟件包中沒有內核模塊的AUTOLOAD參數。如果軟件需要在boot時自動運行,則需要在/etc/init.d增加相應的腳本文件。腳本文件需要START參數,說明在boot時的優先級,如果在boot過程啟動後在關閉,則需要進一步設置STOP參數。如果STOP參數存在,其值必須大於START。腳本文件需要start()和stop()兩個函數,start()是執行程序,stop()是關閉程序。關閉程序一般需要執killall命令。由/etc/rc.d/S10boot知道,裝載內核模塊的優先級為10,需要使用自己設計的內核模塊的程序其START的值必須大於10. 同樣由 /etc/rc.d/S40network知道,使用網絡通信的程序其START的值必須大於40。 
SUBMENU:子菜单
  




Package/$(PKG_NAME)/conffiles 
 本包安裝的配置文件,一行一個。如果文件結尾使用/,則表示為目錄。用於備份配置文件說明,在sysupgrade命令執行時將會用到。
Package/$(PKG_NAME)/description  
 软件包的详细描述,取代前面提到的DESCRIPTION详细描述。   
Build/Prepare 
    编译准备方法,对于网上下载的软件包不需要再描述。对于非网上下载或自行开发的软件包必须说明编译准备方法。一般的准备方法为:
define Build/Prepare    
  mkdir -p $(PKG_BUILD_DIR)        
                  $(CP) ./src/* $(PKG_BUILD_DIR)/ 
             endef  
按OpenWrt的习惯,一般把自己设计的程序全部放在src目录下。 Build/Configure  
在Automake中需要进行./configure,所以本配置方法主要针对需要配置的软件包而设计,一般自行开发的软件包可以不在这里说明。需要使用本定义的情况可参考dropbear。 
Build/Compile  
编译方法,没有特别说明的可以不予以定义。如果不定义将使用默认的编译方法Build/Compile/Default  自行开发的软件包可以考虑使用下面的定义。
 define Build/Compile         
   $(MAKE) -C $(PKG_BUILD_DIR) \                
   $(TARGET_CONFIGURE_OPTS) CFLAGS="$(TARGET_CFLAGS) -I$(LINUX_DIR)/include" 
  Endef 




  Package/$(PKG_NAME)/install 
 软件包的安装方法,包括一系列拷贝编译好的文件到指定位置。調用時會帶一個參數,就是嵌入系統的鏡像文件系統目錄,因此$(1)表示嵌入系统的镜像目录。一般可以采用下面的方法:  
define Package/$(PKG_NAME)/install        
 $(INSTALL_DIR) $(1)/usr/bin         
 $(INSTALL_BIN) $(PKG_BUILD_DIR)/ $(PKG_NAME) $(1)/usr/bin/
 endef  
INSTALL_DIR、INSTALL_BIN在$(TOPDIR)/rules.mk文件定义,所以本Makefile必须引入$(TOPDIR)/rules.mk文件。  
INSTALL_DIR :=install -d -m0755 意思創建所屬用戶可讀寫即執行,其他用戶可讀可執行的目錄。  INSTALL_BIN:=install -m0755意思編譯好的文件到鏡像文件目錄。
如果用戶態軟件在boot時要自動運行,則需要在安裝方法說明中增加自動運行的腳本文件安裝和配置文件安裝方法。 例如: 
 define Package/mountd/install          
$(INSTALL_DIR) $(1)/sbin/ $(1)/etc/config/ $(1)/etc/init.d/        
$(INSTALL_BIN) $(PKG_BUILD_DIR)/mountd $(1)/sbin/        
$(INSTALL_DATA) ./files/mountd.config $(1)/etc/config/mountd         
$(INSTALL_BIN) ./files/mountd.init $(1)/etc/init.d/mountd endef  
安裝文件放在files子目錄下,不要與源代碼文件目錄src混在一起,以提高可讀性。  使用清晰的文件擴展名,更方便安裝識別文件。 Package/$(PKG_NAME)/preinst  软件包安装前处理方法,使用脚本语言,因此定义的第一行需要下面的格式 #!/bin/sh  調用時帶入的參數為嵌入式系統的鏡像目錄。 Package/$(PKG_NAME)/postinst  
软件包安装后处理方法,使用脚本语言。
 Package/$(PKG_NAME)/prerm
软件包删除前处理方法,使用脚本语言 Package/$(PKG_NAME)/postrm  软件包删除后处理方法,使用脚本语言 3.2内核模块包定义  Linux分为内核态和用户态。开发者开发的内核部分可以直接加入Linux的Kernel程序,也可以生成内核模块以便需要时装入内核。OpenWrt一般希望开发者生成内核模块,在Linux启动后自动装载或手工使用insmod命令装载。内核模块使用KernelPackage开头,其他与一般软件包基本相同。 在内核模块定义中增加  SUBMENU表示子菜单位置,在$(INCLUDE)/kernel.mk对内核模块定义了CATEGORY为kernel modules,所以内核模块在menuconfig中的主菜单为kernel modules,然后有下一级子菜单$(SUBMENU)。在子菜单下可以看到以kmod-$( PKG_NAME)项目。  DEFAULT表示直接编入内核或产生内核模块,y表示直接编入内核,m表示产生内核模块。  AUTOLOAD表示自动装入内核,一般表示方法为:  AUTOLOAD:=$(call AutoLoad, $(PRIORITY),$(AUTOLOAD_MODS))  AutoLoad的第一个参数$(PRIORITY)为优先级,01为最优先,99为最后装载。有关自动装载可以在/etc/modules.d目录下看到,第二个参数 $(AUTOLOAD_MODS)模块名,每个模块名以空格符分隔。即可同时装载多个内核模块。  在开发过程最好不要使用自动装载,經過嚴格調試後再使用,可以減輕調試的工作量
4、使用定义  完成前面定义后,必须使用eval函数实现各种定义。其格式为: 对于一般软件包  $(eval $(call Package,$(PKG_NAME))) 或对于内核模块  $(eval $(call KernelPackage,$(PKG_NAME)))         如果一個軟件包有多個程序,例如:一個應用程序有自己的內核模塊,上面使用的PKG_NAME需要靈活變通。eval函數可能設計多個。也可以當成多個軟件包處理。
















以njit-client文件为例分析:
include $(TOPDIR)/rules.mk  //openwrt用的三个Makefile子文件,文件位于开头


PKG_NAME:=luci-app-njitclient //生成的软件包的名称
PKG_VERSION=1.0              //软件版本号
PKG_RELEASE:=1              //Makefile版本号
PKG_BUILD_DIR:=$(BUILD_DIR)/$(PKG_NAME)  // 表示软件包编译目录。它的父目录为$(BUILD_DIR)。如果不指定,默认为$(BUILD_DIR)/$( PKG_NAME)$( PKG_VERSION)。。
include $(INCLUDE_DIR)/package.mk  //软件包基本信息配置完成再引入。
define Package/luci-app-njitclient       //  用户程序编译包定义
SECTION:=luci                       //表示包的类型,预留。    
CATEGORY:=LuCI                      //表示分类,在menuconfig的菜单下将可以找到。
SUBMENU:=3. Applications            //表示子菜单的位置。在内核中定义。
TITLE:=NJIT 802.1X Client for LuCI  //对软件包的描述
PKGARCH:=all                       //
endef


define Package/luci-app-njitclient/description//软件包的详细描述
This package contains LuCI configuration pages for njit8021xclient.
endef


define Build/Prepare    //编译准备方法:
endef


define Build/Configure  //软件包的配置(在Automake中需要进行./configure,主要针对需要配置的软件包而设计,一般自行开发的软件包可以不在这里说明)
endef


define Build/Compile //采用默认的编译方法
endef


define Package/luci-app-njitclient/install  //软件包的安装方法
$(INSTALL_DIR) $(1)/etc/config
$(INSTALL_DIR) $(1)/etc/init.d
$(INSTALL_DIR) $(1)/usr/lib/lua/luci/model/cbi
$(INSTALL_DIR) $(1)/usr/lib/lua/luci/controller

$(INSTALL_CONF) ./files/root/etc/config/njitclient $(1)/etc/config/njitclient
$(INSTALL_BIN) ./files/root/etc/init.d/njitclient $(1)/etc/init.d/njitclient
$(INSTALL_DATA) ./files/root/usr/lib/lua/luci/model/cbi/njitclient.lua $(1)/usr/lib/lua/luci/model/cbi/njitclient.lua
$(INSTALL_DATA) ./files/root/usr/lib/lua/luci/controller/njitclient.lua$(1)/usr/lib/lua/luci/controller/njitclient.lua
endef//上面这末多,通篇讲的都是软件包的安装方法,
首先INSTALL_DIR、INSTALL_BIN在$(TOPDIR)/rules.mk文件定义,所以本Makefile必须引入$(TOPDIR)/rules.mk文件,有点类似于c语言中的头文件。
INSTALL_DIR :=install -d -m0755 意思創建所屬用戶可讀寫即執行,其他用戶可讀可執行的目錄。  INSTALL_BIN:=install -m0755意思編譯好的文件到鏡像文件目錄。
$(1)表示嵌入系统的镜像目录
所以总的来说上面四句是创建用户可读可写可执行的目录,下面是目录文件对应的镜像位置,


$(eval $(call BuildPackage,luci-app-njitclient))
使用eval函数实现前面的各种定义。如果如果是内核模块的话调用函数前加Kernel。
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!