android studio CMake初体验

一、简介   

     NDK:Android NDK 是一套允许您使用原生代码语言(例如 C 和 C++)实现部分应用的工具集。在开发某些类型应用时,这有助于您重复使用以这些语言编写的代码库。

    JNI:Java 原生接口,JNI 是 Java 和 C++ 组件用以互相沟通的接口

    原生共享库:NDK 从原生源代码构建这些库或 .so 文件。

    原生静态库:NDK 也可构建静态库或 .a 文件,您可以关联到其他库。

    ABI:ABI 可以非常精确地定义应用的机器代码在运行时如何与系统交互。 NDK 根据这些定义构建 .so 文件。 不同的 ABI 对应不同的架构:NDK 包含对 ARMEABI(默认)、MIPS 和 x86 的 ABI 支持。

    CMake:一款外部构建工具,可与 Gradle 搭配使用来构建原生库。如果您只计划使用 ndk-build,则不需要此组件。

    LLDB:一种调试程序,Android Studio 使用它来调试原生代码

https://developer.android.com/ndk/index.html

https://developer.android.com/ndk/guides/concepts.html

https://developer.android.com/studio/projects/add-native-code.html

二、下载NDK或构建工具

  1. 在打开的项目中,从菜单栏选择 Tools > SDK Manager
  2. 点击 SDK Tools 标签。
  3. 选中 LLDBCMake 和 NDK 旁的复选框,如图所示。                                                                                                                           android studio CMake初体验
  4. 点击 Apply,然后在弹出式对话框中点击 OK
  5. 安装完成后,点击 Finish,然后点击 OK

三、创建项目

  1. New->New Project->Create Android Project ,选中 Include C++ Support 复选框。
  2. 点击 Next->Next->Next->Next
  3. 在向导的 Customize C++ Support 部分,您可以使用下列选项自定义项目:
  • C++ Standard:使用下拉列表选择您希望使用哪种 C++ 标准。选择 Toolchain Default 会使用默认的 CMake 设置。    
  • Exceptions Support:如果您希望启用对 C++ 异常处理的支持,请选中此复选框。如果启用此复选框,Android Studio 会将 -fexceptions 标志添加到模块级 build.gradle 文件的 cppFlags 中,Gradle 会将其传递到 CMake。
  • Runtime Type Information Support:如果您希望支持 RTTI,请选中此复选框。如果启用此复选框,Android Studio 会将 -frtti 标志添加到模块级 build.gradle 文件的 cppFlags 中,Gradle 会将其传递到 CMake。

四、项目结构

    在 Android Studio 完成新项目的创建后,从 IDE 左侧打开 Project 窗格并选择 Android 视图。如图所示,Android Studio 将添加 cpp 、.externalNativeBuild组和文件CMakeLists.txt:

android studio CMake初体验

  1. 在 cpp 组中,您可以找到属于项目的所有原生源文件、标头和预构建库。对于新项目,Android Studio 会创建一个示例 C++ 源文件 native-lib.cpp,并将其置于应用模块的 src/main/cpp/ 目录中。本示例代码提供了一个简单的 C++ 函数 stringFromJNI(),此函数可以返回字符串“Hello from C++”。
  2. 在CMakeLists.txt和externalNativeBuild组中,您可以找到 CMake 或 ndk-build 的构建脚本。与 build.gradle 文件指示 Gradle 如何构建应用一样,CMake 和 ndk-build 需要一个构建脚本来了解如何构建您的原生库。对于新项目,Android Studio 会创建一个 CMake 构建脚本 CMakeLists.txt,并将其置于模块的根目录中。

五、简单示例

    我们以求2个数的和为例。

  • 在native-lib.cpp中编写函数
    int add(int x,int y)
    {
        return x+y;
    }

  • 在MainActivity中编写
    // Used to load the 'native-lib' library on application startup.
    static {
        System.loadLibrary("native-lib");
    }

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

    /**
     * A native method that is implemented by the 'native-lib' native library,
     * which is packaged with this application.
     */
    public native String stringFromJNI();
    public native int add(int x,int y);

  • 打开Terminal(控制台)

    View->Tool Windows->Terminal。

  • 跳转到目录:cd app/src/main/java

    android studio CMake初体验

  • 生成JNI头文件

    在控制台输入javah -d . -jni com.zzy.ndkdemo.MainActivity命令

    刷新目录后,会多出一个头文件com_zzy_ndkdemo_MainActivity.h文件,将该文件拷贝到CPP目录下

    android studio CMake初体验

  • 在nativa-lib.cpp中实现头文件中的函数    
extern "C" JNIEXPORT jint JNICALL Java_com_zzy_ndkdemo_MainActivity_add(JNIEnv *env, jobject instance, jint x, jint y) {
        return add(x, y);
}

   注意需要加上extern "C"

  • 在MainActivity.java中加上调用,编译运行。

    int sum = add(10,20);
    TextView tv = (TextView) findViewById(R.id.sample_text);
    tv.setText("sum:"+sum);

相关文章: