Flutter原生交互插件terra_flutter_bridge的使用

Flutter原生交互插件terra_flutter_bridge的使用

介绍

terra_flutter_bridge 是一个用于Flutter的新插件项目,专门用于实现平台特定的功能代码,如Android和iOS。本文将展示如何使用这个插件进行Flutter与原生平台的交互。

开始使用

要开始使用 terra_flutter_bridge 插件,请参考以下示例代码,并确保你已经阅读了Flutter的相关文档来了解基础的开发知识。

以下是完整的示例Demo:

import 'package:logger/logger.dart';
import 'package:terra_flutter_bridge/models/enums.dart';
import 'package:terra_flutter_bridge/models/responses.dart';
import 'package:terra_flutter_bridge/terra_flutter_bridge.dart';
import 'package:flutter/material.dart';
import 'dart:convert';
import 'package:http/http.dart' as http;
// import 'package:terra_flutter_example/generate.dart'; // 假设此文件包含生成token的方法
import 'config.dart' as constants; // 假设此文件包含devId和apiKey等配置

var logger = Logger();

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

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

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

class AuthTokenResponse {
  String token;
  String status;

  AuthTokenResponse(this.token, this.status);

  factory AuthTokenResponse.fromJson(Map<String, dynamic> json) {
    return AuthTokenResponse(
      json['token'],
      json['status'],
    );
  }

  Map<String, dynamic> toJson() => {
        'token': token,
        'status': status,
      };
}

class _MyAppState extends State<MyApp> {

  String _testText = "Hello World";
  bool _initialised = false;
  bool _connected = false;
  DataMessage? daily;

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

  // 初始化函数状态
  Future<void> initTerraFunctionState() async {
    SuccessMessage? initialised;
    SuccessMessage? connected;
    UserId? testText;
    Connection c = Connection.healthConnect;

    try {
      DateTime now = DateTime.now().toUtc();
      DateTime lastMidnight = DateTime(now.year, now.month, now.day);
      // 初始化Terra
      initialised = await TerraFlutter.initTerra(constants.devId, "test_ref2");
      logger.d(initialised?.success);
      
      // 连接
      connected = await TerraFlutter.initConnection(c, (await generateToken()).token , true, []);
      
      // 获取用户ID
      testText = await TerraFlutter.getUserId(c);
      logger.d(testText?.userId as String);
      
      // 获取营养、睡眠、活动数据
      daily = await TerraFlutter.getNutrition(
              c, DateTime(2023, 02, 01), DateTime(2023, 02, 10));
      daily = await TerraFlutter.getSleep(
              c, DateTime(2023, 02, 01), DateTime(2023, 02, 10));
      daily = await TerraFlutter.getActivity(
              c, DateTime(2023, 02, 01), DateTime(2023, 02, 03), toWebhook: false);
      
      // 获取已授权权限
      logger.d("permissions:");
      logger.d(await TerraFlutter.getGivenPermissions());
    } on Exception catch (e) {
      logger.d('error caught: $e');
    }

    if (!mounted) return;

    setState(() {
      _initialised = initialised?.success ?? false;
      _connected = connected?.success ?? false;
      _testText = testText?.userId ?? "";
    });
  }

  // 生成Token
  Future<AuthTokenResponse> generateToken() async {
    final response = await http.post(
      Uri.parse("https://api.tryterra.co/v2/auth/generateAuthToken"),
      headers: <String, String>{
        'Content-Type': 'application/json; charset=UTF-8',
        'Dev-Id': constants.devId,
        'x-api-key': constants.apiKey,
      },
    );

    if (response.statusCode == 200) {
      return AuthTokenResponse.fromJson(jsonDecode(response.body));
    } else {
      throw Exception('Failed to create data.');
    }
  }

