Android NDK开发，使用ndk-build编译

最新推荐文章于 2019-05-13 14:09:17 发布

Ang_qq_252390816

最新推荐文章于 2019-05-13 14:09:17 发布

阅读量3.6w

点赞数 14

分类专栏： NDK

本文链接：https://blog.csdn.net/ezconn/article/details/82529101

版权

NDK 专栏收录该内容

6 篇文章 2 订阅

订阅专栏

一，开发环境

二，配置NDK环境变量：

三，在自己项目创建本地方法：

四，手动创建本地方法fromJNIString()对应的.h头文件

五，在jni目录下创建c或者c++文件；

六，配置build.gradle（Model：App）

七，编写Android.mk文件

八，修改默认编译工具

九，最后在MainActivity中加载我们生成的动态库：

手动编译.so文件

其他相关

一，开发环境

win10 AndroidStudio 3.1.2 NDK版本：R16

二，配置NDK环境变量：

和配置Java JDK环境变量相同，不会的可以自行百度，配置NDK环境变量有很多种方式；

三，在自己项目创建本地方法：

即：在Java类中创建带有native的方法；

项目或者应用的包名：com.ang.ndkdemo

public class MainActivity extends AppCompatActivity {
    

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

    //创建的本地方法，具体功能在C或者C++中实现
    public native String fromJNIString();

}

四，手动创建本地方法fromJNIString()对应的.h头文件

1，在电脑的cmd 或者AndroidStudio的Terminal中输入javah -d D:\Demo\NDKDemo\app\src\main\jni -classpath D:\Demo\NDKDemo\app\src\main\java com.ang.ndkdemo.MainActivity

javah -d D:\Demo\NDKDemo\app\src\main\jni -classpath D:\Demo\NDKDemo\app\src\main\java 
com.ang.ndkdemo.MainActivity

a, -d D:\Demo\NDKDemo\app\src\main\jni 创建jni文件夹并指定.h输出目录
b, D:\Demo\NDKDemo\app\src\main\jni 要创建的.h头文件输出的绝对路径
c, D:\Demo\NDKDemo\app\src\main\java com.ang.ndkdemo.MainActivity 包含本地方法(fromJNIString())的类路径；注意不要写成了 D:\Demo\NDKDemo\app\src\main\java\com\ang\ndkdemo\MainActivity（把包名中的点“.”写成了斜杠“\”，这样写是不对的）；com.ang.ndkdemo.MainActivity（注意是包名+类名）；
参数说明

-classpath ：类搜索路径，这里表示从当前的D:\Demo\NDKDemo\app\src\main\java目录下查找

-d ：将生成的头文件放到当前的jni目录下

-o ：指定生成的头文件名称，默认以类全路径名生成（包名+类名.h）

注意：-d和-o只能使用其中一个参数。

注意： -d D:\Demo\NDKDemo\app\src\main\jni 和 -classpath D:\Demo\NDKDemo\app\src\main\java 位置可以互换；一下写法和等价于上面的写法；

javah -classpath D:\Demo\NDKDemo\app\src\main\java -d D:\Demo\NDKDemo\app\src\main\jni com.ang.ndkdemo.MainActivity

补充：可以通过-o指定生成的头文件名称，如果不指定，默认以类全路径名生成（包名+类名.h）

javah -classpath E:\Demo\JNIDemo\app\src\main\java -o E:\Demo\JNIDemo\app\src\main\java\jni\JNITest.h com.ang.MainActivity

2，执行以上命令之后：就在项目的main文件夹下创建了jni文件夹，并且在jni文件夹下自动创建了.h头文件；头文件名也是自动生成的，命名规则是com_ang_ndkdemo_MainActivity.h(包名+类名.h)

3，自动生成的com_ang_ndkdemo_MainActivity.h头文件代码

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

#ifndef _Included_com_ang_ndkdemo_MainActivity
#define _Included_com_ang_ndkdemo_MainActivity
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_ang_ndkdemo_MainActivity
 * Method:    fromJNIString
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_ang_ndkdemo_MainActivity_fromJNIString
  (JNIEnv *, jobject);

/*JNIEnv* 是定义任意native函数的第一个参数（包括调用JNI的RegisterNatives函数注册的函数），指向JVM函数表的指针，函数表中的每一个入口指向一个JNI函数，每个函数用于访问JVM中特定的数据结构。*/

#ifdef __cplusplus
}
#endif
#endif

