Android NDKでJNIを使用してアプリを高速化するには：Androidで動く携帯Javaアプリ作成入門（15）（3/3 ページ）

ファイルやライブラリの情報を定義する「Android.mk」

　Android.mkは、$( APP_PROJECT_PATH)/jni/にあり、ファイルやライブラリの情報を定義します。下記は、今回使用するAndroid.mkの内容です。

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := FireEffect
LOCAL_SRC_FILES := FireEffect.c
LOCAL_LDLIBS := -llog
LOCAL_ARM_MODE := arm
include $(BUILD_SHARED_LIBRARY)

LOCAL_PATH

　これは、Android.mkの最初に定義しなければなりません。my-dirマクロで現在のディレクトリを指定しています。

include $(CLEAR_VARS)

　LOCAL_PATHを除くLOCAL_xxxの定義をクリーンアップします。複数のライブラリを使用する場合などに、「先に読み込んだAndroid.mkのLOCAL_xxxの値が不本意に使用されてしまう」という障害を防ぐためにも、定義しておくことを強く推奨します。

LOCAL_MODULE

　モジュール名を指定します。この名前はユニークでなければならず、スペースを含んではいけません。NDKのビルドシステムは、ここで与えられた名前にプレフィックスとサフィックスを自動的に付与します。

　今回の場合は、「libFireEffect.so」という共有ライブラリを生成します（もしここで、「libFireEffect」という名前を指定した場合、生成される共有ライブラリは「liblibFireEffect.so」ではなく、例外的に「libFireEffect.so」となることに注意してください）。

LOCAL_SRC_FILES

　C/C++のソースリストを指定します。ヘッダファイルは含めません。C++ソースファイルの拡張子は.cppがデフォルトです。

LOCAL_LDLIBS

　自身のライブラリにリンクするライブラリを指定します。今回は、ネイティブでもandroid.util.Log相当のログが出力できるlogライブラリをリンクしています。

LOCAL_ARM_MODE

　より高速なarmモードでコンパイルするように指定します。

include $(BUILD_SHARED_LIBRARY)

　共有ライブラリを作成する際に指定します。静的ライブラリを作成する場合は、BUILD_STATIC_LIBRARYを指定します。

定義一覧

　上記を含むすべての定義を、以下の表にまとめておきますので、参考にしてください。

JNIを使ったAndroidアプリを動かすには

ネイティブコードのコンパイル

　Application.mkとAndroid.mkの準備ができたら、コンパイルを行います。コンパイルは、NDKホームディレクトリで以下のように入力します。

make APP=LiveWallpaperSampleWithJNI -B

　「APP=」以降には、「apps」ディレクトリに配置されているプロジェクトを指定します。makeに渡せるオプションは以下の通りです。

　今回のサンプルだと、ビルド時に以下のようなメッセージが表示されます。

Android NDK: Application LiveWallpaperSampleWithJNI targets platform 'android-7'

　Live Wallpaperはandroid-7の機能であるため、defalut.propertiesに「android-7」と定義されています。一方Android NDK r1は、android-4までしかサポートしていないため、コンパイルが実行できません。

　これを回避するには、NDKでコンパイルする際には、一時的にdefault.properties内部のandroid-7をandroid-4にします。

　コンパイルに成功すると、apps//libs/armeabiにライブラリが生成されます。

アプリのパッケージング

　ネイティブライブラリを.apkにパッケージングするのに、特別な作業は必要ありません。プロジェクトをビルドすれば、自動的にネイティブライブラリがパッケージングされ、特別なことをせずに実行可能です。

Android NDK/JNIを使用する際の注意点

　AndroidでJNI（NDK）を使用する場合、知っておくべきことがいくつかあるので、最後にお話しします。

Cのサポート

　AndroidのCライブラリは「libc」ではなく「Bionic」というAndroid独自の実装です。この実装はANSI C準拠ではないため、ANSI Cにあるはずのヘッダファイルや関数がないことがあります。

　NDKは、Cライブラリを自動でリンク対象にするため、LOCAL_LDLIBSにCライブラリを指定する必要はありません。

　また、<math.h>のために「-lm」を指定する必要はありません。NDKはpthreadを標準でサポートするため、「LOCAL_LDLIBS := -lpthread」は必要ありません。ただし、pthread_cancelはサポートされないので、注意してください。リアルタイム拡張も同様なので、「-lrt」も必要ありません。

　加えて、ワイドキャラクタがサポートされていません。ヘッダファイル <linux/*.h>およびは、将来的に変更される可能性があるため、これらを直接インクルードすることは推奨されません。

C++のサポート

　極めて小さなC++のAPIがサポートされます。提供されるヘッダファイルは以下の通りです。

　また、これらは完全なものではなく、標準として必要なすべての定義を含んでいません。特に、C++の例外とRTTIは使用できません。

　NDKは、C++ライブラリを自動でリンク対象にするため、LOCAL_LDLIBSに「-lstdc++」を指定する必要はありません。

Android固有のログサポート

　は、ネイティブコードからカーネルにログメッセージを送るために使用できる定義を含んでいます。以下にリストします。

　JavaのLogクラスと同じく、プライオリティによる出力制御、タグ指定が行えます。