  // 发布计划工作
  Future<void> postPlannedWorkout_() async{
    final resp = await TerraFlutter.postPlannedWorkout(Connection.appleHealth, generateSamplePlannedWorkout());
    logger.d((resp?.success ?? false));
    
    final postedPlannedWorkouts = await TerraFlutter.getPlannedWorkouts(Connection.appleHealth);
    logger.d(postedPlannedWorkouts?.data.toString() ?? "No data");
    
    // 删除计划工作
    final deleteWorkout = await TerraFlutter.deletePlannedWorkout(Connection.appleHealth, "ceef601a-23e4-4393-8483-a9f6d37b0407");
    logger.d((deleteWorkout?.success ?? false));
  }  

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app for Terra SDKs'),
        ),
        body: Center(
          child: Column(
            children: [
              Text(
                'User id: $_testText\n',
                textAlign: TextAlign.center,
              ),
              Text(
                'Did integration init: $_initialised\n',
                textAlign: TextAlign.center,
              ),
              Text(
                'Is integration connected: $_connected\n',
                textAlign: TextAlign.center,
              ),
              Text(
                'Requested daily webhook for integration: $daily\n',
                textAlign: TextAlign.center,
              ),
            ],
          ),
        ),
      ),
    );
  }
}

更多关于Flutter原生交互插件terra_flutter_bridge的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter原生交互插件terra_flutter_bridge的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然,下面是一个关于如何使用 terra_flutter_bridge 进行 Flutter 与原生代码交互的代码示例。terra_flutter_bridge 是一个用于 Flutter 与原生平台(iOS 和 Android)进行通信的插件。请注意,由于 terra_flutter_bridge 并非一个广泛知名的标准 Flutter 插件,这里假设它提供类似其他 Flutter 原生交互插件的功能。

Flutter 端代码

首先,在你的 Flutter 项目中,确保你已经添加了 terra_flutter_bridge 依赖到你的 pubspec.yaml 文件中:

dependencies:
  flutter:
    sdk: flutter
  terra_flutter_bridge: ^x.y.z  # 替换为实际的版本号

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

接下来,在你的 Dart 代码中,你可以这样使用 terra_flutter_bridge

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

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

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  TerraFlutterBridge? _bridge;

  @override
  void initState() {
    super.initState();
    // 初始化 TerraFlutterBridge
    _bridge = TerraFlutterBridge();

    // 注册一个方法供原生调用
    _bridge?.registerMethodHandler('fromFlutterToNative', (call) async {
      String message = call.arguments['message'];
      // 处理原生传来的消息
      print('Received from native: $message');
      return 'Acknowledged';
    });

    // 调用原生方法
    _callNativeMethod();
  }

  void _callNativeMethod() async {
    try {
      var result = await _bridge?.invokeMethod('fromNativeToFlutter', {'message': 'Hello from Flutter'});
      print('Result from native: $result');
    } catch (e) {
      print('Failed to invoke native method: $e');
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Terra Flutter Bridge Example'),
        ),
        body: Center(
          child: Text('Check console for native interactions'),
        ),
      ),
    );
  }
}

原生端代码(iOS)

在 iOS 端,你需要创建一个桥接类来处理 Flutter 与原生代码的交互。这里假设 TerraFlutterBridge 插件在 iOS 端有一个对应的 TerraFlutterBridgePlugin 类。

  1. AppDelegate.swiftAppDelegate.m 中配置插件(如果需要):
// AppDelegate.swift
import UIKit
import Flutter
import terra_flutter_bridge  // 假设插件提供了 Swift 模块

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
  override func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    GeneratedPluginRegistrant.register(with: self)
    // 注册 TerraFlutterBridge 插件(如果需要手动注册)
    TerraFlutterBridgePlugin.register(with: self.registrar(forPlugin: "terra_flutter_bridge")!)
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
  }
}
  1. 创建一个桥接类处理 Flutter 调用:
// TerraFlutterBridgeHandler.swift
import Flutter

class TerraFlutterBridgeHandler: NSObject, FlutterMethodChannelDelegate {
    private let channel: FlutterMethodChannel
    
    init(withBinaryMessenger messenger: FlutterBinaryMessenger) {
        channel = FlutterMethodChannel(name: "terra_flutter_bridge", binaryMessenger: messenger)
        channel.setMethodCallHandler(self.handleMethodCall)
    }
    
