Android NDK 示例项目教程

Android NDK 示例项目教程

ndk-samples 项目地址: https://gitcode.com/gh_mirrors/ndks/ndk-samples

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

Android NDK 示例项目包含了多个使用 Android NDK 的示例应用，每个示例都展示了如何使用 NDK 进行 Android 应用开发。项目的目录结构如下：

• audio-echo: 音频回声示例
• base: 基础示例，展示了 NDK 的基础用法
• bitmap-plasma: 位图等离子体效果示例
• build-logic: 构建逻辑相关文件
• camera: 相机使用示例
• docs: 项目文档
• endless-tunnel: 无尽隧道游戏示例
• exceptions: 异常处理示例
• gles3jni: OpenGL ES 3.0 使用示例
• gradle: Gradle 构建文件
• hello-gl2: OpenGL ES 2.0 使用示例
• hello-jni: JNI 使用示例
• hello-jniCallback: JNI 回调示例
• hello-libs: 静态库和动态库使用示例
• hello-neon: NEON 指令集使用示例
• hello-oboe: Oboe 音频库使用示例
• hello-vulkan: Vulkan 使用示例
• native-activity: 原生活动示例
• native-audio: 原生音频播放和录制示例
• native-codec: 原生编解码器示例
• native-media: 原生媒体框架使用示例
• native-midi: MIDI 音频接口示例
• native-plasma: 等离子体效果示例
• nn-samples: Neural Networks API 使用示例
• orderfile: 排序文件示例
• prefab:Prefab 构建系统示例
• san-angeles: 简单的 3D 游戏示例
• sanitizers: 运行时检查工具使用示例
• sensor-graph: 传感器数据可视化示例
• teapots: 使用 OpenGL ES 渲染茶壶的示例
• unit-test: 单元测试示例
• .clang-format: Clang 格式配置文件
• .gitignore: Git 忽略文件
• ARCHITECTURE.md: 项目架构介绍
• CONTRIBUTING.md: 贡献指南
• LICENSE: 项目许可证
• README.md: 项目说明文件
• REFERENCE.md: 项目参考文档
• build.gradle: 项目构建脚本
• gradle.properties: Gradle 属性文件
• gradlew: Gradle 命令行工具
• gradlew.bat: Windows 系统下的 Gradle 命令行工具
• settings.gradle: Gradle 设置文件

每个示例目录下通常包含了对应的 Android 应用项目和原生代码。

2. 项目的启动文件介绍

在 Android NDK 示例项目中，每个示例应用都有自己的启动文件。例如，在 hello-jni 示例中，启动文件是 MainActivity.java。这个文件是 Android 应用的入口点，它负责创建应用的用户界面并初始化原生代码。

package com.example.hellojni;

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.TextView;

public class MainActivity extends AppCompatActivity {

    // 加载名为 "hello-jni" 的本地库
    static {
        System.loadLibrary("hello-jni");
    }

    // 原生方法声明
    public native String stringFromJNI();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 获取 TextView 并设置文本
        TextView tv = findViewById(R.id.sample_text);
        tv.setText(stringFromJNI());
    }
}

在这个文件中，System.loadLibrary("hello-jni"); 语句用于加载名为 "hello-jni" 的本地库，而 stringFromJNI() 是一个原生方法，它将在对应的 C 或 C++ 文件中实现。

3. 项目的配置文件介绍

项目的配置文件主要包括 build.gradle 和 gradle.properties。

• build.gradle 文件定义了项目的构建逻辑，包括依赖关系、构建任务和 Android 插件配置等。

// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath "com.android.tools.build:gradle:4.1.0"
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        google()
        jcenter()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

• gradle.properties 文件包含了一些影响构建过程的属性，例如 Gradle 的 JVM 参数。

# Project-wide Gradle settings.

# Specifies the JVM arguments used for the daemon process.
# The setting is particularly useful for debugging purposes, e.g. to enable JMX agent
# You can set these options in the gradle.properties file for sub-projects as well.
org.gradle.jvmargs=-Xmx1536m

# Enable JVM assertions. Disable this option for production builds.
org.gradle.jvmargs=-ea

# Set Gradle's parallel execution mode. Enable this option to allow Gradle to execute
# multiple tasks in parallel where possible.
org.gradle.parallel=true

# Enable daemons to run builds in the background (useful for CI systems).
org.gradle.daemon=true

# Disable the generation of Gradle wrapper files. Gradle wrapper files make it easier to
# run Gradle from the command line, but they are unnecessary for continuous integration
# systems that run Gradle using the Gradle distribution.
org.gradle.wrapper=true

通过这些配置文件，开发者可以定制和优化项目的构建过程。

ndk-samples 项目地址: https://gitcode.com/gh_mirrors/ndks/ndk-samples