基於Android本地代碼生成器詳解

在使用AndroidNDK開發的時候有個事情是很煩人的，那就是創建本地代碼文件夾，生成本地代碼文件和創建本地代碼的編譯文件。特別是實現本地方法的時候，也是比較煩人的，因為本地方法的名字實在是太長了。它的命名規范是：Java_package-name_class-name_method-name(arguments)，稍一不留神就會有拼寫錯誤，而導致長時間的調試。由於不勘忍受這樣的折磨，也為了不重復同樣的事情(DRY-Don't Repeat Yourself)，於是就寫了一個Java程序來做這件事。
這個小工具可以逐個檢查Java文件，並創建含有本地方法文件，也即本地代碼文件，生成Android.mk編譯文件並更新Java文件，添加System.loadLibrary。
具體的原則是這樣：
•每個含有本地代碼的Java文件，生成一個本地文件，其內含有該文件中的所有本地方法
•所生成的本地方法是符合標准的JNI，具體的形式是：
復制代碼 代碼如下:
return-type Java_package-name_class-name_method-name(arguments){
       }

也就是說，所需要做的只是實現這個方法。
•默認本地代碼共享庫的名字是Android項目的名字
有了這個小工具，就可以只在Java中聲明本地方法，運行下這個工具，然後實現本地方法，再編譯就可以了。
可以從<這裡下載>這個小工具。解壓後有三個文件一個是Java源碼，一個是Jar包（genjni.jar)，一個是Shell腳本(genjni.sh)。放上源碼的原因是，如果有興趣的朋友可以進行改進，但是改進後請
發我一份。下載後，最好修改下Shell腳本，把Jar文件的路徑改成具體的存放路徑，否則會報出找不到Jar文件的錯誤。最後把genjni.sh放到~/bin下面，為了使用時方便。使用的時候要在Android項目的根目錄下面運行genjni.sh就可以了。
下面以一個實例方式演示下這個小工具的使用方法：
創建一個項目叫HelloJni，並創建一個HelloJniActivity，在其內聲明一個本地方法getStringFromJni();並用有一個TextView用來顯示getStringFromJni()返回的信息。另一個本地方法getStatusFromJni(int)是為了顯示用的，沒有使用。這是Java代碼：
復制代碼 代碼如下:
package com.hilton.hellojni;
import android.app.Activity;
import android.os.Bundle;
import android.widget.TextView;
public class HelloJniActivity extends Activity {
    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        TextView text = (TextView) findViewById(R.id.text);
        text.setText(getStringFromJni());
    }

    private native String getStringFromJni();
    private native int getStatusFromJni(int type);
}

寫好Java代碼後，從終端進入到項目的根目錄下
復制代碼 代碼如下:
$cd HelloJni
$ls
AndroidManifest.xml  assets  bin  default.properties  gen  proguard.cfg  res  src
$genjni.sh
appplication HelloJni
package name: com.hilton.hellojni
class name: HelloJniActivity
$ls
AndroidManifest.xml  assets  bin  default.properties  gen  jni  proguard.cfg  res  src
$ls jni
Android.mk  HelloJniActivity.c

打開查看Android.mk和HelloJniActivity.c
復制代碼 代碼如下:
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE    := HelloJni
LOCAL_SRC_FILES := HelloJniActivity.c
include $(BUILD_SHARED_LIBRARY)

復制代碼 代碼如下:
#include <jni.h>
jstring Java_com_hilton_hellojni_HelloJniActivity_getStringFromJni(JNIEnv* env, jobject thiz) {
}
jint Java_com_hilton_hellojni_HelloJniActivity_getStatusFromJni(JNIEnv* env, jobject thiz, jint type) {
}

再查看HelloJniActivity.java也被更新了，裡面多了加載共享庫的語句：
復制代碼 代碼如下:
package com.hilton.hellojni;
import android.app.Activity;
import android.os.Bundle;
import android.widget.TextView;
public class HelloJniActivity extends Activity {
    static {
        System.loadLibrary("HelloJni");
    }
    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        TextView text = (TextView) findViewById(R.id.text);
        text.setText(getStringFromJni());
    }

    private native String getStringFromJni();
    private native int getStatusFromJni(int type);
}

剩下的工作就是實現本地方法了。
當然這個工具還是有很多問題，歡迎各位反饋，或給出改進意見。
另外，這個工具是用Java寫的，更好的選擇應該是用腳本來寫，如Perl或Python。還有就是，如果能把這個工具集成到ADT中，或是創造一個完全用於NDK開發的集成工具ANDT，能夠像產生R.java那樣的自動生成本地文件。比如做一個ANDT工具，集成到Eclipse中，能夠自動當Java中有本地方法聲明後就自動生成本地文件和編譯文件。這將是多麼美好的事情啊，將對NDK的開發有重大的幫助。我想，Google應該會做一專門用於NDK開發的Eclipse插件，或是在ADT中加入對NDK的支持，因為NDK開放的接口越來越多，使用NDK開發者也將越來越多，基於NDK開發的應用也將越來越多（2.3及以後的版本，完全可以只用NDK開發出一個Apk，也就是說用純C/C++來開發應用）。希望這一天早些到來。