Android搭建NDK开发环境及第一个JNI程序，常见问题有哪些？

Android搭建NDK开发环境及第一个JNI调用程序

在Android开发中，NDK（Native Development Kit）允许开发者使用C/C++语言编写高性能代码，与Java/Kotlin代码交互，本文将详细介绍如何搭建NDK开发环境，并实现第一个JNI调用程序。

NDK开发环境搭建

1. 安装Android Studio
   确保已安装最新版本的Android Studio，它是开发Android应用的主要工具，从Android开发者官网下载并安装，按照向导完成配置。

2. 配置NDK与CMake
   打开Android Studio，进入Tools > SDK Manager，在SDK Platforms标签页勾选所需的Android版本（如API 21及以上），在SDK Tools标签页，勾选NDK (Side by side)和CMake，点击Apply安装，安装完成后，NDK路径通常位于$SDK/ndk/版本号，CMake路径位于$SDK/cmake/版本号。

3. 创建支持NDK的项目
   新建Android项目时，选择Native C++模板，Android Studio会自动配置CMake和JNI相关文件，若已有项目，可通过右键模块 > Add > C++ to Module添加原生支持。

4. 配置本地.properties文件
   在项目根目录的local.properties文件中，手动添加NDK路径（若未自动生成）：

   ndk.dir=/path/to/your/ndk  

   确保路径正确，避免编译时提示找不到NDK。

第一个JNI调用程序

1. 生成JNI头文件
   在Java类中声明native方法，

   public class NativeUtils {  
       static {  
           System.loadLibrary("native-lib");  
       }  
       public native String stringFromJNI();  
   }  

   使用javac编译Java文件，并通过javah生成头文件（Android Studio中可右键类 > Generate > JNI Header）：

   javac NativeUtils.java  
   javah -jni com.example.NativeUtils  

   生成的头文件（如com_example_NativeUtils.h）包含JNI函数声明。

2. 实现C/C++代码
   在cpp目录下创建native-lib.cpp，实现头文件中的函数：

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

   • extern "C"确保C++编译器以C方式链接函数名。
   • JNIEnv*提供JNI接口，jobject代表当前Java对象。

3. 配置CMakeLists.txt
   在app/CMakeLists.txt中添加NDK配置：

   cmake_minimum_required(VERSION 3.4.1)  
   add_library(  
       native-lib  
       SHARED  
       native-lib.cpp  
   )  
   find_library(  
       log-lib  
       log  
   )  
   target_link_libraries(  
       native-lib  
       ${log-lib}  
   )  

   • add_library定义共享库native-lib，关联native-lib.cpp。
   • target_link_libraries链接日志库（可选）。

4. 调用JNI方法
   在Activity中加载库并调用方法：

   public class MainActivity extends AppCompatActivity {  
       static {  
           System.loadLibrary("native-lib");  
       }  
       @Override  
       protected void onCreate(Bundle savedInstanceState) {  
           super.onCreate(savedInstanceState);  
           setContentView(R.layout.activity_main);  
           TextView tv = findViewById(R.id.sample_text);  
           tv.setText(NativeUtils.stringFromJNI());  
       }  
   }  

5. 编译与运行
   点击Android Studio的运行按钮，NDK会自动编译C/C++代码并生成.so库，最终应用运行时会调用JNI方法并显示结果。

常见问题与解决

1. 问题：编译时报错“undefined reference to `Java_XXX”
   解答：检查函数名是否与JNI规范一致（如Java_包名_类名_方法名），确保CMakeLists.txt中正确添加了源文件。

2. 问题：无法加载.so库（UnsatisfiedLinkError）
   解答：确认System.loadLibrary("native-lib")中的库名与CMakeLists.txt中的add_library一致，并检查ABI是否匹配（如armeabi-v7a）。

通过以上步骤，你已成功搭建NDK环境并实现JNI调用，NDK为Android开发提供了更灵活的性能优化空间，适用于游戏引擎、音视频处理等场景。