Andorid Studio NDK開發-Hello World

介紹了在Android Studio中配置NDK的開發環境:Android Studio NDK開發-環境配置,NDK開發環境配置完成之后,就要寫一下著名的Hello World程序了。
在開始之前需要先介紹下Java和c/c++通信:JNI,JNI(Java Native Inteface)是Java平臺的一部分,它允許Java代碼和其他語言寫的代碼進行交互。尤其是c/c++,但是并不妨礙你使用其他語言,只要調用約定支持就可以了。NDK上Java和c/c++有兩種交互方式:

  • 使用c/c++實現"natvie methods",在Java中通過預先定義好的規則來調用
  • JNI支持c/c+通過一定的規則直接訪問Java中的類,常量,變量等

這里使用的是第一種交互方式,即Java調用c/c++。

創建JNI目錄

打開Android Studio,新建一個項目,右鍵點擊App(對應的module)新建一個JNI目錄:

新建JNI目錄
新建JNI目錄

操作步驟:App->New->Folder->JNI Folder
main目錄中就會出現一個jni目錄:
jni目錄
jni目錄

新建Java類

新建一個HelloJni.java的類,用來和NDK交互:

package com.example.jjz.jni;
public class HelloJni {
    //定義一個jni的方法
    public native String sayHello();

}

HelloJni中使用關鍵詞native定義了一個方法,native:一個Natvie Method就是一個Java調用非Java代碼的接口,該方法的實現由c/c++實現。
方法定義完之后可以看到一個提示,沒有sayHello的實現。

沒有實現
沒有實現

這是因為并沒有實現對應的c/c++的方法,下面就需要使用c/c++使用sayHello方法。

gradle中支持NDK

Android Studio從1.3開始就支持了對于NDK的開發,可以在gradle配置NDK的開發選項,首先在bulid.gradle中設置ndk的的moduleName:

defaultConfig {
    applicationId "com.example.jjz.jni"
    minSdkVersion 15
    targetSdkVersion 23
    versionCode 1
    versionName "1.0"
    //指定.so的目錄
     sourceSets.main{
        jniLibs.srcDir 'src/main/libs'
    }
    ndk{
        moduleName 'hello'
    }
}

在進行同步gradle的時候出現了一個錯誤:

NDK integration is deprecated in the current plugin
set "android.useDeprecatedNdk=true"in gradle.properties to continue using the current NDK integration

根據提示需要在gradle.properties中設置android.useDeprecatedNdk=true

生成.h文件

Java中使用調用NDK的方法,要先生成.h頭文件,JNI的.h文件規則:

  1. 方法的關鍵詞使用JNIEXPORT
  2. 方法的返回值根據預先定好的規則使用對應的類型比如:int要使用jint
  3. 被轉換的Java類要全路徑進行轉換,方法名中必須有類的完整包名,.變成_
  4. jni的方法名還必須包含類名和類的方法名,也是使用_分割

例如上面的sayHello方法轉換為JNI的方法為:

JNIEXPORT jint JNICALL
Java_com_example_jjz_jni_HelloJni_sayHello(JNIEnv *env, jobject instance, jint a) {
}

這種定義規則很復雜,不容易手寫,還好可以通過javah命令自動生成。
在app/目錄下運行命令:

javah -d src/main/jni/ -classpath build/intermediates/classes/debug/ com.example.jjz.jni.HelloJni

其中-d是生成.h文件的保存目錄。
-classpath是指定.class所在的目錄,項目build成功之后,會在build/intermediates/classes/debug/目錄里生成.class文件。
com.example.jjz.jni.HelloJni是包名加上類名。
就可以在jni目錄下得到一個com_example_jjz_jni_HelloJni.h的文件,文件內容如下:

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/
* Header for class com_example_jjz_jni_HelloJni */

#ifndef _Included_com_example_jjz_jni_HelloJni
#define _Included_com_example_jjz_jni_HelloJni
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_example_jjz_jni_HelloJni
 * Method:    sayHello
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_example_jjz_jni_HelloJni_sayHello
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif

實現.h文件

.h文件只是一個聲明文件,還需要實現.h文件中定義的方法

  • 添加.c文件
    新建文件com_example_jjz_jni_HelloJni.c用來文件實現sayHello方法。

      #include "com_example_jjz_jni_HelloJni.h"
      JNIEXPORT void JNICALL JNIEXPORT jstring JNICALL Java_com_example_jjz_jni_HelloJni_sayHello(JNIEnv *env, jobject object) {
      return (*env)->NewStringUTF(env, "Hello Jni");
      }
    
  • 添加Application.mk文件

      APP_MODULES := hello
      APP_ABI :=all
    
  • 添加Android.mk文件

      LOCAL_PATH := $(call my-dir)
      include $(CLEAR_VARS)
      LOCAL_MODULE :=hello
      LOCAL_SRC_FILES =: com_example_jjz_jni_HelloJni.c
      include $(BUILD_SHARED_LIBRARY)
    

編譯調用

文件添加完成之后就可以使用NDK編譯了,在../app/src/main/jni目錄下,運行命令

ndk-build

運行之后可以看到生成的libhello.so文件:

libhello.so
libhello.so

注意這個時候.so文件已經生成,但是在java中并沒有加載.so類庫,必須加載.so類庫才能被Java使用,加載的方式使用使用函數System.loadLiabrary("hello")

public class HelloJni {
    static {
        //加載.so類庫,加載的名稱去掉lib
        System.loadLibrary("hello");
    }
    public native int sayHello(int a);
}

項目地址:https://github.com/jjz/android/tree/master/Jni

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容