Flutter 與 NDK 集成實現

Flutter 可以通過 Platform Channels 與原生代碼（包括使用 NDK 編寫的 C/C++ 代碼）進行交互。以下是實現 Flutter 與 NDK 集成的步驟：

基本步驟

1. 創建 Flutter 項目

flutter create flutter_ndk_example
cd flutter_ndk_example

2. 添加 Android NDK 支持

在 android/app/build.gradle 中添加 NDK 配置：

android {// ...defaultConfig {// ...externalNativeBuild {cmake {cppFlags "-std=c++17"}}ndk {abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'}}externalNativeBuild {cmake {path "CMakeLists.txt"}}
}

3. 創建 CMakeLists.txt 文件

在 android/app 目錄下創建 CMakeLists.txt：

cmake_minimum_required(VERSION 3.4.1)add_library(native-libSHAREDsrc/main/cpp/native-lib.cpp
)find_library(log-liblog
)target_link_libraries(native-lib${log-lib}
)

4. 創建 C++ 源文件

在 android/app/src/main/cpp 目錄下創建 native-lib.cpp：

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

5. 創建 Method Channel 接口

在 lib/main.dart 中：

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';void main() {runApp(MyApp());
}class MyApp extends StatelessWidget {static const platform = MethodChannel('com.example.flutterndkexample/channel');Future<String> _getNativeString() async {try {return await platform.invokeMethod('getNativeString');} on PlatformException catch (e) {return "Failed to get string: '${e.message}'.";}}@overrideWidget build(BuildContext context) {return MaterialApp(home: Scaffold(appBar: AppBar(title: Text('Flutter NDK Example')),body: Center(child: FutureBuilder<String>(future: _getNativeString(),builder: (BuildContext context, AsyncSnapshot<String> snapshot) {if (snapshot.hasData) {return Text(snapshot.data!);} else if (snapshot.hasError) {return Text("Error: ${snapshot.error}");}return CircularProgressIndicator();},),),),);}
}

6. 實現 Android 端的 Method Channel

在 android/app/src/main/kotlin/.../MainActivity.kt 中：

package com.example.flutterndkexampleimport io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannelclass MainActivity: FlutterActivity() {private val CHANNEL = "com.example.flutterndkexample/channel"override fun configureFlutterEngine(flutterEngine: FlutterEngine) {super.configureFlutterEngine(flutterEngine)MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler {call, result ->if (call.method == "getNativeString") {result.success(stringFromJNI())} else {result.notImplemented()}}}external fun stringFromJNI(): Stringcompanion object {init {System.loadLibrary("native-lib")}}
}

更復雜的 NDK 功能示例

1. 添加數學計算函數

在 native-lib.cpp 中添加：

extern "C" JNIEXPORT jint JNICALL
Java_com_example_flutterndkexample_MainActivity_addNumbers(JNIEnv* env,jobject /* this */,jint a,jint b) {return a + b;
}

2. 更新 Kotlin 代碼

external fun addNumbers(a: Int, b: Int): Int// 在 MethodCallHandler 中添加
if (call.method == "addNumbers") {val a = call.argument<Int>("a") ?: 0val b = call.argument<Int>("b") ?: 0result.success(addNumbers(a, b))
}

3. 更新 Dart 代碼

Future<int> _addNumbers(int a, int b) async {try {return await platform.invokeMethod('addNumbers', {'a': a, 'b': b});} on PlatformException catch (e) {print("Failed to add numbers: '${e.message}'.");return 0;}
}

iOS 平臺的 NDK 實現（使用 Objective-C/Swift 調用 C++）

對于 iOS，Flutter 可以直接與 Objective-C/Swift 交互，后者可以調用 C++ 代碼：

1. 在 ios/Runner 目錄下創建 C++ 文件
2. 創建對應的頭文件
3. 在 AppDelegate.swift 中實現 Method Channel

最佳實踐

1. 盡量減少平臺通道的調用次數（批量處理數據）
2. 對于性能敏感的操作使用 NDK
3. 錯誤處理要完善
4. 考慮不同 Android ABI 的兼容性
5. 對于復雜的 C++ 代碼，考慮使用 FFI（Dart 2.12+ 支持）

通過以上步驟，你可以成功地將 Flutter 應用與 NDK 編寫的原生代碼集成，實現高性能的計算或訪問特定的原生功能。