NDK开发（一） ：NDK入门指南

转载请以连接形式标明出处： 本文出自:103style的博客

本文操做以 Android Studio 3.4.2 版本为例

NDK开发文章汇总

---

目录

• 环境配置
• 建立支持 C/C++ 的新项目
• 向现有项目添加 C/C++ 代码
• 参考文章

---

环境配置

• 下载安装 Android Studio
• 配置 NDK 环境
  • 启动 Android Studio.
  • 以下图：在界面的 Configure 中 打开 Settings 界面。

    

  • 以下图： 在 左上角 输入框输入sdk → 点击 Android SDK → 点击 SDK Tools → 而后勾选上 LLDB、CMake、NDK → 而后点击 OK → 点击弹出框中的 OK.

    

  • 下载安装完成以后，重启 Android Studio.

---

建立支持 C/C++ 的新项目

• 在 Android Studio 的界面，点击 Start a new Android Studio project
• 以下图，在弹出界面选择 Native C++ ，而后点击 Next。

  

• 在新的界面直接点击 Next, 或者修改Name, Package name , Save location 中的值；
• 在新的界面点击 Finish.

Android Studio将会为咱们生成一个模板工程，咱们能够直接运行，启动以后界面上会显示 Hello from C++。

---

支持 C/C++ 的项目文件介绍

从 Android Studio 左侧打开 Project 窗格并选择 Android 视图，以下图：

咱们只要关心上图红框标记出来的如下这些文件就好：

• MainActivity ：应用视图界面，加载了一个名为native-lib的库，定义了一个native的方法stringFromJNI，而后将stringFromJNI返回的值设置到TextView上。

  public class MainActivity extends AppCompatActivity {
      static {
          System.loadLibrary("native-lib");
      }
      @Override
      protected void onCreate(Bundle savedInstanceState) {
          ...
          tv.setText(stringFromJNI());
      }
      public native String stringFromJNI();
  }
  复制代码

• CMakeLists.txt ：CMake 构建脚本。

  # 设置CMake的最低版本
  cmake_minimum_required(VERSION 3.4.1)
  # 添加源文件或者库
  add_library(
          native-lib # 库的名字
          SHARED # 库的类型 
          native-lib.cpp) # 库的源文件
  # 引用NDK中的库log，命名为log-lib
  find_library(
          log-lib # 库路径对应的变量名
          log) # NDK中的库名
  # 关联库，确保 native-lib 中 能使用 log 库
  target_link_libraries(
          native-lib 
          ${log-lib})
  复制代码

• native-lib.cpp : 示例 C++ 源文件，位于src/main/cpp/目录。

  #include <jni.h>
  #include <string>
  
  extern "C" JNIEXPORT jstring JNICALL
  //MainActivity 中 stringFromJNI方法 对应的 c 方法名字
  Java_com_lxk_myapplication_MainActivity_stringFromJNI(
          JNIEnv *env,
          jobject ) {
      std::string hello = "Hello from C++";
      return env->NewStringUTF(hello.c_str());
  }
  复制代码

• build.gradle ：构建文件

  android {
      ...
      defaultConfig {
          ...
          externalNativeBuild {
              cmake {
                  cppFlags ""
              }
          }
      }
      externalNativeBuild {
          cmake {
              path "src/main/cpp/CMakeLists.txt" //构建脚本的路径
              version "3.10.2"//CMake的版本
          }
      }
  }
  复制代码

若是刚刚运行过项目的话，点击左侧Project 窗格并选择 Project 视图，会在 app/build/intermediates/cmake/debug/armeabi-v7a/下生成一个 libnative-lib.so文件。

CMake 使用 lib库名称.so 的规范来为库文件命名，库名称即为咱们定义的 native-lib。不过咱们在Java代码中加载时，仍是使用咱们定义的库名称 native-lib。

static {
    System.loadLibrary("native-lib");
}
复制代码

---

向现有项目添加 C/C++ 代码

向现有 Android Studio 项目添加或导入原生代码，则须要按如下基本流程操做：

• 建立新的原生源文件，并将其添加到 Android Studio 项目中，若是您已经拥有原生代码或想要导入预编译原生库，则可跳过此步骤。
• 建立 CMake 编译脚本，告知 CMake 如何将原生源文件编译入库。若是导入和关联预编译库或平台库，您也须要此编译脚本。若是现有的原生库已有 CMakeLists.txt 编译脚本，或使用 ndk-build 并包含 Android.mk编译脚本，则可跳过此步骤。
• 提供一个指向 CMake 或 ndk-build 脚本文件的路径，将 Gradle 关联到原生库。Gradle 使用编译脚本将源代码导入您的 Android Studio 项目并将原生库（.so文件）打包到 APK 中。

从新建立一个 Basic Activity的工程。

建立新的原生源文件

