Flutter插件terra_flutter的介绍与使用

Flutter插件terra_flutter的介绍与使用

Flutter插件terra_flutter的介绍

terra_flutter 是一个用于原生 Terra 库（适用于 Android 和 iOS）的 Flutter 插件。

目录

• 运行示例
  • Android
  • iOS
• Pigeon 模型
• 库使用方法
  • 初始化一个新的Terra应用
  • 获取Terra应用
  • 获取服务配置

运行示例

Android

1. 打开 example/android 项目并使用 Android Studio。
2. 在 example/android/local.properties 文件中添加 TekoGoogleRegistryToken。

   // example/android/local.properties
   
   TekoGoogleRegistry.password=<你的令牌>
   

3. 运行项目。

iOS

1. 设置 GitHub 访问令牌以访问 Teko iOS 框架。
2. 在终端中运行以下命令：

   cd example
   flutter build ios --no-codesign
   

3. 启动 Xcode 并打开 example/ios/Runner.xcworkspace 文件。

Pigeon 模型

该项目使用 Pigeon 来生成 Flutter 和原生侧之间通信的代码。Pigeon 文件位于 pigeon 文件夹中。要通过 Pigeon 生成代码，请运行 run_pigeon.sh 文件。

Flutter插件terra_flutter使用方法

初始化Terra应用

静态方法：Future<TerraApp> initTerraApp 初始化一个新的 Terra 应用。你应该在入口点调用此函数，以便平滑地使用其他 Terra 服务。

获取Terra应用

静态方法：TerraApp TerraApp.getInstance(String appName) 根据 appName 获取当前的 Terra 应用。

获取服务配置

方法：Future<ServiceConfig> getServiceConfig() 获取 Terra 中特定的服务配置。

示例代码

import 'dart:async';

import 'package:flutter/material.dart';
import 'package:terra_flutter/terra_app.dart';

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> {
  String _clientId = "";
  String _iamConfig = "";

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  Future<void> initPlatformState() async {
    TerraApp terraApp;
    try {
      // 初始化Terra应用
      terraApp = await TerraApp.initTerraApp();
      _clientId = terraApp.clientId ?? "";
    } on Exception catch (err) {
      _clientId = err.toString();
    }

    try {
      // 获取Terra应用实例
      final terraApp = TerraApp.getInstance(TerraApp.defaultAppName);
      // 获取服务配置
      final service = await terraApp.getServiceConfig(serviceName: "iam");
      _iamConfig = service.config ?? "";
    } on Exception catch (err) {
      _iamConfig = err.toString();
    }

    // 如果小部件在异步平台消息传输期间被从树中移除，则丢弃回复而不是调用setState来更新不存在的外观。
    if (!mounted) return;

    setState(() {});
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Column(
          children: [
            const Text("客户端ID: "),
            Text(_clientId),
            const Text("IAM配置: "),
            Text(_iamConfig),
          ],
        ),
      ),
    );
  }
}