Android NDK開發指南—Application.mk文件 – Android移動開發技術文章_手機開發 Android移動開發教學課程

簡介:
—————————–
要將C\C++代碼編譯為SO文件,光有Android.mk文件還不行,還需要一個Application.mk文件。
本文檔是描述你的Android應用程序中需要的本地模塊的Application.mk的語法使用,要明白如下。

Application.mk目的是描述在你的應用程序中所需要的模塊(即靜態庫或動態庫)。

Application.mk文件通常被放置在$PROJECT/jni/Application.mk下,$PROJECT指的是您的項目。

另一種方法是將其放在頂層的子目錄下:
$NDK/apps目錄下,例如:
$NDK/apps/<myapp>/Application.mk

<myapp>是一個簡稱,用於描述你的NDK編譯系統的應用程序(這個名字不會生成共享庫或者最終的包)

下面是Application.mk中定義的幾個變量。

APP_PROJECT_PATH
這個變量是強制性的,並且會給出應用程序工程的根目錄的一個絕對路徑。這是用來復制或者安裝一個沒有任何版本限制的JNI庫,從而給APK生成工具一個詳細的路徑。

APP_MODULES
這個變量是可選的,如果沒有定義,NDK將由在Android.mk中聲明的默認的模塊編譯,並且包含所有的子文件(makefile文件)
如果APP_MODULES定義瞭,它不許是一個空格分隔的模塊列表,這個模塊名字被定義在Android.mk文件中的LOCAL_MODULE中。註意NDK會自動計算模塊的依賴

註意:NDK在R4開始改變瞭這個變量的行為,再次之前:
 – 在您的Application.mk中,該變量是強制的
 – 必須明確列出所有需要的模塊

APP_OPTIM
這個變量是可選的,用來定義“release”或"debug"。在編譯您的應用程序模塊的時候,可以用來改變優先級。

“release”模式是默認的,並且會生成高度優化的二進制代碼。"debug"模式生成的是未優化的二進制代碼,但可以檢測出很多的BUG,可以用於調試。

註意:如果你的應用程序是可調試的(即,如果你的清單文件中設置瞭android:debuggable的屬性是"true")。默認的是"debug"而不是"release"。這可以通過設置APP_OPTIM為"release"來將其覆蓋。

註意:可以在"release"和"debug"模式下一起調試,但是"release"模式編譯後將會提供更少的BUG信息。在我們清楚BUG的過程中,有一些變量被優化瞭,或者根本就無法被檢測出來,代碼的重新排序會讓這些帶阿彌變得更加難以閱讀,並且讓這些軌跡更加不可靠。

APP_CFLAGS
當編譯模塊中有任何C文件或者C++文件的時候,C編譯器的信號就會被發出。這裡可以在你的應用中需要這些模塊時,進行編譯的調整,這樣就不許要直接更改Android.mk為文件本身瞭

重要警告:+++++++++++++++++++++++++++++++++++++++++++++++ + +
+
+ 在這些編制中,所有的路徑都需要於最頂層的NDK目錄相對應。
+ 例如,如果您有以下設置:
+
+sources/foo/Android.mk
+sources/bar/ Android.mk
+ 編譯過程中,若要在foo/Android.mk中指定你要添加的路徑到bar源代碼中,
+ 你應該使用
+ APP_CFLAGS += -Isources/bar
+ 或者交替:
+ APP_CFLAGS += -I $(LOCAL_PATH )/../bar
+
+ 使用'-l../bar/'將不會工作,以為它將等同於"-l$NDK_ROOT/../bar"
++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++
註意:在Android的NDK 1.5_r1,隻適用於C源文件,而不適合C++。
這已得到糾正,以建立完整相匹配的Andr​​oid系統。

APP_CXXFLAGS
APP_CPPFLAGS的別名,已經考慮在將在未來的版本中廢除瞭

APP_CPPFLAGS
當編譯的隻有C++源文件的時候,可以通過這個C++編譯器來設置

註意:在Android NDK-1.5_r1中,這個標志可以應用於C和C++源文件中。並且得到瞭糾正,以建立完整的與系統相匹配的Android編譯系統。你先可也可以使用APP_CFLAGS來應用於C或者C++源文件中。
建議使用APP_CFLAGS

APP_BUILD_SCRIPT
默認情況下,NDK編譯系統會在$(APP_PROJECT_PATH)/jni目錄下尋找名為Android.mk文件:
$(APP_PROJECT_PATH)/jni/Android.mk

如果你想覆蓋此行為,你可以定義APP_BUILD_SCRIPT來指定一個備用的編譯腳本。一個非絕對路徑總是被解釋為相對於NDK的頂層的目錄。

APP_ABI
默認情況下,NDK的編譯系統回味"armeabi"ABI生成機器代碼。喜愛哪個相當於一個基於CPU可以進行浮點運算的ARMv5TE。你可以使用APP_ABI來選擇一個不同的ABI。

比如:為瞭在ARMv7的設備上支持硬件FPU指令。可以使用
APP_ABI := armeabi-v7a

或者為瞭支持IA-32指令集,可以使用
APP_ABI := x86

或者為瞭同時支持這三種,可以使用
APP_ABI := armeabi armeabi-v7a x86

APP_STL
默認情況下,NDK的編譯系統為最小的C++運行時庫(/system/lib/libstdc++.so)提供C++頭文件。
然而,NDK的C++的實現,可以讓你使用或著鏈接在自己的應用程序中。
例如:
APP_STL := stlport_static    –> static STLport library
APP_STL := stlport_shared    –> shared STLport library
APP_STL := system            –> default C++ runtime library

下面是一個Application.mk文件的示例:
APP_PROJECT_PATH := <path to project>

發佈留言