安卓开发学习之ndk动态注册

背景

前两天我开始了Android开发里ndk开发的学习，其中提到c函数和java的native方法的绑定，是通过c函数的名字进行的，但这样写的话不利于改动，如果我的native方法换名了，或者native方法所在的类换地方了，就要对native方法对应的c函数进行更改，这样的话就不太好。我们应该想办法，让C函数和java方法对两者之间的改动无感知，而这，就是动态注册的目的

步骤

步骤的话，我分之为三步：构造JniNativeMethod映射数组、自定义动态注册函数、自定义实现JNI_OnLoad()函数进行注册。一步步来

构造映射数组

就是构造一个JNINativeMethod数组，里面的元素是我们的java方法和c函数的对应关系，代码如下

JNIEXPORT jstring JNICALL
transfer(JNIEnv *env, jclass type, jstring str); // 提前声明，但未实现

static JNINativeMethod method[] = {
        {"getAppKey", "(Ljava/lang/String;)Ljava/lang/String;", (void*)transfer}
        // jni方法数组，每一个元素表示一个java方法和native函数的对应关系
        // 元素的组成部分：java方法名，java方法签名((方法参数(引用类型后面要加;，基本数据类型及void不用))方法返回值类型(;的用法同前))，对应的native函数名
};

自定义动态注册函数

主要就是寻找类，然后调用api进行动态注册，这里只是进行了封装。代码如下

static int registNatives(JNIEnv* jniEnv) {
    char* className = "com/example/songzeceng/myndkdemo/MyNdkUtil"; // java方法所在的类名
    jclass clazz = (*jniEnv)->FindClass(jniEnv, className);
    if (clazz == NULL) {
        return JNI_FALSE;
    }

    if ((*jniEnv)->RegisterNatives(jniEnv, clazz, method, sizeof(method)/ sizeof(method[0])) < 0) {
        // 真正的动态注册
        return JNI_FALSE;
    }

    return JNI_TRUE;
}

实现JNI_OnLoad函数

上面我们定义了一个动态注册函数，这个函数在哪儿调呢？就是在JNI_OnLoad()函数里面，代码如下

JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM *javaVM, void *other) {
    // 在java文件里调用loadLibrary()时自动调用此方法

    __android_log_print(ANDROID_LOG_INFO, tag, "Jni onload...\n");
    JNIEnv *jniEnv = NULL;

    if ((*javaVM)->GetEnv(javaVM, (void**)&jniEnv, JNI_VERSION_1_6) != JNI_OK) {
        // 注意第二个参数，必须要转换成void**，否则会报错jni UnsatisfiedLinkError: JNI_ERR returned from JNI_OnLoad
        return -1;
    }

    assert(jniEnv != NULL);

    if (registNatives(jniEnv) != JNI_TRUE) {
        return -1;
    }

    return JNI_VERSION_1_6;
}

里面的JNI_VERSION_1_6是jni版本，根据自己的jni版本进行修改。jni的版本获取，可以通过调用下面的函数得到：

jint versionCode = (*jniEnv)->GetVersion(jniEnv);
__android_log_print(ANDROID_LOG_INFO, tag, "Jni version:%d\n", versionCode);

把得出来的十进制数换算成十六进制，凑够8位，如果是0x00010006，就是version_1_6，依次往下类推

验证结果

经过这三步就可以了，我们看一眼java方法和c函数：

java的getAppKey()方法及所在的类：

public class MyNdkUtil {
    private static final String LIB = "native-lib";
    static {
        System.loadLibrary(LIB);
    }

    public static native String getAppKey(String s);
}

C的transfer()函数：

char *getResult(const char *content) {
    if (content == NULL || strlen(content) > 100) {
        __android_log_print(ANDROID_LOG_INFO, tag, "内容无效");
        return NULL;
    }

    int i;
    int len = strlen(content);
    char *result = (char *) malloc((len + 1) * sizeof(char));

    memset(result, 0, sizeof(result));

    for (i = 0; i < len; ++i) {
        int offset = 0;
        if (content[i] >= 'a' && content[i] <= 'z') {
            offset = -32;
        } else if (content[i] >= 'A' && content[i] <= 'Z') {
            offset = 32;
        }
        result[i] = content[i] + offset;
    }

    result[i] = '\0';
    return result;
}

JNIEXPORT jstring JNICALL
transfer(JNIEnv *env, jclass type, jstring str) {
    const char *content = (*env)->GetStringUTFChars(env, str, JNI_FALSE);
    char *result = getResult(content);
    jstring resultJ = (*env)->NewStringUTF(env, result);

    free(content);
    free(result);
    return resultJ;
}

只不过调用了一个普通c函数进行大小写转换而已。

可见C函数和java方法从名字上看已经没有任何联系了，如果要更新关联关系，只需要更改全局的JNINativeMethod数组和自定义动态注册函数里的className就行，很是方便

MainActivity里的测试和运行效果如下：

public class MainActivity extends AppCompatActivity {
    private static final String TAG = "MainActivity";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        String s = MyNdkUtil.getAppKey("I love you son");
        Log.i(TAG, s);
    }
}

效果截图：

其中65542换算成十六进制就是0x00010006，所以jni版本是1.6

结语

动态注册写法虽然复杂些，但用起来却是方便得紧，所以我觉得以后可以多用动态注册进行java方法和c函数的绑定。