Android Studio NDK 入门教程（1）--来自C 语言的String

概述

本文讲述如何使用Android Studio 进行NDK开发，适合略有了解C语言的人以及NDK入门开发。

环境配置

1. 安装Android Studio，目前版本是2.1.2。可以去官方下载最新安装包，也可以百度上下载安装之后在线更新，这部分网上教程比较多，学习NDK开发的道友应该不会卡在这里。
2. Android Studio安装完成之后Android SDK也包含在其中，但是不包含NDK。
   
   • 打开File->Settings->Appearance & Behavior->System Settings->Android SDK
   • 选择SDK Tools ，等待检查更新完成，然后勾上LLDB2.1、NDK、CMAKE工具，然后点击Apply，等待下载安装完成，完成之后ndk-bundle在你Android SDK文件夹下。
     
     注意：如果使用其他位置的NDK，需要在项目设置里面配置NDK路径，如果没有CMake可以不下载，CMake并不是NDK的必须插件

创建一个Android程序

1.创建一个名为HelloJni的Android应用程序。此部分和创建正常的Android应用没有区别，过程略。
2.新建HelloJNI.java;

 package com.example.wastrel.hellojni;/** * Created by wastrel on 2016/8/4. */public class HelloJNI {    static {        System.loadLibrary("helloJNI");    }    //Native方法    public static native String getFormCString();}

3.利用javah生成C语言头文件。在执行javah命令之前，应先编译java文件为class文件，执行菜单栏上的Building->Make Project即可。然后打开Android Studio底部的Terminal执行命令：

javah -d src\main\jni\ -classpath build\intermediates\classes\debug com.example.wastrel.hellojni.HelloJNI
注意：最后一个参数改成你对应的包名，也可以参照我另外一篇文章配置一键生成头文件:http://blog.csdn.net/venusic/article/details/51087945
4.完成第三步之后将在jni目录下生成对应的.h头文件。

/* DO NOT EDIT THIS FILE - it is machine generated */#include <jni.h>/* Header for class com_example_wastrel_hellojni_HelloJNI */#ifndef _Included_com_example_wastrel_hellojni_HelloJNI#define _Included_com_example_wastrel_hellojni_HelloJNI#ifdef __cplusplusextern "C" {#endif/* * Class:     com_example_wastrel_hellojni_HelloJNI * Method:    getFormCString * Signature: ()Ljava/lang/String; */JNIEXPORT jstring JNICALL Java_com_example_wastrel_hellojni_HelloJNI_getFormCString  (JNIEnv *, jclass);#ifdef __cplusplus}#endif#endif

注：我们可以看到生成.h文件方法上面的注释包含了Class、Method、Signature三个属性值，函数名命名也有非常严格的规则，包名+方法名的形式命名的。

5.正常情况下生成的头文件打开会有错误，提示找不到jni.h，并且编辑器上方会有英文提示“ndk support is an experimental feature…”。这是因为正式版gradle不能很好的支持NDK开发（事实上AS1.5版本的时候没有问题的，升级到2.0才出现的毛病）。这时候我们需要把gradle版本换成experimental版本的。

• 打开Project的build.gradle,修改gradle为如下版本。

classpath 'com.android.tools.build:gradle-experimental:0.7.0'

• 这个版本的gradle配置和正式版的有很大区别，打开app的build.gradle修改如下：

apply plugin: 'com.android.model.application'model {    android {        compileSdkVersion = 23        buildToolsVersion = "23.0.2"        defaultConfig {            //包名            applicationId "com.example.wastrel.hellojni"            minSdkVersion.apiLevel 15            targetSdkVersion.apiLevel 23            versionCode 1            versionName "1.0.1"        }    }    android.ndk {        //生成so文件的名字，不需要lib前缀        moduleName "helloJNI"    }    android.buildTypes {        release {            minifyEnabled = false            proguardFiles.add(file("proguard-rules.txt"))        }    }}dependencies {    compile fileTree(dir: 'libs', include: ['*.jar'])    testCompile 'junit:junit:4.12'    compile 'com.android.support:appcompat-v7:23.4.0'}

注：可以把上面的模板复制过去修改一下即可。
详情请参考:http://tools.android.com/tech-docs/new-build-system/

6.编写cpp文件，上面已经用javah工具生成了头文件。接下来我们要实现头文件里面的方法。在jni目录下新建文件HelloJNI.cpp:

#include "com_example_wastrel_hellojni_HelloJNI.h"JNIEXPORT jstring JNICALL Java_com_example_wastrel_hellojni_HelloJNI_getFormCString        (JNIEnv *env, jclass clazz){        //通过env里面的转换方法，将字符串转成UTF格式的jstring    return env->NewStringUTF("I am from C String!");}

JNIEnv是JNI的核心数据,env指向JNIEnv结构的指针。可以理解为JNIEnv提供了一些列方法来完成JAVA与Native之间的数据转换与传递工作。

7.在Activity中布局一个TextView用来显示字符串，布局代码就不贴了。

 @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_main);        TextView  tv= (TextView) findViewById(R.id.text);        tv.setText(HelloJNI.getFormCString());    }

8.运行程序，不出现编译错误，手机上将会看到结果图：

可能遇到的问题

1. 为什么我生成的C函数参数是（JNIEnv , jobject）而不是（JNIEnv , jclass）；
   答：这和java代码中对Native函数的声明有关，声明为static，这里的参数就是jclass,即代表该函数所在的类(如HelloJNI.getFromString()，这是jclass接收的是HelloJNI.class)。如果没有声明static，这里的参数就是jobject，表示调用者的实体对象，(如HelloJNI t=new HelloJNI()；t.getFromCString()，这里jobject就代表就是t这个对象)。
2. 报java.lang.UnsatisfiedLinkError错误；
   答：此类错误一般后面有详细的解释，此处列出常见的错误：
   
   • could’t find “xxx.so” 此类错误表示找不到对应的so文件，请查看自己的gradle配置是否有ndk标签，函数实现文件要用标准的后缀.cpp或.c，不然gradle编译ndk的时候不会加入编译的。
   • Native method not found 此类问题表明你在JAVA中声明的函数没有对应的Native实现，如果已经实现了，请确保执行了System.loadLibary(“xxx.so”);一般来说用javah生成的函数定义是不会出现签名不一致的情况的。
   • Can’t load 64-bit .so on 32-bit platform 也就是说不能在32位环境中载入64位的so。一般来说把so移到armeabi-v8a 文件夹下即可。该文件夹存放的是arm64位so文件。