android flutter aar

原创

mob649e8158ed1f 2024-10-12 04:31:02 ©著作权

文章标签 Android flutter 开发者 文章分类 Android 移动开发

©著作权归作者所有：来自51CTO博客作者mob649e8158ed1f的原创作品，请联系作者获取转载授权，否则将追究法律责任

如何实现 Android Flutter AAR？——新手开发者指南

在现代开发中，Flutter 作为一种跨平台的开发框架，越来越受到欢迎。通常，我们的项目中会涉及到与原生 Android 代码的集成。有时，我们需要将 Flutter 代码打包成 AAR（Android Archive）。本文将详细指导你如何实现这一过程，并提供示例代码和图表。

流程步骤

下面的表格展示了实现 Android Flutter AAR 的流程步骤：

步骤	描述
1. 创建 Flutter 插件	使用 Flutter 工具创建一个插件项目。
2. 编写 Flutter 代码	在插件中添加必要的 Dart 代码。
3. 编写 Android 代码	在插件的 Android 子项目中编写必要的 Java/Kotlin 代码。
4. 创建 AAR	使用 Gradle 构建工具生成 AAR 文件。
5. 使用 AAR	在 Android 项目中引入并使用生成的 AAR 文件。

步骤详解

1. 创建 Flutter 插件

首先，我们需要创建一个 Flutter 插件。

flutter create --template=plugin my_flutter_plugin

这条命令会创建一个名为 my_flutter_plugin 的项目，并遵循插件架构。

2. 编写 Flutter 代码

进入项目的 lib 目录，您会找到 my_flutter_plugin.dart 文件。在这里，您可以添加 Flutter 的功能代码。

library my_flutter_plugin;

import 'dart:async';

class MyFlutterPlugin {
  static Future<String> get platformVersion async {
    return 'Flutter on Android';
  }
}

上面的代码定义了一个简单的库，返回当前的 Flutter 版本。

3. 编写 Android 代码

接下来，进入项目的 android/src/main/kotlin 目录。在这里，您可以编写原生的 Kotlin 代码（如果您使用 Java，则为 java 目录）。

package com.example.my_flutter_plugin

import androidx.annotation.NonNull
import io.flutter.embedding.engine.plugins.FlutterPlugin
import io.flutter.plugin.common.MethodCall
import io.flutter.plugin.common.MethodChannel

class MyFlutterPlugin: FlutterPlugin, MethodChannel.MethodCallHandler {
    private lateinit var channel : MethodChannel

    override fun onAttachedToEngine(@NonNull flutterPluginBinding: FlutterPlugin.FlutterPluginBinding) {
        channel = MethodChannel(flutterPluginBinding.binaryMessenger, "my_flutter_plugin")
        channel.setMethodCallHandler(this)
    }

    override fun onMethodCall(@NonNull call: MethodCall, @NonNull result: MethodChannel.Result) {
        if (call.method == "getPlatformVersion") {
            result.success("Android ${android.os.Build.VERSION.RELEASE}")
        } else {
            result.notImplemented()
        }
    }

    override fun onDetachedFromEngine(@NonNull binding: FlutterPlugin.FlutterPluginBinding) {
        channel.setMethodCallHandler(null)
    }
}

上面的 Kotlin 代码实现了一个简单的插件，响应 Flutter 的方法调用，返回 Android 系统版本。

4. 创建 AAR

在 android 目录中，打开 build.gradle 文件，确保添加以下行：

apply plugin: 'com.android.library'

// 其他必要的配置
android {
    compileSdkVersion 30

    defaultConfig {
        minSdkVersion 16
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
    }
}

这段代码设置了插件的编译环境和版本信息。

然后在终端中运行以下命令来生成 AAR 文件：

./gradlew build

生成的 AAR 文件会在 build/outputs/aar/ 目录中找到。

5. 使用 AAR

将生成的 AAR 文件拷贝到您的 Android 项目中，并在该项目的 build.gradle 文件中引入：

repositories {
    flatDir {
        dirs 'libs' // AAR 文件所在的目录
    }
}

dependencies {
    implementation(name: 'my_flutter_plugin-release', ext: 'aar')
}

这会将 AAR 文件添加到您的 Android 项目中。

旅行图

journey
    title Flutter AAR 创建旅行
    section 创建插件
      创建 Flutter 插件: 5: Flutter开发者
      进入插件目录: 5: Flutter开发者
    section 编写代码
      添加Dart代码: 5: Flutter开发者
      添加Kotlin代码: 5: Flutter开发者
    section 打包与使用
      生成AAR文件: 5: Flutter开发者
      在Android项目中引入AAR: 5: Flutter开发者

甘特图

gantt
    title Flutter AAR 开发计划
    dateFormat  YYYY-MM-DD
    section 创建插件
    创建插件                :a1, 2023-10-01, 1d
    section 编写代码
    编写Dart代码              :a2, after a1, 2d
    编写Kotlin代码            :a3, after a2, 2d
    section 打包与使用
    生成AAR文件               :a4, after a3, 1d
    引入并使用AAR             :a5, after a4, 1d