openwrt簡單ipk生成及Makefile解釋

轉自：http://www.cnblogs.com/chengyi818/p/4774043.html

前言

類似的文章其實網上比較多了,我寫這個的目的:

1,網上文章良莠不齊,有些自己都沒實際動手操作,隨便複製粘貼,實際操作不可行.
2,基本只講了操作,我當時最關心的Makefile文件的解釋沒有.

所以我自己總結了一篇.

---

說明

開發板爲MT7620a,openwrt版本爲:barrier_breaker_14.07.編譯主機爲ubuntu 14.04 32位.
git clone git://git.openwrt.org/14.07/openwrt.git
關於怎麼搭建編譯環境以及編譯請參考網上

---

正文

下面我們開始,我們遵循傳統以helloworld開始.

1.創建helloworld項目

首先我們新建helloworld.c文件和對應的Makefile文件

$mkdir -p ~/temp/hellworld/src
$cd ~/temp/helloworld/src
$touch helloworld.c Makefile

如下爲helloworld.c的內容:

#include <stdio.h>
int main()
{
    printf("This is my helloworld!\n");
    return 0;
}

如下爲Makefile文件的內容:

helloworld : helloworld.o
    $(CC) $(LDFLAGS) helloworld.o -o helloworld

helloworld.o : helloworld.c
    $(CC) $(CFLAGS) -c helloworld.c

clean :
    rm *.o helloworld

$(CC)
: 這個值由其他Makefile文件規定,表示我們使用編譯器.

\$(LDFLAGS)\&$(CFLAGS)
: 這個表示編譯器的一些選項,這裏是可選的,去掉也沒有問題.

下面可以輸入$make看看有沒有問題,注意Makefile文件的書寫格式.
最後,輸入$make clean來清理掉生成的二進制文件.因爲上一步make所使用的編譯器並不是我們的交叉編譯鏈,生成的二進制文件並不能在開發板中運行.上一步只是驗證我們的src中的內容正確與否.

---

2.創建helloworld包

下一步我們要創建一個新的Makefile文件,在這個文件中我們要描述的是helloworld包的信息,比如:如何配置,如何編譯,如何打包,安裝位置等.

$cd ~/temp/helloworld
$touch Makefile

如下爲Makefile內容:

include $(TOPDIR)/rules.mk

PKG_NAME:=helloworld
PKG_RELEASE:=1
PKG_BUILD_DIR:=$(BUILD_DIR)/$(PKG_NAME)

include $(INCLUDE_DIR)/package.mk

define Package/helloworld
    SECTION:=utils
    CATEGORY:=Utilities
    TITLE:=Helloworld -- prints a snarky message
endef

define Package/helloworld/description
    It's my first package demo.
endef

