android ndk 入门 - 一个简单的ndk工程 - android

参考：http://segmentfault.com/a/1190000000735743 : Android NDK and OpenCV Development With Android Studio

https://developer.android.com/intl/zh-cn/ndk/index.html

#####################################################################

首先到Android官网上下载最新版本的ndk：https://developer.android.com/intl/zh-cn/ndk/downloads/index.html

目前我使用的是Ubuntu14.04系统，所以选择Linux下的NDK版本android-ndk-*.bin

这是一个自解压的二进制文件，下载完成后赋予执行权限，再进行解压：

chmod u+x android-ndk-*.bin./android-ndk-*.bin

即得到ndk开发的包

note：ndk官方的例子在其所在开发包的samples子目录下

在Android Studio上设置NDK的路径，在local.properties上添加：

ndk.dir=$$

现在运行最简单的hello-jni工程，打开Android Studio，导入${NDK_HOME}/samples/hello-jni工程

精简后代码如下：

Hellojni.java

package com.example.hellojni;import android.app.Activity;import android.widget.TextView;import android.os.Bundle;public class HelloJni extends Activity{    /** Called when the activity is first created. */    @Override    public void onCreate(Bundle savedInstanceState)    {        super.onCreate(savedInstanceState);        /* Create a TextView and set its content.         * the text is retrieved by calling a native         * function.         */        TextView  tv = new TextView(this);        tv.setText( stringFromJNI() );        setContentView(tv);    }    /* A native method that is implemented by the     * 'hello-jni' native library, which is packaged     * with this application.     */    public native String  stringFromJNI();    /* This is another native method declaration that is *not*     * implemented by 'hello-jni'. This is simply to show that     * you can declare as many native methods in your Java code     * as you want, their implementation is searched in the     * currently loaded native libraries only the first time     * you call them.     *     * Trying to call this function will result in a     * java.lang.UnsatisfiedLinkError exception !     */    public native String  unimplementedStringFromJNI();    /* this is used to load the 'hello-jni' library on application     * startup. The library has already been unpacked into     * /data/data/com.example.hellojni/lib/libhello-jni.so at     * installation time by the package manager.     */    static {        System.loadLibrary("hello-jni");    }}

hello-jni.c

#include <string.h>#include <jni.h>/* This is a trivial JNI example where we use a native method * to return a new VM String. See the corresponding Java source * file located at: * *   apps/samples/hello-jni/project/src/com/example/hellojni/HelloJni.java */jstringJava_com_example_hellojni_HelloJni_stringFromJNI( JNIEnv* env,                                                  jobject thiz ){    return (*env)->NewStringUTF(env, "Hello from JNI !");}

app/build.gradle

apply plugin: 'com.android.model.application'model {    android {        compileSdkVersion = 23        buildToolsVersion = "23.0.2"        defaultConfig.with {            applicationId = "com.example.hellojni"            minSdkVersion.apiLevel = 4            targetSdkVersion.apiLevel = 23        }    }    compileOptions.with {        sourceCompatibility=JavaVersion.VERSION_1_7        targetCompatibility=JavaVersion.VERSION_1_7    }    /*     * native build settings     */    android.ndk {        moduleName = "hello-jni"        /*         * Other ndk flags configurable here are         * cppFlags.add("-fno-rtti")         * cppFlags.add("-fno-exceptions")         * ldLibs.addAll(["android", "log"])         * stl       = "system"         */    }    android.buildTypes {        release {            minifyEnabled = false            proguardFiles.add(file('proguard-rules.txt'))        }    }}

此时并不能运行，因为该工程并没有为hello-jni.c和Hellojni.java之间建立联系

#######################################################

在Android Studio上可以设置javah快捷键，这样有助于开发

在菜单栏上，点击File->Settings

android ndk 入门 - 一个简单的ndk工程_第1张图片

在搜索栏上输入External Tools

android ndk 入门 - 一个简单的ndk工程_第2张图片

在左边tab键上点击+号，修改如下

android ndk 入门 - 一个简单的ndk工程_第3张图片

点击OK，这样就可以在以后开发NDK工程中使用javah快捷键

#################################################################

在app->src->jni路径下新建文件Android.mk:

LOCAL_PATH := ${call my-dir}include $(CLEAR_VARS)LOCAL_MODULE := hello-jniLOCAL_SRC_FILES := hello-jni.cinclude $(BUILD_SHARED_LIBRARY)

