主要内容:
要为应用编译和调试原生代码,首先需要以下组件:
没有,点SDK Manager
去下载。
Android Studio 2.2 或更高版本,用于构建原生库的默认工具是 CMake。
创建支持原生代码(C/C++)的项目需要做一下步骤:
在向导的 Configure your new project 部分,选中 Include C++ Support 复选框。
点击 Next。
正常填写所有其他字段并完成向导接下来的几个部分。
在向导的 Customize C++ Support 部分,您可以使用下列选项自定义项目:
在 Android Studio 完成新项目的创建后,请从 IDE 左侧打开 Project 窗格并选择 Android 视图。如图 所示,Android Studio 将添加 cpp 和 External Build Files 组:
注:此视图无法反映磁盘上的实际文件层次结构,而是将相似文件分到一组中,简化项目导航。
在 cpp 组中,您可以找到属于项目的所有原生源文件、标头和预构建库。对于新项目,Android Studio 会创建一个示例 C++ 源文件 native-lib.cpp
,并将其置于应用模块的 src/main/cpp/
目录中。本示例代码提供了一个简单的 C++ 函数 stringFromJNI()
,此函数可以返回字符串“Hello from C++”。
在 External Build Files 组中,您可以找到 CMake 或 ndk-build 的构建脚本。与 build.gradle
文件指示 Gradle 如何构建应用一样,CMake 和 ndk-build 需要一个构建脚本来了解如何构建您的原生库。对于新项目,Android Studio 会创建一个 CMake 构建脚本 CMakeLists.txt
,并将其置于模块的根目录中。
点击 Run 后,Android Studio 将在您的 Android 设备或者模拟器上构建并启动一个显示文字“Hello from C++”的应用。
要在应用模块的主源代码集中创建一个包含新建原生源文件的 cpp/
目录,请按以下步骤操作:
cpp
)并点击 OK。native-lib
。.cpp
。
.cxx
或 .hxx
。在弹出的 C/C++ 对话框中,从 Source Extension 和 Header Extension 下拉菜单中选择另一个文件扩展名,然后点击 OK。注:CMake 构建脚本是一个纯文本文件,必须将其命名为 CMakeLists.txt。
要指示 CMake 从原生源代码创建一个原生库,请将 cmake_minimum_required()
和 add_library()
命令添加到您的构建脚本中:
# Sets the minimum version of CMake required to build your native library. # This ensures that a certain set of CMake features is available to # your build. cmake_minimum_required(VERSION 3.4.1) # Specifies a library name, specifies whether the library is STATIC or # SHARED, and provides relative paths to the source code. You can # define multiple libraries by adding multiple add.library() commands, # and CMake builds them for you. When you build your app, Gradle # automatically packages shared libraries with your APK. add_library( # Specifies the name of the library. native-lib # Sets the library as a shared library. SHARED # Provides a relative path to your source file(s). src/main/cpp/native-lib.cpp )
static { System.loadLibrary(“native-lib”); }
Link C++ Project with Gradle
。从下拉菜单中,选择 CMake。使用 Project Path 旁的字段为您的外部 CMake 项目指定 CMakeLists.txt 脚本文件。要手动配置 Gradle 以关联到您的原生库,您需要将 externalNativeBuild {} 块添加到模块级 build.gradle 文件中,并使用 cmake {} 对其进行配置:
android { ... defaultConfig {...} buildTypes {...} // Encapsulates your external native build configurations. externalNativeBuild { // Encapsulates your CMake build configurations. cmake { // Provides a relative path to your CMake build script. path "CMakeLists.txt" } } }
你的模块(比如app模块),右键菜单->New->Folder->JNI Folder,创建JNI 文件夹。
参照上面CMake部分所说的如何创建原生源文件
LOCAL_PATH := $(call my-dir) include $(CLEAR_VARS) LOCAL_MODULE := hello-jni LOCAL_SRC_FILES := hello-jni.c include $(BUILD_SHARED_LIBRARY)
APP_ABI :=all
最后的文件结构下
Link C++ Project with Gradle
。从下拉菜单中,选择ndk-build
。使用 Project Path 旁的字段指定Android.mk文件路径。android { ... defaultConfig {...} buildTypes {...} externalNativeBuild { ndkBuild { path 'src/main/jni/Android.mk' } } }
demo地址
as使用的是3.1.4
CMake形式
ndk-build形式