Android NDK开发(一) 使用CMake构建工具进行NDK开发

2018年的第一篇文章,主要讲解了JNI、NDK的一些概念以及在AS 3.0环境下如何使用CMake构建工具来进行NDK开发。

1.了解一些概念

  • JNI(Java Native Interface):

    Java原生接口,是Java和其他原生代码语言(例如 C 和 C++)通信的桥梁。

  • NDK(Native Development Kit):

    原生开发工具集,是一套允许您使用原生代码语言(例如 C 和 C++)实现程序功能的工具集。

  • ABI(Application Binary Interface):

    应用程序二进制接口,不同的CPU支持不同的指令集,CPU与指令集的每种组合都有其自己的应用二进制接口(或ABI),ABI可以非常精确地定义应用的机器代码在运行时如何与系统交互。

    ABI官方文档

    支持的ABI:armeabi、armeabi-v7a、arm64-v8a、x86、x86_64、mips、mips64

  • CMake:

    Android推荐使用的NDK构建工具,从AS 2.2版本之后开始支持(包含2.2版本)。

2.环境搭建

安装NDK开发所需的工具

安装NDK开发所需的工具

在SDK Tools中安装以下组件:

  • Cmake:NDK构建工具

  • LLDB:NDK调试工具

  • NDK:NDK开发工具集

创建NDK项目

创建NDK项目

在创建项目时,勾选【Include C++ support】选项,然后一路下一步,到达【Customize C++ Support】设置页:

Customize C++ Support

可以看到三个选项:

  • C++ Standard:C++标准,选择【Toolchain Default】会使用默认的CMake配置。

  • Exceptions Support:支持C++异常处理,标志为 -fexceptions

  • Runtime Type Information Support:支持运行时类型识别,标志为
    -frtti,程序能够使用基类的指针或引用来检查这些指针或引用所指的对象的实际派生类型。

在这里我们使用默认C++标准,不勾选下面的两个选项,点击【Finish】按钮进入下一个环节。

3.NDK项目

看下项目目录:

项目目录

上图中用红框标识了NDK项目与普通项目的不同之处,下面分别来看看:

首先来看下build.gradle配置:

apply plugin: 'com.android.application'