4，生成.h头文件时候，如果出现“找不到类文件”的错误请参考 https://blog.csdn.net/ezconn/article/details/82352531这篇文章

注意：

a. 包名或类名或方法名中含下划线 _ 要用 _1 连接；

b. 重载的本地方法命名要用双下划线 __ 连接；

c. 参数签名的斜杠 “/” 改为下划线 “_” 连接，分号 “;” 改为 “_2” 连接，左方括号 “[” 改为 “_3” 连接；

另外，对于 Java 的 native 方法，static 和非 static 方法的区别在于第二个参数，static 的为 jclass，非 static 的为 jobject；JNI 函数中是没有修饰符的。

五，在jni目录下创建c或者c++文件；

文件名可以随意写，但需要注意文件类型；Hello.c文件（.c后缀的文件为C）代表内容是C代码；Hello.cpp（.cpp后缀的文件为C++）文件代表内容是C++代码；

C++代码（注意C和C++代码是有区别），以下分别给出C和C++两种实现方式：

a,Hello.c文件。在C中没有引用，传递的env是个两级指针，用（*env）->调用方法且方法中要传入env.

#include <jni.h>
#include "com_ang_ndkdemo_MainActivity.h"
 JNIEXPORT jstring JNICALL
 Java_com_ang_ndkdemo_MainActivity_fromJNIString(JNIEnv* env, jobject obj) {
     return (*env)->NewStringUTF(env,"I am From Native C");
 }

b, Hello.cpp文件。C++中env为一级指针，用env->调用方法，无需传入env；C++语言在编译的时候为了解决函数的多态问题，会将函数名和参数联合起来生成一个中间的函数名称，而C语言则不会，因此会造成链接时找不到对应函数的情况，此时C函数就需要用extern "C"进行链接指定，这告诉编译器，请保持我的名称，不要给我生成用于链接的中间函数名；exter "C"{jni代码}。

#include <com_ang_ndkdemo_MainActivity.h>
#include <stdio.h>

JNIEXPORT jstring JNICALL
Java_com_ang_ndkdemo_MainActivity_fromJNIString(JNIEnv *env, jobject obj)
{
    return env->NewStringUTF("I am From Native C");
}

Java的native方法是如何链接 C/C++中的函数的呢？可以通过静态和动态的方式注册JNI。以上是通过静态注册的方式。

静态注册：根据函数名建立Java本地方法和JNI函数的一一对应关系。

动态注册：直接告诉Java native方法其在JNI中对应函数的指针。

六，配置build.gradle（Model：App）

也可以不配置ndk{},这里只是指定编译出哪几种对应的abi架构的.so库，如果不配置，会根据ndk-build默认输出对应的abi架构的.so库；最好配置，不然不能编译出自己想要的对应ABI架构的.so，如果自己的项目中已经引用其他的.so库还要做适配；

    defaultConfig {
        applicationId "com.ang.demo"
        minSdkVersion 19
        targetSdkVersion 28
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"

        //ndk编译生成.so文件
        ndk{
            moduleName "Java2c"    //生成的so名字，Android.mk文件中已经指定了，这里可以不写
            abiFilters "armeabi", "armeabi-v7a", "x86"  //输出指定三种abi体系结构下的so库。
        }
    }

七，编写Android.mk文件

Android.mk文件一般包含如下信息就够了，差不多可算得上一个模板；根据自己的.so库名和C或者C++文件名修改一下就可以用了；

LOCAL_PATH:= $(call my-dir)#不用修改


include $(CLEAR_VARS)#不用修改

LOCAL_MODULE:= hello #动态库名称
LOCAL_SRC_FILES:= hello.c #C文件，里面就是我们写的C代码

include $(BUILD_SHARED_LIBRARY)#生成.so动态库

#include $(BUILD_STATIC_LIBRARY) 编译出.a的静态库

还有一种方式，就是让androidstudio自动生成；如下是我获取自动生成的Android.mk文件的方式：

a, 紧接着步骤六之后，点击Androidstudio 菜单栏 Build ->ReBuildProject

报错：

b, 在app ——> build ——>intermediater——>ndk(自动创建)目录下自动创建了一个Android.mk文件

Android.mk文件如下：

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)

LOCAL_MODULE := Java2c
LOCAL_LDFLAGS := -Wl,--build-id
LOCAL_SRC_FILES := \
	D:\Demo\NDKDemo\app\src\main\jni\Hello.cpp \

