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
更多关于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
类。
- 在
AppDelegate.swift
或AppDelegate.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)
}
}
- 创建一个桥接类处理 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))
}
}
}
- 在
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 与原生代码的交互。
- 在
MainActivity.kt
或MainActivity.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)
}
}
- 创建一个桥接类处理 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
插件的工作方式编写的,实际使用时可能需要根据插件的具体实现进行调整。此外,