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を指定します。

定義一覧

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

定義	説明
LOCAL_PATH	パスを指定（最初に定義しなければならない）
LOCAL_MODULE	モジュール名を指定
LOCAL_SRC_FILES	ソースファイルを指定
LOCAL_CPP_EXTENSION	C++の拡張子を指定（デフォルトは.cpp）
LOCAL_C_INCLUDES
LOCAL_CFLAGS	Cソースのコンパイルフラグを指定
LOCAL_CXXFLAGS	C++ソースのコンパイルフラグを指定
LOCAL_CPPFLAGS	C/C++両方のソースのコンパイルフラグを指定
LOCAL_STATIC_LIBRARIES	BUILD_STATIC_LIBRARYで指定したモジュールでリンクしたいものを指定。共有ライブラリ作成時のみ指定可能
LOCAL_SHARED_LIBRARIES	このモジュールが実行時に参照する共有ライブラリを指定
LOCAL_LDLIBS	ライブラリビルド時に必要な追加リンクフラグ
LOCAL_ALLOW_UNDEFINED_SYMBOLS	undefined symbolエラーを発生させたくない場合はtrueを指定
LOCAL_ARM_MODE	armかthumbを指定（デフォルトはthumb）
include $(CLEAR_VARS)	LOCA_PATH以外のLOCAL_で始まる定義をクリア
include $(BUILD_SHARED_LIBRARY)	共有ライブラリ作成を指示
include $(BUILD_STATIC_LIBRARY)	静的ライブラリ作成を指示
$(TARGET_ARCH)	ターゲットのアーキテクチャを返す
$(TARGET_PLATFORM)	ターゲットのプラットフォームを返す
$(TARGET_ARCH_ABI)	CPUとABIの名前を返す
$(TARGET_ABI)	「$(TARGET_PLATFORM)-$(TARGET_ARCH_ABI)」という値を返す
表5　Android.mkの定義

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

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

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

make APP=LiveWallpaperSampleWithJNI -B

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

オプション	説明
APP=	プロジェクト名を指定（必須）
V=1	ビルド時に詳細な出力を行う
-B	必ずリビルドする
表6　NDKの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がサポートされます。提供されるヘッダファイルは以下の通りです。

• <cstddef>
• <new>
• <utility>
• <stl_pair.h>

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

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

Android固有のログサポート

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

関数名	説明
__android_log_write	文字列出力
__android_log_print	文字列出力（printf相当）
__android_log_vprint	文字列出力（va_list版）
__android_log_assert	アサート
表7　ログの定義

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

「次回」へ

「Androidで動く携帯Javaアプリ作成入門」バックナンバー

• グーグルのAPIを使うときに欠かせないGoogle OAuthの作り方と使い方
• 細か過ぎて伝わってないけど開発者が知っておきたいAndroid Mの新機能まとめ
• 腕時計から電話をかけるAndroid Wearアプリの作り方
• Android Wear用アプリの花形、時計アプリ「Watch Face」の基本的な作り方
• Android 5.0発表＆スマホと連動する音声認識Android Wearアプリの作り方
• ウェアラブル端末用Android Wearアプリ開発の基礎知識
• 変わらないと生き残れないAndroid Lの新機能まとめ
• Android WearやIoTで注目のAndroidセンサー機能8選
• ウェアラブル時代に見直したいAndroidの加速度／重力センサー、ジャイロスコープ
• あなたの知らないAndroid SDKの便利tools、14選まとめ
• Android 4.4のメモリ使用状況を把握する3つのツールの使い方
• Androidでリアルタイムマルチプレーゲームを開発するには
• 低性能端末でも使えるか？ Android 4.4 KitKatの新機能39選
• もはや無料BaaS。ゲーム以外でも使いたくなるGoogle Play Game Servicesのデータ管理機能
• アプリにGoogle+のソーシャルグラフを持ち込めるGoogle Play Game Servicesの基礎知識
• あなたのアプリはクラウドにデータをバックアップできますか？
• Eclipse ADTに代わるIDEとなるか？ Android Studioの基礎知識
• ActionBarで、アプリのUIはこんなにスマートになる
• Android 4.x時代のアプリにないと残念なActionBarとは
• 動的クラスローディングでAndroidアプリ“裏”開発
• Android 4.xのAndroidビームをアプリに組み込むには
• AndroidアプリでNFCタグを読み書きするための基礎知識
• 新タブレット時代を見据えるAndroid 4.2の新機能9選
• Androidからイヤフォンやヘルス機器とBluetooth通信するには
• Bluetoothを使ってAndroidアプリ同士で通信するには
• Androidアプリをアプリ内購読に対応してもうける方法
• 開発者が知らないと残念過ぎるAndroid 4.1の新機能36選
• Androidのプロセス間通信を自由自在にするAIDL
• Android 4.0のサービス／プロセス間通信の基本
• Androidアプリでマルチメディアを扱うための基礎知識
• Androidのウィジェットにノーティフィケーションするには
• Android 4.0で注目の顔認識をアプリに組み込むには
• Android 4.0でアプリ開発を始めるための環境構築
• 開発者が知らないと損するAndroid 4.0の新機能44選
• Android Compatibility packageで2.x系でもマルチサイズ対応
• Androidの画面の大きさの違いを解決するFragments
• Android 3.0の新APIで簡単ドラッグ＆ドロップ実装
• 開発者が知って得するAndroid 2.3の新機能18選
• アニメーションでAndroidに独創的な画面エフェクトを
• Androidアプリで“アニメーション”するための基礎知識
• XMLレイアウトでAndroidアプリに“設定画面”を追加
• 開発者が知っておきたいAndroid 2.2の新機能12連発
• もはやケータイに必須のカメラをAndroidで制御しよう
• 地図/位置情報/GPSを使うAndroidアプリを作るには
• Android NDKでJNIを使用してアプリを高速化するには
• Android 2.1の新機能「Live Wallpaper」で作る、美しく燃える“待ち受け”
• iPhoneより多彩なAndroidのセンサをアプリで操作
• SurfaceViewならAndroidで高速描画ゲームが作れる
• Android 1.6のジェスチャーとテキスト読み上げを使う
• Androidのホーム画面に常駐するアプリを作るには
• Netbookにも広まるAndroidで、かつてないWeb体験を
• アプリを国際化してAndroid Marketから世界へ発信
• 常駐アプリが作成できるAndroidの“サービス”とは
• AndroidでSQLiteのDB操作をするための基礎知識
• Androidアプリの使いやすさを左右する5つのレイアウト
• 簡単でワクワクするAndroidウィジェット10連発！
• ブラウザや地図、ストリートビューの基、Intentとは？
• Androidアプリ作成の基本“Activity”とは何か？
• Android Market配布を目指しEclipseでHelloWorld！