• 从左侧打开 Project 菜单并从下拉菜单中选择 Project 视图。
• 右键点击选中 app/src/ 下的 main 目录，而后选择 New > Directory，为目录输入一个名称（例如 cpp）并点击 OK。
• 右键点击您刚刚建立的目录，而后选择 New > C/C++ Source File，输入一个名称，例如 hello-ndk，若是想建立一个标头文件，请勾选 Create an associated header 复选框，点击 OK。

  

建立 CMake 构建脚本

若是您的原生源文件尚未 CMake 构建脚本，则您须要自行建立一个并包含适当的 CMake 命令。

必须将其命名为 CMakeLists.txt。

• 右键点击选中 app ，而后选择 New > File，输入CMakeLists.txt 做为文件名并点击 OK。
• 添加命令到 CMakeLists.txt 中

  cmake_minimum_required(VERSION 3.4.1)
  
  add_library( hello-ndk
               SHARED
               src/main/cpp/hello-ndk.cpp)
  复制代码

• 使用 add_library() 向您的 CMake 构建脚本添加源文件或库时，Android Studio 还会在您同步项目后在 Project 视图下显示关联的标头文件。不过，为了确保 CMake 能够在编译时定位您的标头文件，您须要将 include_directories()命令添加到 CMake 构建脚本中并指定标头的路径：

  add_library(...)
  
  include_directories(src/main/cpp/include/)
  复制代码

• 添加 NDK API，Android NDK 提供了一套实用的原生 API 和库。将 find_library() 命令添加到您的 CMake 构建脚本中以定位 NDK 库。以 Android 特定的日志支持库 为例，为了确保您的原生库能够在 log 库中调用函数，您须要使用 CMake 构建脚本中的 target_link_libraries()命令关联库：

  add_library(...)
  
  find_library( log-lib # 库路径的变量名
                log ) # 对应的库名
  
  #将预构建库关联到您本身的原生库 
  target_link_libraries( hello-ndk
                         ${log-lib} )
  复制代码

将 Gradle 关联到您的原生库

要将 Gradle 关联到您的原生库，您须要提供一个指向 CMake 或 ndk-build 脚本文件的路径。在您构建应用时，Gradle 会以依赖项的形式运行 CMake 或 ndk-build，并将共享的库打包到您的 APK 中。

• 点击Android Studio 左侧菜单 Project 并选择 Android 视图。 点击 弹出菜单的第二个选项 Link C++ Project with Gradle，如图1，点击文件夹，点击 Android Studio图标的按钮能够定位到项目根目录，而后如图2 配置 CMakeLists.txt 的路径，点击 OK。

  

• 而后 app目录下的build.gradle文件会自动添加如下代码。

  externalNativeBuild {
      cmake {
          path file('CMakeLists.txt')
      }
  }
  复制代码

配置Javah命令工具<可选>

以下图，按 Ctrl + Alt + s 进入 Setting 界面，点击 Tools → External Tools → + 配置添加外部工具。参数以下：

Name :JavaH
Program:$JDKPath$/bin/javah
Parameters: -encoding UTF-8 -d ../cpp -jni $FileClass$
Working directory: $SourcepathEntry$\..\java
复制代码

编辑 MainActivity

在 MainActivity 添加以下代码：

public class MainActivity extends AppCompatActivity {
    static {
        System.loadLibrary("hello-ndk");
    }
    public native String helloNDK();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Toolbar toolbar = findViewById(R.id.toolbar);
        setSupportActionBar(toolbar);

        //添加下面两行代码
        TextView show = findViewById(R.id.tv_show);
        show.setText(helloNDK());

        ....
    }
    ...
}
复制代码

修改 content_main.xml

修改 content_main.xml，给TextView添加 android:id="@+id/tv_show"

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    ...>

    <TextView
        android:id="@+id/tv_show"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        .../>
</android.support.constraint.ConstraintLayout>
复制代码

生成 .h 头文件 <可选>

以下图，右键点击MainActivity，选择弹出框中的 External Tools 的 JavaH 。就会在cpp目录下生成 com_example_myapplication_MainActivity.h文件，你的文件名可能不同。

编辑hello-ndk.cpp

修改hello-ndk.cpp为如下代码：

#include <jni.h>
//确认此处名字是否可你生成的头文件的名字同样
#include "com_example_myapplication_MainActivity.h" 

//函数名要和头文件中的名字一致
JNIEXPORT jstring JNICALL Java_com_example_myapplication_MainActivity_helloNDK  
  (JNIEnv * env, jobject){
    return env ->NewStringUTF("Hello NDK");
}
复制代码

运行程序

点击顶部菜单栏 Build 中的 Rebuild Project，完了以后按 Shirt + F10 运行程序，而后界面上就会显示 Hello NDK 的字样。

---

参考文章

• 官方NDK 入门指南

---

Demo地址

若是以为不错的话，请帮忙点个赞呗。

以上

---

扫描下面的二维码，关注个人公众号 Android1024， 点关注，不迷路。