Android NDK 開發教程六： application.mk

http://www.imobilebbs.com/wordpress/archives/2934

Android NDK 開發教程六： application.mk

配合android.mk 使用的make 文件還有一個application.mk ，大部分情況無需修改該文件，下面也來自網路翻譯

Application.mk文件

簡介：
—————————–
要將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>