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