android {
    compileSdkVersion 26
    defaultConfig {
        applicationId "com.yl.ndkdemo"
        minSdkVersion 15
        targetSdkVersion 26
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
        externalNativeBuild {
            cmake {
                cppFlags ""
            }
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
    externalNativeBuild {
        cmake {
            path "CMakeLists.txt"
        }
    }
}

dependencies {
    // 引用一些库
}

可以看到build.gradle配置中多了两个externalNativeBuild配置项:

  • defaultConfig里面的:

    主要配置了Cmake的命令参数,例如在创建项目时,如果勾选了【Exceptions Support】和【Runtime Type Information Support】选项,是这样配置的:

externalNativeBuild {
    cmake {
        cppFlags "-fexceptions -frtti"
    }
}

更多命令参数可以查看Android NDK CMake文档

  • defaultConfig外面的:

    主要定义了CMake的构建脚本CMakeLists.txt的路径。

CMake的构建脚本CMakeLists.txt

CMakeLists.txt是CMake的构建脚本,作用相当于ndk-build中的Android.mk,看下CMakeLists.txt:

# 设置Cmake最小版本
cmake_minimum_required(VERSION 3.4.1)

# 编译library
add_library( # 设置library名称
             native-lib

             # 设置library模式
             # SHARED模式会编译so文件,STATIC模式不会编译
             SHARED

             # 设置原生代码路径
             src/main/cpp/native-lib.cpp )

# 定位library
find_library( # library名称
              log-lib

              # 将library路径存储为一个变量,可以在其他地方用这个变量引用NDK库
              # 在这里设置变量名称
              log )

# 关联library
target_link_libraries( # 关联的library
                       native-lib

                       # 关联native-lib和log-lib
                       ${log-lib} )

这是一个基本的CMake构建脚本,更多脚本配置请参考CMAKE手册,看不懂!没关系,这里有中文版的CMAKE手册-中文版

原生代码native-lib.cpp

Android提供了一个简单的JNI交互Demo,返回一个字符串给Java层,方法名是通过 Java_包名_类名_方法名 的方式命名的:

#include <jni.h>
#include <string>

extern "C"
JNIEXPORT jstring

JNICALL
Java_com_yl_ndkdemo_MainActivity_stringFromJNI(
        JNIEnv *env,
        jobject /* this */) {
    std::string hello = "Hello from C++";
    return env->NewStringUTF(hello.c_str());
}

看下如何调用:

public class MainActivity extends AppCompatActivity {

    // 加载native-lib,不加lib前缀
    static {
        System.loadLibrary("native-lib");
    }

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

        // 将获取的字符串显示在TextView上
        TextView tv = (TextView) findViewById(R.id.sample_text);
        tv.setText(stringFromJNI());
    }

    /**
     * native-lib中的原生方法
     */
    public native String stringFromJNI();
}

调用方式很简单,代码中已经写了注释,看下效果:

运行效果

生成so文件

在CMakeLists.txt中将library的编译模式设置为SHARED模式,点击AS的编译按钮,在app > build > intermediates > cmake > debug > obj目录下会生成不同CPU架构对应的so文件:

so文件目录

生成的so文件也可以在其他项目中使用,在项目的app > src > main目录下创建jniLibs文件夹,将生成的so文件(带着CPU架构目录)拷贝到jniLibs文件夹中,按照上文中的调用方式即可正常使用。

在app的build.gradle文中配置abiFilters,可以输出指定ABI的so文件:

defaultConfig {
    ...

    ndk {
        abiFilters "armeabi", "armeabi-v7a", "arm64-v8a", "x86", "x86_64", "mips", "mips64"
    }
}

4.写在最后

NDK官方使用文档

后续还会更新更多NDK开发系列文章,敬请期待!

展开阅读全文

Git 实用技巧

11-24
这几年越来越多的开发团队使用了Git,掌握Git的使用已经越来越重要,已经是一个开发者必备的一项技能;但很多人在刚开始学习Git的时候会遇到很多疑问,比如之前使用过SVN的开发者想不通Git提交代码为什么需要先commit然后再去push,而不是一条命令一次性搞定; 更多的开发者对Git已经入门,不过在遇到一些代码冲突、需要恢复Git代码时候就不知所措,这个时候哪些对 Git掌握得比较好的少数人,就像团队中的神一样,在队友遇到 Git 相关的问题的时候用各种流利的操作来帮助队友于水火。 我去年刚加入新团队,发现一些同事对Git的常规操作没太大问题,但对Git的理解还是比较生疏,比如说分支和分支之间的关联关系、合并代码时候的冲突解决、提交代码前未拉取新代码导致冲突问题的处理等,我在协助处理这些问题的时候也记录各种问题的解决办法,希望整理后通过教程帮助到更多对Git操作进阶的开发者。 本期教程学习方法分为“掌握基础——稳步进阶——熟悉协作”三个层次。从掌握基础的 Git的推送和拉取开始,以案例进行演示,分析每一个步骤的操作方式和原理,从理解Git 工具的操作到学会代码存储结构、演示不同场景下Git遇到问题的不同处理方案。循序渐进让同学们掌握Git工具在团队协作中的整体协作流程。 在教程中会通过大量案例进行分析,案例会模拟在工作中遇到的问题,从最基础的代码提交和拉取、代码冲突解决、代码仓库的数据维护、Git服务端搭建等。为了让同学们容易理解,对Git简单易懂,文章中详细记录了详细的操作步骤,提供大量演示截图和解析。在教程的最后部分,会从提升团队整体效率的角度对Git工具进行讲解,包括规范操作、Gitlab的搭建、钩子事件的应用等。 为了让同学们可以利用碎片化时间来灵活学习,在教程文章中大程度降低了上下文的依赖,让大家可以在工作之余进行学习与实战,并同时掌握里面涉及的Git不常见操作的相关知识,理解Git工具在工作遇到的问题解决思路和方法,相信一定会对大家的前端技能进阶大有帮助。
©️2020 CSDN 皮肤主题: 编程工作室 设计师: CSDN官方博客 返回首页
实付0元
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值