Android NDK初探：HelloWorld项目实践

一一MIO一一

于 2025-04-26 10:55:51 发布

阅读量759

点赞数 11

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/weixin_33240461/article/details/147546094

本文还有配套的精品资源，点击获取

简介：Android NDK是Google推出的用于Android平台原生代码开发的工具集，特别适用于性能要求高的场景。通过Android Studio集成环境，开发者能够使用C/C++等语言编写高效代码，并与Java代码交互。本教程通过"HelloWorld"示例介绍NDK项目的基本构建和运行流程。NDK的主要优势包括性能提升、库复用、安全性保护、游戏开发支持以及硬件加速能力。开发者可利用NDK开发高性能应用，尤其是在游戏和图形处理等需要硬件加速的领域。 Android NDK Demo

1. Android NDK工具集介绍

Android NDK的定义与用途

Android NDK（Native Development Kit）是一个工具集，它允许开发者使用C和C++代码在Android平台上进行性能密集型的应用程序开发。NDK通过提供一系列的平台库，使得开发者可以在本地代码中直接使用这些库，而无需通过Java层中转。这在处理图形、音频、物理模拟或需要大量数学计算的场景时，尤其有用。

NDK与SDK的区别及联系

Android SDK（Software Development Kit）是开发Android应用的主要工具包，提供了Java API和Android运行时环境。而NDK与之不同的是，它专注于提供原生代码开发的工具和库，主要用于执行高性能的计算任务。两者联系在于，它们都是Android应用开发不可或缺的一部分，SDK为应用提供基础框架和高级功能，而NDK补充了原生代码的开发能力，两者可以协同工作，实现更强大的应用功能。

NDK支持的编程语言和开发环境

Android NDK支持C和C++编程语言，并且能够与多种开发环境集成。最受欢迎的集成方式是通过Android Studio，它提供了一体化的界面来开发和调试使用NDK的应用程序。除此之外，开发者还可以选择其他IDE，如CLion、Visual Studio等，只要它们支持C/C++的开发和NDK环境的配置。通过这些工具，开发者能够利用NDK提供的功能，编写高性能的原生模块，并将其嵌入到Android应用中。

2. Android Studio与NDK集成

2.1 集成前的准备工作

在这一阶段，我们需要完成一系列准备工作，以确保Android Studio与NDK的集成过程顺利进行。

2.1.1 安装Android Studio

安装Android Studio是开发Android应用的第一步。前往Android开发者官网下载适用于你的操作系统的最新版本的Android Studio。下载后，遵循安装向导的指示完成安装过程。安装过程中，建议选择包含最新Android SDK、NDK和CMake工具的安装选项，以便后续开发工作。

2.1.2 安装NDK和CMake

在Android Studio安装过程中，安装器会询问是否安装NDK和CMake。这一步骤对于集成NDK至关重要，因为它们是构建和运行原生代码库的必要组件。

NDK (Native Development Kit)：包含了一个工具集，允许你使用C和C++编写代码，并将这些代码编译成可以在Android设备上运行的原生库。
CMake：是一个跨平台的构建系统，它能够处理依赖关系，并生成原生构建环境所需要的Makefiles。

确保在安装过程中勾选了“Android NDK”和“CMake”选项。完成安装后，重启Android Studio。

2.2 集成NDK到Android Studio

2.2.1 配置项目中的NDK选项

一旦Android Studio安装完成，我们将进行NDK的配置，以便在项目中使用它。

打开Android Studio，创建一个新的项目，或打开一个现有项目。
导航到“File” > “Project Structure”（或使用快捷键 Ctrl+Alt+Shift+S ）。
在打开的窗口中，选择“Project”菜单，确保语言和构建工具符合NDK开发要求。
切换到“Modules”菜单，选择你的应用模块。在“Sources”标签页中，检查是否有包含C/C++源文件的目录，如果没有，你需要添加相应的目录（例如， cpp/ ）。

2.2.2 验证NDK集成成功的方法

集成成功后，我们需要验证NDK和CMake是否能够正确地与Android Studio协同工作。

