NDK开发入门

一、安装与配置

首先我们在Android Studio下新建一个安卓项目。然后打开Project Structure界面,如下: 

是我的 这里写图片描述

在SDK Location目录下,有SDK和NDK的路径,而这里我们暂时还未下载配置过NDK,故我们需要点击Download Android NDK来进行下载(Android Studio还是很强大的,相比Eclipse能省不少事)。这里Android Studio会下载最新版本的NDK进行安装,默认会下载保存在SDK的路径下。我们在上图中还能看到有一段介绍文字,说SDK以及NDK的路径配置会保存在local.properties文件内,安装完成后我们刷新Project,进local.properties文件查看也能看到SDK与NDK的路径。 
这里写图片描述

这里写图片描述

NDK下载配置完成之后,需要在gradle.properties文件中加上一行:

android.useDeprecatedNdk=true

注意:如果报一下错误。

Error: Flag android.useDeprecatedNdk is no longer supported and will be removed in the next version of Android Studio.  Please switch to a supported build system.
  Consider using CMake or ndk-build integration. For more information, go to:
   https://d.android.com/r/studio-ui/add-native-code.html#ndkCompile
   To get started, you can use the sample ndk-build script the Android
   plugin generated for you at:
   E:\SwimmingSpace\ndktest\build\intermediates\ndk\debug\Android.mk
  Alternatively, you can use the experimental plugin:
   https://developer.android.com/r/tools/experimental-plugin.html
  To continue using the deprecated NDK compile for another 60 days, set 
  android.deprecatedNdkCompileLease=1570668052257 in gradle.properties

      在gradle.properties文件里把android.useDeprecatedNdk去掉换成android.deprecatedNdkCompileLease=1570668052257就行了

接下来,我们借助强大的Android Studio的插件功能,在External Tools下配置两个非常有用的插件。进入Settings–>Tools–>ExternalTools,点击+号增加。 

这里写图片描述

这里写图片描述

javah -jni命令,是根据java文件生成.h头文件的,会自动根据java文件中的类名(包含包名)与方法名生成对应的C/C++里面的方法名。下面是参数配置及其含义: 
1. Program: $JDKPath$\bin\javah.exe 这里配置的是JDK目录下的javah.exe的路径。 
2. Parametes: -classpath . -jni -d $ModuleFileDir$/src/main/jni $FileClass$ 这里$FileClass$指的是要执行操作的类名(即我们操作的文件),$ModuleFileDir$/src/main/jni表示生成的文件保存在这个module目录的src/main/jni目录下。 
3. Working: $ModuleFileDir$\src\main\java module目录下的src\main\java目录(不是很理解)。 
使用方式:选中java文件—>右键—>External Tools—>javah-jni,将生成jni文件夹以及文件夹下的 包名.类名的.h头文件 (名字过长,我们可以自己重命名)。 

这里写图片描述
ndk -build命令,是根据C/C++文件生成so文件的。下面是参数配置及其含义: 
1. Program: F:\apk\sdk\ndk-bundle\ndk-build.cmd 这里配置的是ndk下的ndk-build.cmd的路径(根据实际情况填写)。 
2. Working: $ModuleFileDir$\src\main\ 
 

在build.gradle中的android添加

    sourceSets {
        main() {
            jniLibs.srcDirs = ['src/main/libs']
        }
    }

要不为弹出ANR运行错误提示找不到.so库。

二、简单实例

1、创建一个访问本地C/C++方法的java类

package cyh.com.ndk_demo;

public class JniTest {

    static {
        System.loadLibrary("JniTest");

    }
    public static native  String get();
}

     注意JniTest这个Library名字,之后在Android.mk中还会需要用到,要保持一致。该类提供了一个static的native方法,该方法将用来返回一个字符串。然后对该文件执行javah -jni操作,选中java文件—>右键—>External Tools—>javah-jni,生成对应的.h头文件。 

如图,已经根据我们的java类生成了对应的.h文件,文件名为包名_类名.h,里面只有一个方法,返回值为String(jstring),方法名为Java_类的包名_类名_方法名(包名中的分级不是用.而是_),前面两个参数是C++里面必须有的(JNIEnv代表指向JVM的指针,jclass是调用该方法的java对象),第三个就是我们java类的方法里面的参数Object。注意,这是java函数与C++函数对应的静态注册方法,即通过特定的规则来写,此处方法名可以随意起名字,然后还可以用动态注册的方式关联两个方法(显然,静态注册要简单一些)。 
2、然后我们新建一个C文件,取名为test.c,写上需要include的文件,从.h文件中复制方法过来(方法名、参数类型、返回值等必须一致!血与泪的教训)。 

至此,.h文件和c文件均已完成,接下来还需要在这个jni目录下增加两个文件,Android.mk和Application.mk。 
Android.mk,注意LOCAL_MODULE的值与之前的名字相对应,LOCAL_SRC_FILES的值写c++文件的名字,这两个值成对设置,可设置多组。(:=是赋值的意思,$是引用某变量的值。)

  1. LOCAL_PATH := $(call my-dir)     // 设置当前的编译目录(Android.mk所在的目录) 
  2. include $(CLEAR_VARS)            // 清除LOCAL_XX变量(LOCAL_PATH除外)
  3. LOCAL_MODULE := JNI_ANDROID_TEST  // 指定当前编译模块的名称  
  4. LOCAL_SRC_FILES := jnitest.cpp    // 编译模块需要的源文件
  5. include $(BUILD_SHARED_LIBRARY) // 指定编译出的库类型,BUILD_SHARED_LIBRARY:动态库;BUILD_STATIC_LIBRARY:静态库, BUILD_EXECUTEABLE指:可执行文件

 

       Application.mk,APP_ABI有四种类型(默认armeabi),armeabi、armeabi-v7a、x86、mips,设置时以空格隔开,all表示所有。该文件中有个可选配置的APP_MODULES,类似于上面Android.mk文件中的LOCAL_MODULE,以空格隔开,且会覆盖掉Android.mk文件中的LOCAL_MODULE设置(比如Android.mk文件中的写了两个jni库的配置,LOCAL_MODULE := JNI1、LOCAL_MODULE := JNI2,而Application.mk中设置的APP_MODULES := JNI1,则只能生成JNI1的so文件,要生成JNI2的so文件的时候会报错,除非写成APP_MODULES := JNI1 JNI2,这里我们直接省略默认使用Android.mk中的)。
     APP_ABI := all

接下来我们需要对C文件执行ndk-build操作,使用方式:选中C/C++文件—>右键—>ExternalTools—>ndk-build,生成相应的so文件。 

如图,在main/libs目录下生成了多个so文件,名字为lib+我们指定的库名,同时还生成了obj文件夹。

3、在MainActivity中调用C方法即可。

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        //打印信息
        Log.e("Message", JniTest.get());
    }

  以上内容大部分来自网络,注意参考:https://blog.csdn.net/xiaoyu_93/article/details/52870395

猜你喜欢

转载自blog.csdn.net/u010194538/article/details/102474449