Android.mk 用法介紹
一個Android.mk file用來向編譯系統描述你的原始碼。具體來說:該檔案是GNU Makefile的一小部分,會被編譯系統解析一次或多次。你可以在每一個Android.mk file中定義一個或多個模組,你也可以在幾個模組中使用同一個原始碼檔案。編譯系統為你處理許多細節問題。例如,你不需要在你的Android.mk中列出標頭檔案和依賴檔案。NDK編譯系統將會為你自動處理這些問題。這也意味著,在升級NDK後,你應該得到新的toolchain/platform支援,而且不需要改變你的Android.mk檔案。
先看一個簡單的例子:一個簡單的"hello world",比如下面的檔案:
sources/helloworld/helloworld.c
sources/helloworld/Android.mk
相應的Android.mk檔案會象下面這樣:
---------- cut here ------------------
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE
:= helloworld
LOCAL_SRC_FILES := helloworld.c
include $(BUILD_SHARED_LIBRARY)
---------- cut here ------------------
我們來解釋一下這幾行程式碼:
LOCAL_PATH := $(call my-dir)
一個Android.mk file首先必須定義好LOCAL_PATH變數。它用於在開發樹中查詢原始檔。在這個例子中,巨集函式’my-dir’, 由編譯系統提供,用於返回當前路徑(即包含Android.mk file檔案的目錄)。
include $( CLEAR_VARS)
CLEAR_VARS由編譯系統提供,指定讓GNU MAKEFILE為你清除許多LOCAL_XXX變數(例如 LOCAL_MODULE, LOCAL_SRC_FILES, LOCAL_STATIC_LIBRARIES, 等等...),除LOCAL_PATH 。這是必要的,因為所有的編譯控制檔案都在同一個GNU MAKE執行環境中,所有的變數都是全域性的。
LOCAL_MODULE := helloworld
LOCAL_MODULE變數必須定義,以標識你在Android.mk檔案中描述的每個模組。名稱必須是唯一的,而且不包含任何空格。注意編譯系統會自動產生合適的字首和字尾,換句話說,一個被命名為'foo'的共享庫模組,將會生成'libfoo.so'檔案。
LOCAL_SRC_FILES := helloworld.c
LOCAL_SRC_FILES變數必須包含將要編譯打包進模組中的C或C++原始碼檔案。注意,你不用在這裡列出標頭檔案和包含檔案,因為編譯系統將會自動為你找出依賴型的檔案;僅僅列出直接傳遞給編譯器的原始碼檔案就好。
在Android中增加本地程式或者庫,這些程式和庫與其所載路徑沒有任何關係,只和它們的Android.mk檔案有關係。Android.mk和普通的Makefile有所不同,它具有統一的寫法,主要包含一些系統公共的巨集。
在一個Android.mk中可以生成多個可執行程式、動態庫和靜態庫。
1,編譯應用程式的模板:
#Test Exe
LOCAL_PATH := $(call my-dir)
#include $(CLEAR_VARS)
LOCAL_SRC_FILES:= main.c
LOCAL_MODULE:= test_exe
#LOCAL_C_INCLUDES :=
#LOCAL_STATIC_LIBRARIES :=
#LOCAL_SHARED_LIBRARIES :=
include $(BUILD_EXECUTABLE)
(菜鳥級別解釋::=是賦值的意思,$是引用某變數的值)LOCAL_SRC_FILES中加入原始檔路徑,LOCAL_C_INCLUDES 中加入所需要包含的標頭檔案路徑,LOCAL_STATIC_LIBRARIES加入所需要連結的靜態庫(*.a)的名稱,LOCAL_SHARED_LIBRARIES中加入所需要連結的動態庫(*.so)的名稱,LOCAL_MODULE表示模組最終的名稱,BUILD_EXECUTABLE表示以一個可執行程式的方式進行編譯。
2,編譯靜態庫的模板:
#Test Static Lib
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_SRC_FILES:= /
helloworld.c
LOCAL_MODULE:= libtest_static
#LOCAL_C_INCLUDES :=
#LOCAL_STATIC_LIBRARIES :=
#LOCAL_SHARED_LIBRARIES :=
include $(BUILD_STATIC_LIBRARY)
一般的和上面相似,BUILD_STATIC_LIBRARY表示編譯一個靜態庫。
3,編譯動態庫的模板:
#Test Shared Lib
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_SRC_FILES:= /
helloworld.c
LOCAL_MODULE:= libtest_shared
TARGET_PRELINK_MODULES := false
#LOCAL_C_INCLUDES :=
#LOCAL_STATIC_LIBRARIES :=
#LOCAL_SHARED_LIBRARIES :=
include $(BUILD_SHARED_LIBRARY)
一般的和上面相似,BUILD_SHARED_LIBRARY表示編譯一個靜態庫。
以上三者的生成結果分別在如下,generic依具體target會變:
out/target/product/generic/obj/EXECUTABLE
out/target/product/generic/obj/STATIC_LIBRARY
out/target/product/generic/obj/SHARED_LIBRARY
每個模組的目標資料夾分別為:
可執行程式:XXX_intermediates
靜態庫: XXX_static_intermediates
動態庫: XXX_shared_intermediates
另外,在Android.mk檔案中,還可以指定最後的目標安裝路徑,用LOCAL_MODULE_PATH和LOCAL_UNSTRIPPED_PATH來指定。不同的檔案系統路徑用以下的巨集進行選擇:
TARGET_ROOT_OUT:表示根檔案系統。
TARGET_OUT:表示system檔案系統。
TARGET_OUT_DATA:表示data檔案系統。
用法如:
CAL_MODULE_PATH:=$(TARGET_ROOT_OUT)
相關文章
- Android.mk介紹Android
- Android.mk簡介Android
- css url()用法介紹CSS
- getElementsByClassName()方法用法介紹
- css vm用法介紹CSS
- getCurrentPosition用法介紹
- python BeautifulSoup用法介紹Python
- MySQL 5.7 NOT EXISTS用法介紹MySql
- jQuery css()方法用法介紹jQueryCSS
- javascript中加號(+)用法介紹JavaScript
- jQuery(html,[ownerDocument])用法介紹jQueryHTML
- replaceChild()函式用法介紹函式
- Object.isSealed()用法介紹Object
- require.js用法介紹UIJS
- css em單位用法介紹CSS
- jQuery filter() 用法簡單介紹jQueryFilter
- css transition屬性用法介紹CSS
- PostgreSQL資料rotate用法介紹SQL
- javascript的this用法簡單介紹JavaScript
- js WebSocket用法簡單介紹JSWeb
- javascript arguments用法簡單介紹JavaScript
- onerror事件用法簡單介紹Error事件
- spam和saint的用法介紹AI
- MongoDB三種聚合命令用法介紹MongoDB
- Python qutip用法(舉例介紹)Python
- <input type="number" >用法簡單介紹
- javascript等號==運算子用法介紹JavaScript
- css 註釋用法簡單介紹CSS
- js lastIndexOf()函式的用法介紹JSASTIndex函式
- MySQL pt-show-grants用法介紹MySql
- js的returnValue屬性用法介紹JS
- style.cssText用法簡單介紹CSS
- javascript with()語句用法簡單介紹JavaScript
- css :focus選擇器用法介紹CSS
- $.ajax()用法例項程式碼介紹
- js中typeof用法詳細介紹JS
- input placeholder屬性用法介紹
- outerHTML屬性用法簡單介紹HTML