在你的模块中创建一个C++源文件（例如， native-lib.cpp ）。
在源文件中添加一些基础的C++代码，比如打印一条消息。
创建或编辑 CMakeLists.txt 文件，确保它包含适当的配置，比如指定可执行文件和库。
点击Android Studio工具栏上的“Build”按钮（或使用 Build > Make Project ）构建项目。
查看“Logcat”窗口，寻找有关C++源文件编译和链接的信息。如果一切正常，你应该看到构建成功的信息和你在C++源文件中添加的打印消息。

2.3 集成后的项目结构分析

2.3.1 源代码文件的组织方式

在集成NDK后，了解如何组织源代码文件是非常关键的。

在Android项目中，原生代码文件通常被放置在 app/src/main/cpp/ 目录下。这个目录是Android Studio默认识别的原生代码目录。在该目录下，你可能会看到一个或多个子目录，用来存放不同模块或库的原生源代码。

2.3.2 构建脚本(CMakeLists.txt)解析

CMakeLists.txt 文件是CMake项目的构建脚本，用来定义如何编译和链接你的原生代码。

下面是一个简单的 CMakeLists.txt 示例：

# 设置最小支持的CMake版本
cmake_minimum_required(VERSION 3.4.1)

# 设置项目名称
project("native-lib")

# 寻找系统中的NDK路径
find_library(log-lib log)

# 添加一个可执行文件，名称为native-lib
add_library( # Sets the name of the library.
             native-lib

             # Sets the library as a shared library.
             SHARED

             # Provides a relative path to your source file(s).
             native-lib.cpp )

# 查找并链接log库到我们的可执行文件
target_link_libraries( native-lib ${log-lib} )

在这个脚本中，我们首先指定了所需的CMake的最低版本。然后我们声明了项目名称，并设置了源代码文件和目标库。最后，我们通过 target_link_libraries 命令把Android的日志库（log-lib）链接到我们的原生库中。当构建项目时，CMake会读取此脚本，并根据指令编译和链接代码。

通过以上步骤，我们成功地将NDK集成到了Android Studio，并设置好了基本的构建流程和项目结构。接下来，我们将通过实际编写一个简单的原生代码示例，进一步加深对Android Studio和NDK集成过程的理解。

3. HelloWorld示例步骤解析

构建一个简单的“HelloWorld”项目是学习任何技术的基础，尤其对于理解Android NDK的集成和使用来说更是如此。本章节将逐步引导你完成一个使用NDK的HelloWorld示例的创建、编码、构建和运行，通过这个过程，你能深入理解NDK项目的基本结构和关键组件。

3.1 创建HelloWorld项目

3.1.1 使用Android Studio创建新项目

首先，打开Android Studio并启动一个新的项目。选择一个基本的Activity模板，例如"Empty Activity"，然后设置你的项目名称为"HelloWorldNDK"，选择项目的保存位置，设置好语言（这里我们选择Java），最小的API等级要满足你的需求，这里我们假定为API 21（Android 5.0 Lollipop）。

点击"Finish"，Android Studio会开始创建项目，并且自动配置一些基础的文件和设置。

3.1.2 添加native支持

创建项目之后，接下来需要为项目添加native支持。打开项目的 build.gradle 文件，并在 defaultConfig 部分添加如下代码：

android {
    ...
    defaultConfig {
        ...
        externalNativeBuild {
            cmake {
                cppFlags ""
            }
        }
    }
    ...
    externalNativeBuild {
        cmake {
            path "CMakeLists.txt"
        }
    }
}

以上代码定义了CMake构建脚本的路径，并为CMake提供了构建选项。

然后，在项目的根目录下创建一个名为 CMakeLists.txt 的文件，并添加如下基础配置：

cmake_minimum_required(VERSION 3.4.1)

