Flutter JSON-LD转RDF插件json_ld_2_rdf的使用

Flutter JSON-LD转RDF插件json_ld_2_rdf的使用

本文档将介绍如何在Flutter中使用json_ld_2_rdf插件进行JSON-LD到RDF的转换。我们将通过一个完整的示例来演示如何配置和使用该插件。

Flutter包装器用于JSON-goLD

这是Dart对JSON-goLD的包装。它通过利用Dart的ReceivePort，实现了Dart与Go/cgo之间的直接互操作，从而减少了每个平台的互操作代码。

iOS注意事项

请确保您的项目目标iOS版本为11.0或更高版本；底层的xcframework不包含armv7（32位）代码。

在macOS上测试

虽然该插件不支持macOS作为Flutter插件，但它确实支持在macOS上运行测试。 要在macOS上运行测试，首先需要运行gomodule/build-mac.sh脚本，这将生成gomobile/dist/mac/libld2rdf.dylib。 之后，您可以安全地运行flutter test。

构建脚本

对于Android和iOS，Flutter插件项目已经包含了预构建的二进制文件。当然，您也可以使用以下脚本重新构建二进制文件（这些脚本需要在您的机器上安装go命令）。

Android

以下脚本将在android/src/main/jniLibs目录下为arm64-v8a、armeabi-v7a、x86和x64构建共享对象文件(libld2rdf.so)：

gomodule/build-android.sh

iOS

以下脚本将构建支持iPhone 64位(arm64)和iPhone模拟器(arm64/amd64)的ios/GoJsonLd2Rdf.xcframework：

gomodule/build-ios.sh

macOS

以下脚本将构建支持arm64和amd64的gomobile/dist/mac/libld2rdf.dylib：

gomodule/build-mac.sh

Windows

以下脚本将构建支持x86_64的gomobile/dist/windows/x86_64/libld2rdf.dll：

gomodule/build-windows.sh

请注意，该脚本预计应在Linux或其他类似环境中运行；至少需要以下先决条件：

• gcc-multilib
• gcc-mingw-w64
• binutils-mingw-w64

参考资料

• Async messaging between Flutter and C++ using Dart ffi NativePort
• flutter/flutter #63255 How to use async callback between C++ and Dart with FFI?
• mraleph/go_dart_ffi_example - GitHub
• ReceivePort

示例代码

以下是使用json_ld_2_rdf插件进行JSON-LD到RDF转换的完整示例。

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

import 'package:flutter/services.dart';
import 'package:json_ld_2_rdf/json_ld_2_rdf.dart';
import 'package:http/http.dart' as http;

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

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

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

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 平台消息是异步的，因此我们在异步方法中初始化。
  Future<void> initPlatformState() async {
    Future<String> downloader(url) async {
      print('Downloading $url...');
      final res = await http.get(Uri.parse(url));
      return res.body;
    }

    try {
      const jsonUrl = 'https://json-ld.org/test-suite/tests/toRdf-0028-in.jsonld';
      print(await JsonLd2Rdf.jsonToRdf(jsonUrl, downloader: downloader));
      print(await JsonLd2Rdf.jsonToRdf(jsonUrl));

      const jsonRaw = '''
      {
        "@context": {
          "sec": "http://purl.org/security#",
          "xsd": "http://www.w3.org/2001/XMLSchema#",
          "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
          "dc": "http://purl.org/dc/terms/",
          "sec:signer": {"@type": "@id"},
          "dc:created": {"@type": "xsd:dateTime"}
        },
        "@id": "http://example.org/sig1",
        "@type": ["rdf:Graph", "sec:SignedGraph"],
        "dc:created": "2011-09-23T20:21:34Z",
        "sec:signer": "http://payswarm.example.com/i/john/keys/5",
        "sec:signatureValue": "OGQzNGVkMzVm4NTIyZTkZDYMmMzQzNmExMgoYzI43Q3ODIyOWM32NjI=",
        "@graph": {
          "@id": "http://example.org/fact1",
          "dc:title": "Hello World!"
        }
      }''';
      print(await JsonLd2Rdf.jsonToRdf(jsonRaw, downloader: downloader));
      print(await JsonLd2Rdf.jsonToRdf(jsonRaw));

      const jsonError = '''
      {
        "@context": {
          "@version": 1.1,
          "@protected": "true",

          "$did": "https://ua.poc.loosedays.com/VCTemplate#did",
          "$singleText": "https://ua.poc.loosedays.com/VCTemplate#singleText",
          "$multiText": "https://ua.poc.loosedays.com/VCTemplate#multiText",
          "$number": "https://ua.poc.loosedays.com/VCTemplate#number",
          "$boolean": "https://ua.poc.loosedays.com/VCTemplate#boolean",
          "$date": "https://ua.poc.loosedays.com/VCTemplate#date"
        }
      }''';
      print(await JsonLd2Rdf.jsonToRdf(jsonError));
    } catch (e, s) {
      print('$e: $s');
    }

    // 不调用此函数，主程序永远不会结束。
    JsonLd2Rdf.shutdown();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: Text('测试\n'),
        ),
      ),
    );
  }
}