    func handleMethodCall(_ call: FlutterMethodCall, result: @escaping FlutterResult) {
        switch call.method {
        case "fromNativeToFlutter":
            guard let arguments = call.arguments as? [String: Any],
                  let message = arguments["message"] as? String else {
                result(FlutterError(code: "InvalidArguments", message: "Invalid arguments passed to fromNativeToFlutter", details: nil))
                return
            }
            // 处理 Flutter 端传来的消息
            print("Received from Flutter: \(message)")
            result("Hello from Native")
        default:
            result(FlutterMethodNotImplementedError(methodName: call.method))
        }
    }
}
  1. AppDelegate 中注册这个处理器:
// 在 AppDelegate.swift 中
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // ... 其他代码 ...
    
    let terraFlutterBridgeHandler = TerraFlutterBridgeHandler(withBinaryMessenger: self.flutterEngine!.binaryMessenger)
    // 注意:这里假设 TerraFlutterBridge 插件已经自动处理了注册,如果没有,则可能需要手动注册 channel
    // TerraFlutterBridgePlugin.registerChannelHandler(with: terraFlutterBridgeHandler, binaryMessenger: self.flutterEngine!.binaryMessenger)
    
    return true
}

原生端代码(Android)

在 Android 端,你需要创建一个 MethodChannel 来处理 Flutter 与原生代码的交互。

  1. MainActivity.ktMainActivity.java 中配置插件:
// MainActivity.kt
package com.example.yourapp

import android.os.Bundle
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugins.GeneratedPluginRegistrant
import com.example.yourapp.TerraFlutterBridgePlugin  // 假设插件提供了 Kotlin 类

class MainActivity: FlutterActivity() {
    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        GeneratedPluginRegistrant.registerWith(flutterEngine)
        // 注册 TerraFlutterBridge 插件(如果需要手动注册)
        TerraFlutterBridgePlugin.registerWith(flutterEngine.dartExecutor.binaryMessenger)
    }
}
  1. 创建一个桥接类处理 Flutter 调用:
// TerraFlutterBridgePlugin.kt
package com.example.yourapp

import io.flutter.embedding.engine.plugins.FlutterPlugin
import io.flutter.embedding.engine.plugins.activity.ActivityAware
import io.flutter.embedding.engine.plugins.activity.ActivityPluginBinding
import io.flutter.plugin.common.MethodCall
import io.flutter.plugin.common.MethodChannel
import io.flutter.plugin.common.MethodChannel.MethodCallHandler
import io.flutter.plugin.common.MethodChannel.Result
import android.app.Activity

class TerraFlutterBridgePlugin: FlutterPlugin, ActivityAware, MethodCallHandler {
    private lateinit var channel: MethodChannel
    private var activity: Activity? = null

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

    override fun onMethodCall(call: MethodCall, result: Result) {
        if (call.method == "fromNativeToFlutter") {
            val arguments = call.arguments as? Map<String, Any>
            val message = arguments?.get("message") as? String
            // 处理 Flutter 端传来的消息
            println("Received from Flutter: $message")
            result.success("Hello from Native")
        } else {
            result.notImplemented()
        }
    }

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

    override fun onAttachedToActivity(binding: ActivityPluginBinding) {
        activity = binding.activity
    }

    override fun onDetachedFromActivityForConfigChanges() {
        activity = null
    }

    override fun onReattachedToActivityForConfigChanges(binding: ActivityPluginBinding) {
        activity = binding.activity
    }

    override fun onDetachedFromActivity() {
        activity = null
    }

    companion object {
        @JvmStatic
        fun registerWith(registrar: Registrar) {
            val channel = MethodChannel(registrar.messenger(), "terra_flutter_bridge")
            channel.setMethodCallHandler(TerraFlutterBridgePlugin())
        }
    }
}

请注意,以上代码是基于假设的 terra_flutter_bridge 插件的工作方式编写的,实际使用时可能需要根据插件的具体实现进行调整。此外,

回到顶部