define Build/Prepare
    echo "Here is Package/Prepare"
    mkdir -p $(PKG_BUILD_DIR)
    $(CP) ./src/* $(PKG_BUILD_DIR)/
endef

define Package/helloworld/install
    echo "Here is Package/install"
    $(INSTALL_DIR) $(1)/bin
    $(INSTALL_BIN) $(PKG_BUILD_DIR)/helloworld $(1)/bin/
endef
    
$(eval $(call BuildPackage,helloworld))

如下是最後的文件樹形圖:

---

3.Makefile註釋

第1行include $(TOPDIR)/rules.mk
: 一般在Makefile的開頭,包含了包的基本信息,比如Makefile中的$(BUILD_DIR),$(INCLUDE_DIR),$(CP),$(INSTALL_DIR),$(INSTALL_BIN)都是這裏定義的.具體內容可以到源碼主目錄下,查看rules.mk文件.

3~5行,軟件包的信息均以“PKG_”開頭，其意思和作用如下
: PKG_NAME：軟件包名稱，將在menuconfig和ipkg可以看到。
PKG_VERSION：軟件版本號。
PKG_RELEASE：Makefile的版本號
PKG_SOURCE：源代碼的文件名。
PKG_SOURCE_URL：源代碼的下載網站位置。
PKG_MD5SUM：源代碼文件的效驗碼。用於覈對軟件包是否下載正確。
PKG_CAT：源代碼文件的解壓方法。包括zcat, bzcat, unzip等。
PKG_BUILD_DIR：軟件包編譯目錄。它的父目錄爲$(BUILD_DIR)。

第7行include $(INCLUDE_DIR)/package.mk
: 一般在軟件包的基本信息完成後再引入，他定義了用戶態軟件包的規則。編譯包分爲用戶態和內核模塊，用戶態軟件包使用Package，內核模塊使用KernelPackage.$(INCLUDE_DIR)/Kernel.mk文件對於軟件包爲內核時不可缺少，$(INCLUDE_DIR)/package.mk應用在用戶態。接下來講述用戶態軟件包。用戶程序的編譯包以Package/開頭，然後接着軟件名，在Package定義中的軟件名可以與軟件包名不一樣，而且可以多個定義。

9~13行
: 定義包的名稱爲helloworld
SECTION : 包的類型爲utils
CATEGORY : 目錄爲Utilitis,即文件在menuconfig中的位置;有時還會有SUBMENU項,即子目錄.
TITLE : 用於軟件包的簡短描述,將顯示在menuconfig中.
URL ： 軟件包的下載位置。
MAINTAINER ： 維護者選項。
DEPENDS ： 與其他軟件的依賴。即如編譯或安裝需要其他軟件時需要說明。如果存在多個依賴，則每個依賴需用空格分開。依賴前使用+號表示默認顯示，即對象沒有選中時也會顯示，使用@則默認爲不顯示，即當依賴對象選中後才顯示。

15~17行
: 軟件包的詳細描述,將顯示在make menuconfig中

19~23行
: 編譯準備方法，對於網上下載的軟件包不需要再描述。對於非網上下載或自行開發的軟件包必須說明編譯準備方法。本文所用的準備方法就是首先創建軟件包目錄，然後將源碼拷貝到剛剛創建的目錄中。按OpenWrt的習慣，一般把自己設計的程序全部放在src目錄下。

25~29行
: 軟件包的安裝方法，包括一系列拷貝編譯好的文件到指定位置。調用時會帶一個參數，就是嵌入系統的鏡像文件系統目錄，因此$(1)表示嵌入系統的鏡像目錄。
INSTALL_DIR:=install -d -m0755 : 創建所屬用戶可讀寫、執行，其他用戶可讀可執行的目錄
INSTALL_BIN:=install -m0755 : 編譯好的文件到鏡像文件目錄

31行 $(eval $(call BuildPackage,helloworld))
: 完成前面定義後，必須使用eval函數實現各種定義。其格式爲：
對於一般軟件包：$(eval $(call Package,$(PKG_NAME)))
或對於內核模塊：$(eval $(call KernelPackage,$(PKG_NAME)))
如果一個軟件包有多個程序，例如：一個應用程序有自己的內核模塊，上面使用的PKG_NAME需要靈活變通。eval函數可能設計多個。也可以當成多個軟件包處理。

這裏簡單地解釋了Makefile文件,更具體地請參考

---

4.編譯軟件

至此我們的軟件已經基本完成,下面進行編譯
首先將文件文件夾拷貝到openwrt目錄中的package文件中,這裏我的源碼目錄爲~/openwrt,你需要把openwrt目錄替換爲你的openwrt源碼目錄.

$mv ~/temp/helloworld ~/openwrt/package

然後回到項目主目錄運行make menuconfig

$cd ~/openwrt
$make menuconfig

按"/"後,輸入helloworld,搜索對應的路徑

接着到Utilities目錄下,找到helloworld並按空格打開;

保存後退出;

$cd ~/openwrt
$make package/helloworld/compile V=s

編譯完成後,ipk應該已經生成

$find bin/ -name "helloworld*.ipk"

至此我們已經生成簡單的ipk,恭喜:)
最後可以通過winscp,將ipk安裝到開發板中.