Flutter外部函数接口插件cedar_ffi的使用

Flutter 外部函数接口插件 cedar_ffi 的使用

cedar_ffi 是一个用于在 Dart 中调用 Cedar 策略引擎的外部函数接口（FFI）库。Cedar 是一个策略引擎，可以用来处理复杂的授权决策。

使用

该库使用 Dart 的原生资产功能将 Cedar 策略引擎编译并链接到任何 Dart 或 Flutter 应用程序中。由于 Cedar 是用 Rust 编写的，因此使用此库还需要安装最新的稳定版 Rust 工具链。

可以在以下示例中查看如何使用该库：

https://github.com/celest-dev/cedar-dart/blob/main/packages/cedar_ffi/example/bin/example.dart


### 开发

Cedar 策略语言是用 Rust 编写的。为了在 Dart 中调用 Cedar，我们在 `src` 目录下编写了一些轻量级绑定，使得 Dart 可以调用 Rust 库。

#### 生成 FFI 绑定

FFI 绑定是使用 `ffigen` 工具生成的。要重新生成绑定，请运行以下命令：

```bash
$ dart --enable-experiment=native-assets run ffigen

完整示例

以下是一个完整的示例，展示了如何使用 cedar_ffi 包来评估授权决策。

首先，确保你已经安装了最新版本的 Rust 工具链，并且已经在你的 Dart 项目中添加了 cedar_ffi 依赖。

添加依赖

在 pubspec.yaml 文件中添加 cedar_ffi 依赖：

dependencies:
  cedar_ffi: ^0.1.0

然后运行 flutter pub get 来获取依赖。

示例代码

创建一个名为 main.dart 的文件，并添加以下代码：

import 'package:cedar_ffi/cedar_ffi.dart';

void main() {
  // 初始化 Cedar 引擎
  final cedar = Cedar();

  // 定义一个简单的策略
  final policy = '''
    principal "Alice" has permission "create" on resource "todo";
  ''';

  // 定义上下文
  final context = EvaluationContext(
    principal: "Alice",
    action: "create",
    resource: "todo",
  );

  // 评估授权决策
  final result = cedar.evaluate(policy, context);

  // 输出结果
  if (result) {
    print('Alice 可以创建待办事项列表！');
  } else {
    print('Alice 无法创建待办事项列表。');
  }
}

运行示例

在终端中运行以下命令来执行示例：

$ dart --enable-experiment=native-assets run bin/main.dart

你应该会看到以下输出：

Alice 可以创建待办事项列表！

更多关于Flutter外部函数接口插件cedar_ffi的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter外部函数接口插件cedar_ffi的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


cedar_ffi 是一个 Flutter 插件，它允许你在 Flutter 应用中通过 FFI（Foreign Function Interface）调用本地代码（如 C/C++）。使用 cedar_ffi 可以帮助你提高性能，尤其是在需要执行计算密集型任务或访问本地系统功能时。

以下是如何在 Flutter 项目中使用 cedar_ffi 的基本步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 cedar_ffi 依赖：

dependencies:
  flutter:
    sdk: flutter
  cedar_ffi: ^0.1.0  # 使用最新版本

然后运行 flutter pub get 来获取依赖。

2. 创建本地代码

在 lib 目录下创建一个新的文件夹，例如 native，并在其中创建一个 C 文件，例如 native.c：

#include <stdint.h>

int32_t add(int32_t a, int32_t b) {
    return a + b;
}

3. 生成 FFI 绑定

使用 ffigen 工具生成 FFI 绑定。首先，在 pubspec.yaml 中添加 ffigen 依赖：

dev_dependencies:
  ffigen: ^4.0.0  # 使用最新版本

然后创建一个 ffigen.yaml 配置文件：

name: NativeBindings
description: Bindings for native code
output: 'lib/native_bindings.dart'
headers:
  entry-points:
    - 'native/native.c'

运行以下命令生成绑定文件：

flutter pub run ffigen

这将在 lib 目录下生成一个 native_bindings.dart 文件。

4. 加载本地库

在 main.dart 中加载本地库并使用生成的绑定：

import 'dart:ffi';
import 'dart:io';
import 'package:flutter/material.dart';
import 'native_bindings.dart';

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Cedar FFI Example')),
        body: Center(
          child: FutureBuilder<DynamicLibrary>(
            future: _loadNativeLibrary(),
            builder: (context, snapshot) {
              if (snapshot.connectionState == ConnectionState.done) {
                final native = NativeBindings(snapshot.data!);
                return Text('Result: ${native.add(3, 4)}');
              } else {
                return CircularProgressIndicator();
              }
            },
          ),
        ),
      ),
    );
  }

  Future<DynamicLibrary> _loadNativeLibrary() async {
    final libraryPath = Platform.isAndroid
        ? 'libnative.so'
        : Platform.isIOS
            ? 'native.framework/native'
            : 'native.dylib';
    return DynamicLibrary.open(libraryPath);
  }
}

5. 编译本地代码

根据你的平台，编译本地代码：

  • Android: 使用 NDK 编译为 .so 文件。
  • iOS: 使用 Xcode 编译为 .framework。
  • macOS/Windows/Linux: 使用 gcc/clang 编译为 .dylib 或 .so 文件。

6. 运行应用

确保本地库文件放在正确的位置，然后运行 Flutter 应用：

flutter run
回到顶部