add_library( # Sets 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 )

find_library( # Sets the name of the path variable.
              log-lib

              # Specifies the name of the NDK library that
              # you want CMake to locate.
              log )

target_link_libraries( # Specifies the target library.
                       native-lib

                       # Links the target library to the log library
                       # included in the NDK.
                       ${log-lib} )

这段代码配置了一个名为 native-lib 的共享库，它是用C++编写的，并且告诉CMake在哪里找到源文件。同时， find_library 命令寻找了系统日志库 log-lib ，以便能够在native代码中使用Android的日志功能。

现在，项目已经为添加native代码做好了准备，接下来我们将编写这部分代码。

3.2 编写原生代码

3.2.1 创建C/C++源文件

在 src/main/cpp 目录下创建一个名为 native-lib.cpp 的文件，然后添加如下代码：

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

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

这是一个简单的JNI方法的实现，它返回一个字符串。这里的 Java_com_example_helloworldndk_MainActivity_stringFromJNI 是Java Native Interface的函数名，遵循一定的命名规则，其中 com_example_helloworldndk_MainActivity 是Java类的全路径名， stringFromJNI 是Java方法名。

3.2.2 编写JNI接口函数

在Android项目中，编写JNI接口函数是让Java代码和C/C++代码协同工作的桥梁。继续上面的 native-lib.cpp ，确保你已经正确地定义了一个JNI函数。

#include <jni.h>

extern "C" JNIEXPORT void JNICALL
Java_com_example_helloworldndk_MainActivity_nativeSayHello(
        JNIEnv* env,
        jobject instance) {
    // This simply calls the native method that we declared in 'native-lib.cpp'
    jstring jstr = env->CallStaticObjectMethod(
            env->FindClass("com/example/helloworldndk/NativeLib"),
            env->GetStaticMethodID(env->FindClass("com/example/helloworldndk/NativeLib"),
                                   "stringFromJNI",
                                   "()Ljava/lang/String;"),
            nullptr);
    const char* nativeString = env->GetStringUTFChars(jstr, 0);
    __android_log_print(ANDROID_LOG_INFO, "HelloWorldNDK", "%s", nativeString);
    env->ReleaseStringUTFChars(jstr, nativeString);
}

在这个函数中， env->CallStaticObjectMethod 调用了一个Java静态方法（这里的 stringFromJNI 方法），并打印出从这个方法返回的字符串。

3.3 构建和运行HelloWorld

3.3.1 构建项目和生成APK

在Android Studio中，构建项目通常很简单。选择"Build" -> "Rebuild Project"，然后等待Android Studio完成项目的编译和构建。如果一切顺利，Android Studio将自动在模拟器或连接的设备上运行应用。

3.3.2 在设备或模拟器上运行

一旦构建完成，你可以看到模拟器启动或看到连接设备上安装了APK。点击应用图标后，你应该能够看到应用界面显示"Hello from C++"。

至此，你的HelloWorld应用已经构建完成，并且你可以看到在Android设备上运行的原生代码。这个过程不仅仅是对NDK的入门介绍，也是理解更复杂原生应用开发的第一步。

通过以上步骤，你已经完成了从创建项目、添加native支持、编写原生代码到构建和运行的整个流程。这些步骤为深入学习Android NDK的高级特性打下了坚实的基础，为后续章节中更复杂的原生开发案例做好了铺垫。

接下来，第四章将探索原生代码的详细开发流程、调试方法、与Java的交互细节以及性能优化策略。

4. 原生代码开发流程

4.1 原生代码的编写和调试

4.1.1 使用C/C++编写原生代码

原生代码的编写是利用Android NDK进行应用开发的核心。开发者需要熟悉C或C++语言以及相关的编程范式。C语言因其接近硬件的特性和高效性，一直是编写系统级代码的首选。C++则提供了面向对象的编程特性，使得代码更加模块化和易于维护。在选择使用C或C++编写原生代码时，开发者应根据应用需求和个人偏好来决定。

示例代码块

下面的代码块展示了如何编写一个简单的C语言原生函数，该函数执行一个简单的计算任务。

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

// 一个简单的原生函数，计算两个整数的和并返回
JNIEXPORT jint JNICALL
Java_com_example_myapp_MainActivity_addNumbers(JNIEnv *env, jobject instance, jint num1, jint num2) {
    return num1 + num2;
}

参数说明： - JNIEnv *env : 提供了对Java环境的接口，用于访问Java虚拟机的功能。 - jobject instance : 对应Java中的实例对象。 - jint num1 和 jint num2 : 传入的两个整数参数。 - return : 返回计算结果。

代码逻辑分析：

此段代码定义了一个名为 Java_com_example_myapp_MainActivity_addNumbers 的原生函数。这个函数被设计为与Java类 MainActivity 在 com.example.myapp 包中关联，函数名称符合JNI的命名规则（前缀 Java_ ，完整的类名，方法名以及参数签名）。此函数简单地接受两个整数参数，计算它们的和并返回。

4.1.2 使用Android NDK的调试工具

在开发原生代码时，调试工具的使用是必不可少的。Android NDK提供了对GDB的支持，允许开发者对原生代码进行调试。

调试步骤：

启动GDB调试会话： 在构建项目时生成的可执行文件上启动GDB。
设置断点： 使用GDB命令设置断点来暂停代码执行，以便检查调用堆栈、变量状态等。
运行和单步执行： 运行程序，并在需要时单步执行代码。
检查和修改变量： 查看当前变量的值，甚至在运行时修改它们。
内存分析： 分析原生代码的内存使用情况，查找内存泄漏等问题。

示例调试命令：

(gdb) break main
(gdb) run
(gdb) next
(gdb) print variable_name
(gdb) set variable_name = new_value

参数说明： - break main : 在 main 函数入口设置断点。 - run : 执行程序。 - next : 单步执行代码。 - print variable_name : 打印变量 variable_name 的值。 - set variable_name = new_value : 将变量 variable_name 的值设置为 new_value 。

通过这些步骤和命令，开发者可以有效地对原生代码进行调试，确保其稳定性和性能。在实际开发中，调试工具和方法应根据具体的调试需求和场景灵活运用。

5. NDK优势与应用场景

5.1 NDK的优势分析

5.1.1 针对CPU密集型任务的性能提升

当应用程序遇到需要大量计算的场景时，使用NDK可以显著提高性能。通过直接在CPU级别执行操作，原生代码能够绕过虚拟机层，减少解释执行的开销。例如，在游戏开发中，复杂的物理计算或者渲染任务可以通过原生代码实现，以达到更平滑的动画效果和更快的渲染速度。

5.1.2 重用现有的C/C++库

许多成熟的算法和框架是用C或C++编写的，通过NDK可以在Android平台上重用这些库。开发者不需要重新实现已有的功能，而是可以通过JNI将现有的C/C++代码集成到Android应用中。这种做法不仅缩短了开发周期，还因为利用了已有资源，降低了开发成本。

5.2 NDK的应用场景

5.2.1 游戏开发中的应用

在游戏开发中，NDK的使用极为广泛。游戏通常包含复杂的3D图形渲染和物理计算，这些都是典型的CPU密集型任务。通过使用OpenGL ES等图形API，以及在游戏逻辑中利用原生代码处理复杂计算，可以极大提升游戏性能和响应速度。

5.2.2 高性能计算和图形处理

不仅限于游戏，高性能计算和图形处理对于许多专业应用同样重要。比如视频处理应用，需要快速进行帧编码和解码，使用NDK可以实现更高效的视频处理算法。此外，数据分析和科学计算中也会利用NDK进行高速运算。

5.3 NDK未来发展趋势

5.3.1 与Android平台的整合演进

随着Android平台的不断演进，NDK也在持续更新以适应新的硬件和软件需求。比如，Android设备现在普遍支持64位处理器，NDK相应地提供了64位的支持。未来，随着5G和边缘计算的发展，NDK将会进一步优化，以支持这些新技术带来的新应用场景。

5.3.2 社区和开发者生态支持

NDK的发展同样离不开广大开发者的贡献。随着社区对NDK的支持和贡献增加，我们可以预见到会有更多的工具和框架出现，帮助开发者更容易地使用NDK。例如，社区可能会开发出更多自动化的构建工具，简化原生代码的编译和链接过程。

graph LR
A[开始] --> B[Android Studio与NDK集成]
B --> C[HelloWorld示例步骤解析]
C --> D[原生代码开发流程]
D --> E[NDK优势与应用场景]

以上流程图展示了文章的结构，以及当前章节在整体内容中的位置。本章节详细阐述了NDK的优势，包括它在性能提升和资源重用方面的显著作用，以及在游戏开发和高性能计算中的实际应用。同时，文章也对NDK的未来发展趋势进行了展望，强调了其在Android平台整合中的演变，以及社区支持的重要性。接下来的章节将深入分析如何利用NDK进行具体的应用开发和性能优化。

本文还有配套的精品资源，点击获取