LOCAL_C_INCLUDES += D:\Demo\NDKDemo\app\src\debug\jni
LOCAL_C_INCLUDES += D:\Demo\NDKDemo\app\src\main\jni

include $(BUILD_SHARED_LIBRARY)

八，修改默认编译工具

鼠标右键项目，点击Link C++ Project with Gradle修改Androidstudio默认编译工具,在BuildSystem栏选择ndk—build,在ProjectPath选项栏，找到刚才创建的Android.mk文件（其实就是Android.mk文件路径），点击OK之后就在build.gradle（Model：App）的android{}中自动生成了externalNativeBuild { ndkBuild { path 'src/main/jni/Android.mk' } }

//增加之后如下信息之后，右键项目的时候Link C++ Project with Gradle选项不再显示;  
externalNativeBuild {
        ndkBuild {
            path 'src/main/jni/Android.mk'
        }
 }

注意：有的时候需要再次显示Link C++ Project with Gradle选项，删掉externalNativeBuild { ndkBuild { path 'src/main/jni/Android.mk' } }点击sync now同步一下；再次右键项目就可以出现了；

相关知识：要将Gradle关联到原生库，需要提供一个指向CMake或ndk-build 脚本文件的路径。在构建应用时，Gradle会以依赖项的形式运CMake或ndk-build，并将共享的.so库打包到APK中。externalNativeBuild 就是配置的脚本路径；

九，最后在MainActivity中加载我们生成的动态库：

注意：加载生成的动态库指定的文件名（System.loadLibrary("Java2c");）和生成.so时指定的名字（buil.gradle中的ndk{moduleName "Java2c" }），还有Android.mk中LOCAL_MODULE := Java2c三者是否一致；

例如:下图加载生成的动态库指定的文件名为：Java2JNI 和上面生成.so时指定的名字为：Java2c 还有Android.mk中LOCAL_MODULE := Java2c三者不一致，就会出现UnsatisfiedLinkError异常；

public class MainActivity extends AppCompatActivity {


    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Toast.makeText(this,new Java2C().fromJNIString(),Toast.LENGTH_LONG).show();
    }
    //加载.so库 Java2c为库名
    static {
        System.loadLibrary("Java2c");
    }

    public native String fromJNIString();

}

关于UnsatisfiedLinkError异常的原因还有很多，这里针对NDK开发总结几种可能的原因：https://blog.csdn.net/ezconn/article/details/82531893

总结：以上不用编译成.so库放到指定的路径下；如果需要.so库（给其他项目使用，例如使用百度地图服务，就要使用其提供的.so库）如下手动编译并使用.so库；

手动编译.so文件

从步骤八开始的第二种方式，不指定AndroidStudio编译工具（Cmake或者ndk-build），直接手动生成.so库

a, cmd 或者Android studio的Terminal 中进入jni的上一级目录

b, 输入ndk-build命令，在jni同级的目录中生成了一个libs文件夹，里面生成了各个cup架构对应的.so文件，

c, 应用.so动态库

1, 如果不更改手动生成后的.so库的位置，需要在build.gradle(Model.app)配置，因为.so库的默认存放位置是src/main/jniLibs

    // gradle高版本新写法
    sourceSets {
        main {
            jniLibs.srcDirs = ['src/main/libs']
        }
    }

2, 可以把生成的.so复制到main目录下和java同级的jniLibs（如果没有，手动创建一个）目录下，默认的库文件路径就是src/main/jniLibs，这样就不用在build.gradle(Model:app)中配置sourceSets了；

3, 也可以把.so库复制到app目录下的libs目录中，这里也需要在build.gradle(Model.app)配置注意：和2的区别

    sourceSets {
        main {
           jniLibs.srcDirs = ['libs']
        }
    }

d, 注意：这种手动生成.so库的方式，使用ndk17生成失败，以上都是应用的ndk16，由于ndk17已不在支持mips、armeabi CPU架构，

其他相关

使用 NDK 编译代码主要有三种方法：

1,基于 Make 的 ndk-build。

2,CMake。

3,独立工具链，用于与其他编译系统集成，或与基于 configure 的项目搭配使用。

如果对您有所帮助的话

不妨加个关注，点个赞哈，您的每个小小举动都是对我莫大的支持！

Ang_qq_252390816

关注

14
点赞
踩
78

收藏

觉得还不错? 一键收藏
打赏
9
评论
复制链接

分享到 QQ

分享到新浪微博

扫一扫

专栏目录