Eclipseを使ったandroid nativeデバッグ
- 2. 目次 1. Androidのデバッグの仕組み 2. EclipseにAndroidのソースを読み込ませる まずは全部 3. EclipseにAndroidのアプリだけのNativeソースを読み込ませる 4. EclipseでNativeアプリをデバッグしてみる 5. EclipseでAndroidJavaフレームワークをデバッグしてみる
- 3. 最初にごめんなさい 今回Windows使っていないです。 環境はUbuntuLinux10.04(Lucid Lynx)で試しています。 Android NDK使っていないです。 （というかNDK使ったことありません） Androidのソースを落として来てください。 (http://source.android.com/source/download.html 参照) 仕組み的にはNDKでも大差無いのではと思います。 Eclipseは3.5(Galileo)、JavaはSun JDK 1.5です。 Ubuntu10.04へのJava1.5のインストールは http://blog.sola- dolphin-1.net/archives/2613458.html を参照してください。
- 5. AndroidのNativeデバッグ ● ターゲット上のGDBServerとホスト上のGDBをTCPで接続 ● ホスト上のGDBはARM向けクロスターゲットデバッガ。PCに入っている x86向けではないことに注意。 Target Android Device process Host PC GDBServer Target Application ADBGDB Eclipse クロスターゲット向け のデバッガ
- 6. AndroidのNativeライブラリデバッグ ● ライブラリをデバッグする場合は別プロセスでGDBServerを立ち 上げて、ターゲットのプロセスにアタッチ。 Target Android Device process Host PC Target Library ADBGDB Eclipse クロスターゲット向け のデバッガ process GDB Server
- 7. AndroidのJavaデバッグ ● DalvikのJDWP(Java Debug Wire Protocol)を使ってTCP経由でリ モートデバッグ。 ● 詳細はソースの/dalvik/docs/debugger.html,debugmon.html参照。 Target Android Device process Host PC DalvikVM Target Android Application ADBJDB Eclipse
- 9. まずEclipseの準備 ● Eclipse3.5(Galileo)をeclipse.orgから取得してください。 ○ubuntu標準の奴は使いません。 ● Eclipseを起動、Install New SoftwareでGalileoのサイトを選 び、CDT(Eclipse C/C++ Development Tools)をインストールし てください。 ● 同じくInstall New Software→Mobile and Device DevelopmentにあるEclipse C/C++ DSF Debugger Integration,Memory View Enhancements,Remote Launchを 入れとくといいかもしれません。(すみません、こいつらが何か詳細 わかってません) ● 他にもSubclipseなりEGitなりFindBugsなりお好きなプラグインを どうぞ。
- 10. Androidのソース落とす ● 落とし方はhttp://source.android.com/source/download. htmlなりhttp://blog.sola-dolphin-1.net/archives/2613458. htmlなり見て下さい。 ● 今回はFroyo(Android2.2)のブランチ、ソース は$HOME/android/myfroyo にあるものとします。 ○もちろんソースを置く場所はご自由に。以降をご自分の環境に 置き換えて読んでください。
- 13. Eclipseのプロジェクトに読み込ませる ● すでにMakefileがあるので、Makefile projectのEmpty Projectを選択。Use default locationのチェックを外し、 Androidのソース位置をLocationに設定。
- 14. Eclipseのプロジェクトに読み込ませる ● Finishを押してしばし待ちます。C/C++ファイルのインデックスの 生成にそれなりに時間がかかります。 ● バックグラウンドタスクも完了し、無事読み込まれたら Project→Properties→C/C++ Buildを選択、Behaviourタブを 選択。 ● Use Parallel Buildをチェックし、Use Parallel Jobsに並列ビル ドするプロセス数を設定。（make の -jオプション。 -j8は速いで す。） ● Build（Incremental build）のallを削除。AndroidのMakefile にはmake allの定義がありません。
- 15. Eclipseのプロジェクト設定
- 16. Eclipseでプロジェクトをビルド ● ここまで設定するとProject→Build Projectでビルドできます。 ● ソース全体をビルドするので時間かかります。 ● ProjectのBuild Automaticallyのチェックは外しといたほうがよ いかも。
- 21. Nativeアプリの配置例 ● HelloWorldアプリはこんな 感じで配置。 ● build/build.sh ○ Eclipse向けのビルドスクリプト 実 行権限を付加しておくこと ● libhelloworld ○ ログ書き込み処理を行うstaticラ イブラリ ● main ○ アプリのメイン関数 ● Android.mk ○ 各ディレクトリのビルドスクリプト
- 23. Eclipseのパス設定 ● ソースを全部読み込ませた場合と違い、フレームワークのインク ルードファイルを自動でインデックス化してくれない。 ● なので、フレームワークのインクルードディレクトリを Project→Propertiesで次ページのように設定するとインクルード ファイルの依存関係をEclipseが解決してくれるようになる。 ● ただし、ビルド時の依存解決は手動で書くAndroid.mkに必要な インクルードディレクトリを定義することに注意。Eclipseはビルドの 依存関係は解決してくれません。
- 24. Eclipseのパス設定
- 26. HelloWorldアプリ ● 今回のアプリは以下の通り ● /Android.mk include $(all-subdir-makefiles) ● /main/main_helloworld.c #include <helloworld.h> int main(int argc, char** argv) { writeLog(); return 0; }
- 27. HelloWorldアプリ ● /main/Android.mk LOCAL_PATH:= $(call my-dir) include $(CLEAR_VARS) LOCAL_SRC_FILES:= main_helloworld.c LOCAL_STATIC_LIBRARIES += libhelloworld LOCAL_SHARED_LIBRARIES:= libcutils LOCAL_C_INCLUDES:= $(LOCAL_PATH)/../libhelloworld LOCAL_MODULE:= helloworld include $(BUILD_EXECUTABLE)
- 28. HelloWorldアプリ ● /libhelloworld/helloworld.c #define LOG_TAG "HELLOWORLD" #include <helloworld.h> #include <cutils/log.h> void writeLog() { int i = 0; for(;i < 5; i++) { LOGD("Hello Android World. :%d", i); } }
- 29. HelloWorldアプリ ● /libhelloworld/helloworld.h #ifndef HELLOWORLD_H_ #define HELLOWORLD_H_ void writeLog(); #endif /* HELLOWORLD_H_ */
- 30. HelloWorldアプリ ● /libhelloworld/Android.mk LOCAL_PATH:= $(call my-dir) include $(CLEAR_VARS) LOCAL_SRC_FILES:= helloworld.c LOCAL_SHARED_LIBRARIES:= libcutils LOCAL_MODULE:= libhelloworld include $(BUILD_STATIC_LIBRARY)
- 31. HelloWorldアプリ ● /build/build.sh #!/bin/bash source ~/android/myfroyo/build/envsetup.sh cd ~/android/myfroyo/external/helloworld mm
- 32. envsetup.shの便利なコマンド ● Androidの/build/envsetup.shには色々便利なコマンドがありま す。これらのコマンドを使うには $source build/envsetup.sh を 実行します。 ○envsetup.shは実行権限が無いので、sourceコマンドで読み 込ませます。 ● croot ソースツリーのトップに移動 ● cgrep ソースツリーのC/C++ファイルからgrep ● jgrep ソースツリーのJavaファイルからgrep ● resgrep ソースツリーのres/*.xmlからgrep ● godir 指定した名前のファイルを含むディレクトリに移動 ● m ソース全体のビルド ● mm 現在のディレクトリ以下をビルド（そのディレクトリにAndroid.mkが必要） ● mmm 現在のディレクトリから相対パスで指定したディレクトリ以下をビルド ● choosecombo ビルドターゲット用の環境変数を設定する(lunchの方が便利そう)
- 33. アプリのビルド ● EclipseでProject→Build Projectとやるとビルドされます。 (build/build.shを呼んでいるだけです) ● ビルドされたアプリはデバッグシンボル付きが out/target/product/generic/symbols/system/binに、デ バッグシンボル無しが out/target/product/generic/system/bin に配置されます。
- 34. Nativeのビルド出力 ● Nativeアプリ/ライブラリは一般的に以下の手順でビルドされま す。 ● out/target/product/generic/objの下でオブジェクトファイル がコンパイルされる。アプリはEXECUTABLES、ライブラリは静的 がSTATIC_LIBRARIES、動的がSHARED_LIBRARIES以下 にそれぞれのディレクトリが生成されます。 ○helloworldの場合、 out/target/product/generic/obj/EXECUTABLES/ helloworld_intermediates
- 35. Nativeのビルド出力 ● それぞれのディレクトリのLINKEDディレクトリにデバッグシンボル 付きバイナリがリンクされます。 ● stripコマンドでデバッグシンボルが取り除かれたバイナリが各 ディレクトリに配置されます。 ○helloworldの場合、デバッグシンボル付きバイナリは out/target/product/generic/obj/EXECUTABLES/ helloworld_intermediates/LINKED に、 デバッグシンボル無しは out/target/product/generic/obj/EXECUTABLES/ helloworld_intermediates に出来ます。
- 37. HelloWorldの実行結果 ● デバイスやエミュレータを起動し、adbで接続できることを確認しま す。 ● helloworldのバイナリをadbでデバイスに転送します。 ○adb push helloworld /data/local/tmp ● adbでデバイスにログインし、アプリを実行します。 ○adb shell chmod +x /data/local/tmp/helloworld ○adb shell /data/local/tmp/helloworld ● logcatでログにHelloWorldの結果が出力されているのを確認し ます。
- 38. HelloWorldの実行結果 ● adb logcatした結果 D/HELLOWORLD( 366): Hello Android World. :0 D/HELLOWORLD( 366): Hello Android World. :1 D/HELLOWORLD( 366): Hello Android World. :2 D/HELLOWORLD( 366): Hello Android World. :3 D/HELLOWORLD( 366): Hello Android World. :4
- 41. ファイルのデバイスへの転送 ● まずはgdbserverを転送します。 ○adb push prebuilt/android-arm/gdbserver/gdbserver /data/local/tmp ○adb shell chmod +x /data/local/tmp/gdbserver ● 次にデバッグシンボル付き実行ファイルを転送します。 ○adb push out/target/product/generic/symbols/system/bin /helloworld /data/local/tmp ○adb shell chmod +x /data/local/tmp/helloworld
- 42. GDBServerの起動 ● GDBServerをadb経由で起動します。 ○adb shell /data/local/tmp/gdbserver :5039 /data/local/tmp/helloworld ● これでデバイスのポート5039でgdbserverが起動し、接続待ち 状態になります。
- 43. GDBServerのポートをフォワード ● ADBを使ってホストのポートをGDBServerの待ち受けポートに転 送します。 ○adb forward tcp:5039 tcp:5039 ● ホストのTCPポート5039への接続がデバイスのTCPポート5039 に転送されます。 ● ファイルの転送からポートのフォワードまではスクリプト化しておく と楽でしょう。
- 44. Eclipseのデバッグ構成 ● Eclipseのデバッグの構成を開き、C/C++ Applicationに新しい構 成を作成します。 ○ C/C++ Remote Applicationでは無いので注意。 ● MainタブのC/C++ Applicationにデバッグシンボル付きバイナリ の位置を設定します。
- 45. Eclipseのデバッグ構成 Debuggerタブ ● デバッグ構成のDebuggerタブでDebuggerにgdbserver Debuggerを選択、Stop on start at mainにチェックします。 ● MainタブのGDB debuggerにクロスターゲットデバッガを設定し ます。
- 47. Eclipseのデバッグ構成 Debuggerタブ ● ConnectionタブでTypeをTCP、Port Numberを5039に設定し ます。
- 52. おまけですが... ● EclipseにAndroidのソースを読み込ませて、Javaフレームワーク をデバッグすることができます。 ● DDMSにプロセス毎のDalvik JDWP待ち受けポートが表示され るので、Javaリモートアプリケーションのデバッグ機能を使って接 続します。
- 54. プロジェクトを読み込むときの注意 ● 同一のディレクトリを複数のプロジェクトで共有することはできませ ん。 ○外部のソースをインポートしてプロジェクトを作成した場合、. projectファイルがディレクトリに作成されるため、一つのディレ クトリは一つのプロジェクトとしか結びつかない。 ● シンボリックリンクを使ってみたが、どうも深いディレクトリにある POLICY系のファイルを読んでくれずに、makeするとビルドエラー が発生。 ● しょうがないので、C向けとJava向けにFroyoのディレクトリを別に 作りました... いい対処方法あったら教えてください。
- 58. Javaのデバッグ構成 ● Eclipseのデバッグの構成を開き、Remote Java Applicationに 新しい構成を作成します。 ● 接続先のポートに8603か8700を指定し、デバッグを実行しま す。
- 60. デバッグの実行