Android NDK 示例项目教程

1. 项目的目录结构及介绍

Android NDK 示例项目的目录结构如下：

ndk-samples/
├── hello-jni/
├── hello-jniCallback/
├── hello-libs/
├── hello-gl2/
├── bitmap-plasma/
├── teapots/
├── more-teapots/
├── san-angeles/
├── native-plasma/
├── native-activity/
├── native-audio/
├── native-codec/
├── native-media/
├── native-midi/
├── native-plasma/
├── webp/
└── README.md

每个子目录代表一个示例项目，例如 hello-jni 展示了如何使用 JNI 调用本地代码，hello-gl2 展示了如何使用 OpenGL ES 2.0 进行图形渲染。

2. 项目的启动文件介绍

每个示例项目的启动文件通常是 MainActivity.java 或 main.cpp，具体取决于项目是使用 Java 还是 C++ 编写的。

例如，在 hello-jni 项目中，启动文件是 MainActivity.java，它负责加载本地库并调用本地方法。

public class MainActivity extends AppCompatActivity {
    static {
        System.loadLibrary("hello-jni");
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        TextView tv = findViewById(R.id.sample_text);
        tv.setText(stringFromJNI());
    }

    public native String stringFromJNI();
}

在 hello-gl2 项目中，启动文件是 hello-gl2.cpp，它负责初始化 OpenGL ES 2.0 并进行渲染。

void android_main(struct android_app* state) {
    app_dummy();

    MyApp app;
    app.Init(state);

    while (1) {
        int ident;
        int events;
        struct android_poll_source* source;

        while ((ident = ALooper_pollAll(app.IsReady() ? 0 : -1, NULL, &events, (void**)&source)) >= 0) {
            if (source != NULL) {
                source->process(state, source);
            }

            if (state->destroyRequested != 0) {
                app.TermDisplay();
                return;
            }
        }

        if (app.IsReady()) {
            app.DrawFrame();
        }
    }
}

3. 项目的配置文件介绍

每个示例项目的配置文件通常包括 build.gradle 和 AndroidManifest.xml。

build.gradle

build.gradle 文件定义了项目的构建配置，包括依赖项、构建类型和产品风味等。

例如，在 hello-jni 项目中，build.gradle 文件如下：

apply plugin: 'com.android.application'

android {
    compileSdkVersion 30
    defaultConfig {
        applicationId "com.example.hellojni"
        minSdkVersion 21
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
        externalNativeBuild {
            cmake {
                cppFlags "-std=c++14"
            }
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
    externalNativeBuild {
        cmake {
            path "CMakeLists.txt"
        }
    }
}

dependencies {
    implementation 'androidx.appcompat:appcompat:1.2.0'
}

AndroidManifest.xml

AndroidManifest.xml 文件定义了应用程序的组件、权限和其他配置。

例如，在 hello-jni 项目中，AndroidManifest.xml 文件如下：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.hellojni">

    <application
        android:allow