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

AndroidアプリのソースコードにJNIを組み込むには？

nativeメソッドの宣言

　JNIを使用するには、「native」というキーワードを持つメソッドをクラス内に宣言します。今回は、以下の2つを宣言しました。

private native String hello();

private native void effect(int fireLevel, int width, int height, int[] image, int[] pallet, int[] seedparam, int[] color);

　1つ目はお約束のHello Worldです。2つ目は、実際の炎のエフェクトの処理を行わせるJNIメソッドです。

ライブラリのロード

　nativeメソッドの実際の処理が実装されているネイティブライブラリをSystem.loadLibrary(String)でロードする必要があります。

static {
    System.loadLibrary("FireEffect");
}

　今回は、static節で読み込むことにしました。ライブラリの名前は「FireEffect」とします。

static {
    System.loadLibrary("FireEffect");
}

javahコマンドでヘッダファイル生成

　ここまで完了したら、コンパイルされたクラスファイルに対してJDK付属のjavahコマンドを使用します。

javah com.example.android.livewallpaper2.FireEffect

　カレントディレクトリにcom_example_android_livewallpaper2_FireEffect.hというヘッダファイルが作成されるので、これをベースにC/C++の実装を行います。

　次はNDK側の作業です。

Android NDKのセットアップ

　2010年3月17日現在のNDKの指針版はr3ですが、2月28日の原稿執筆時時点での最新版は、1.6r1（r2）でした。各プラットフォーム向けのバイナリが提供されていて、今回のサンプルでは、1.6r1のWindows版を使用しました。

図　1.6r1（r2）のダウンロードページ（2月28日）

ダウンロード・展開

　ダウンロードしたzipファイルを任意のフォルダに展開します。今回は、C:\ android-ndk-1.6_r1（以降、「NDKホームディレクトリ」）に展開したものとして話を進めます。

Cygwinのセットアップ

　Windows版のAndroid NDKを使用するには、別途Cygwinが必要です。Cygwinはデフォルトのインストールオプションに加え、makeが必要です。

初回セットアップ

　Cygwinを起動し、NDKホームディレクトリに移動し、以下のコマンドを入力します。

bash ./build/host-setup.sh

　これで、NDKを使用する準備が整いました。

Android NDKの中身はどうなっている？

　Android NDKのビルド対象は、NDKホームディレクトリ以下の「apps」ディレクトリです。ここにADTで作成したプロジェクト（または、そのシンボリックリンク）があると非常に便利です。

　Windows Vista以降であれば、mklinkコマンド（またはエクスプローラの機能）を、Windows XPであれば「Windows Server 2003 Resource Kit Tools」などに含まれるlinkdを使用してシンボリックリンク（または、ジャンクション）を作成するとよいでしょう。

　NDKを使用するには、「Application.mk」「Android.mk」という名前の設定ファイルを用意する必要があります。

NDKホームディレクトリ
  + apps
    + <プロジェクトディレクトリ>
      + Application.mk
      + jni
        + Android.mk

　1つはプロジェクトディレクトリ直下、もう1つはプロジェクトディレクトリ配下に作成した「jni」ディレクトリ内です。

アプリの定義を記す「Application.mk」

　Application.mkはアプリケーションの定義を行います。

　今回は、以下のように定義しています。

APP_PROJECT_PATH := $(call my-dir)
APP_MODULES      := FireEffect

　APP_MODULESは、Javaの「System.loadLibrary(String)」と合わせる必要があります。APP_PROJECT_PATHの$(call my-dir)は、NDKが提供するマクロで、この場合は、そのファイルの存在する場所に置き換えられます。次ページでは、「Android.mk」にファイルやライブラリの情報を定義し、コンパイルやパッケージングを行ってみましょう。最後に、JNIとNDKの注意点もお話しします。

    jni/foo/Android.mk
    jni/foo/lib1/Android.mk
    jni/foo/lib2/Android.mk

include $(call all-subdir-makefiles)