Flutter 斐波那契数列计算插件 grades_native_fibonacci 的使用

grades_native_fibonacci

一个用于 Flutter 的 FFI 插件项目。

开始使用

这个项目是一个 Flutter FFI 插件的起点。FFI 插件是一种特殊的包，它直接通过 Dart FFI 调用原生代码。

项目结构

此模板使用以下结构：

• src：包含原生源代码，并且有一个 CmakeFile.txt 文件用于构建这些源代码为动态库。
• lib：包含定义插件 API 的 Dart 代码，该代码使用 dart:ffi 调用原生代码。
• 平台文件夹（如 android、ios 等）：包含用于构建和捆绑原生代码库到平台应用的构建文件。

构建和捆绑原生代码

pubspec.yaml 文件以如下方式指定 FFI 插件：

plugin:
  platforms:
    some_platform:
      ffiPlugin: true

这种配置会针对各个目标平台调用原生构建，并将二进制文件捆绑到使用这些 FFI 插件的 Flutter 应用程序中。

这可以与 dartPluginClass 结合使用，例如在联合插件中使用 FFI 实现某个平台：

plugin:
  implements: some_other_plugin
  platforms:
    some_platform:
      dartPluginClass: SomeClass
      ffiPlugin: true

插件可以同时具有 FFI 和方法通道：

plugin:
  platforms:
    some_platform:
      pluginClass: SomeName
      ffiPlugin: true

由 FFI（和方法通道）插件调用的原生构建系统包括：

• 对于 Android：Gradle，它调用 Android NDK 进行原生构建。
  • 参见 android/build.gradle 文档。
• 对于 iOS 和 MacOS：Xcode，通过 CocoaPods。
  • 参见 ios/grades_native_fibonacci.podspec 文档。
  • 参见 macos/grades_native_fibonacci.podspec 文档。
• 对于 Linux 和 Windows：CMake。
  • 参见 linux/CMakeLists.txt 文档。
  • 参见 windows/CMakeLists.txt 文档。

绑定到原生代码

要使用原生代码，需要在 Dart 中创建绑定。为了避免手动编写这些绑定，它们可以通过 package:ffigen 从头文件 (src/grades_native_fibonacci.h) 生成。通过运行 dart run ffigen --config ffigen.yaml 可以重新生成绑定。

调用原生代码

非常短的原生函数可以直接从任何隔离区调用。例如，参见 lib/grades_native_fibonacci.dart 中的 fib 函数。

较长的函数应该在一个辅助隔离区中调用，以避免在 Flutter 应用程序中丢失帧。例如，参见 lib/grades_native_fibonacci.dart 中的 fibAsync 函数。

Flutter 帮助

有关如何开始使用 Flutter 的帮助，请查看我们的 在线文档，其中包含教程、示例、移动开发指南以及完整的 API 参考。

示例代码

以下是 example/lib/main.dart 的示例代码：

import 'package:flutter/material.dart';
import 'dart:async';

import 'package:grades_native_fibonacci/grades_native_fibonacci.dart' as grades_native_fibonacci;

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  late int fibResult;
  late Future<int> fibAsyncResult;

  [@override](/user/override)
  void initState() {
    super.initState();
    // 直接调用原生函数 fib(4)
    fibResult = grades_native_fibonacci.fib(4);
    // 异步调用原生函数 fibAsync(5)
    fibAsyncResult = grades_native_fibonacci.fibAsync(5);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    const textStyle = TextStyle(fontSize: 25);
    const spacerSmall = SizedBox(height: 10);
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Native Packages'),
        ),
        body: SingleChildScrollView(
          child: Container(
            padding: const EdgeInsets.all(10),
            child: Column(
              children: [
                const Text(
                  '这个函数通过 FFI 调用了原生函数，该原生函数作为源代码包含在包中。'
                  '原生代码作为 Flutter 运行器构建的一部分进行构建。',
                  style: textStyle,
                  textAlign: TextAlign.center,
                ),
                spacerSmall,
                Text(
                  'fib(4) = $fibResult',
                  style: textStyle,
                  textAlign: TextAlign.center,
                ),
                spacerSmall,
                FutureBuilder<int>(
                  future: fibAsyncResult,
                  builder: (BuildContext context, AsyncSnapshot<int> value) {
                    final displayValue = (value.hasData) ? value.data : 'loading';
                    return Text(
                      'await fibAsync(5) = $displayValue',
                      style: textStyle,
                      textAlign: TextAlign.center,
                    );
                  },
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}