点击Hellojni.java文件，点击鼠标右键->External Tools->javah，在jni路径下就会生成一个com_example_hellojni_Hellojni.h文件

/* DO NOT EDIT THIS FILE - it is machine generated */#include <jni.h>/* Header for class com_example_hellojni_HelloJni */#ifndef _Included_com_example_hellojni_HelloJni#define _Included_com_example_hellojni_HelloJni#ifdef __cplusplusextern "C" {#endif/* * Class:     com_example_hellojni_HelloJni * Method:    stringFromJNI * Signature: ()Ljava/lang/String; */JNIEXPORT jstring JNICALL Java_com_example_hellojni_HelloJni_stringFromJNI  (JNIEnv *, jobject);/* * Class:     com_example_hellojni_HelloJni * Method:    unimplementedStringFromJNI * Signature: ()Ljava/lang/String; */JNIEXPORT jstring JNICALL Java_com_example_hellojni_HelloJni_unimplementedStringFromJNI  (JNIEnv *, jobject);#ifdef __cplusplus}#endif#endif

这样整个工程就算成功了，点击运行即可

android ndk 入门 - 一个简单的ndk工程_第4张图片

################################################################################

NDK(The Native Development Kit ：本地开发包)是一个工具集，允许你在Android应用中去利用C和C++代码。你可以利用它去构建自己的源代码或者利用现有的库

当你想要使用本地库中的某个函数时，你需要在java文件中声明，使用关键字native表示该实现是在本地库中：

public native int add(int x, int y);

这就是一个本地函数声明

同时，在java文件上加上

static{    System.loadLibrary("hello-jni")}

用于载入本地库，"hello-jni"是本地库的名字

然后在app->build.gradle中加入：

model {     android.ndk {            moduleName="hello-jni"      }}

必须在app->src->main->jni路径下创建一个Android.mk配置文件，系统在运行时会查看这个文件

Android.mk文件包含了模块名（库名），被编译的源文件名，构建符号以及链接的库

一个Android.mk文件必须以下语句：

LOCAL_PATH := $(call my-dir)

Android.mk必须由该语句开始，这个变量表明了源文件在开发树上的位置。其中，宏函数my-dir由构建系统提供，返回当前目录路径，这个路径包含Android.mk文件本身，所以，如下：

LOCAL_PATH := $(call app/src/main/jni/Android.mk)

可也运行，不过使用宏函数有助于开发

下一条语句声明了CLEAR_VARS变量，其值由系统提供：

include $(CLEAR_VARS)

变量CLEAR_VARS指向一个指定的GNU Makefile，用于清除需要LOCAL_XXX类型的变量，比如LOCAL_MODULE, LOCAL_SRC_FILES, LOCAL_STATIC_LIBRARIES等， 不过该变量不会清除LOCAL_PATH。

必须使用这条语句，因为系统在运行过程中，会在一个单一的GNU构建环境下解析所有的构建控制文件，所以所有变量都是全局变量，你必须在每一个Module中声明该变量

变量LOCAL_MODULE声明了你想要去构建的Module的名字，在应用中每个Module声明一次：

LOCAL_MODULE := hello-jni

note：Module名不能重复并且没有空格
在构建系统中，当生成最终的共享库文件时，会自动加上lib前缀和.so后缀，例如，上述工程最后生成的共享库名为libhello-jni.so。但如果你的文件名是由lib开头的，那么并不会在添加lib前缀，只会加上.so扩展名

下一行为：

LOCAL_SRC_FILES := hello-jni.c

在这里应该列出所有使用到的源文件名，用空格隔开，例如：

LOCAL_SRC_FILES := hello_jni.c hello.c hi.c

最后一行表示结束：

include ${BUILD_SHARED_LIBRARY}

变量BUILD_SHARED_LINRARY指向一个GNU Makefile脚本，用于收集你定义的所有LOCAL_XXX的信息，决定构建社么以及如何构建。

以上这些语句就是Android.mk文件必须拥有的，总结如下

LOCAL_PATH := ${call my-dir}include $(CLEAR_VARS)LOCAL_MODULE := hello-jniLOCAL_SRC_FILES := hello-jni.cinclude $(BUILD_SHARED_LIBRARY)

android ndk 入门 - 一个简单的ndk工程

更多相关文章

随机推荐