Flutter通信桥接插件a_bridge的使用

Flutter通信桥接插件a_bridge的使用

插件简介

Flutter插件"a_bridge"旨在增强Appium Flutter自动化在iOS中的功能。该插件被构建为解决特定问题，这些问题是讨论中定义的故事线的一部分。

其名称“a_bridge”来源于“一座桥梁”，象征着它在连接Flutter运行时和原生操作系统功能方面的作用。最终目标是利用这些功能来提高开发环境的操作效率和可扩展性。

插件最初的目标是提取命令行参数，这对于配置Appium Flutter Server中的端口至关重要。随着插件的发展，计划增加从底层操作系统获取功能的能力，以支持开发操作。

插件利用Flutter的方法通道与APIs进行跨平台连接。

使用说明

安装

要在您的Flutter项目中使用ABridge，请按照以下步骤操作：

1. 在pubspec.yaml文件中添加ABridge作为依赖项：

dependencies:
  a_bridge: ^0.0.3  

1. 在Dart文件中导入ABridge包：

import 'package:a_bridge/a_bridge.dart';

获取命令行参数

使用ABridge类异步获取命令行参数：

void main() async {
  ABridge aBridge = ABridge();
  List<String>? arguments = await aBridge.getArgumentList();
  if (arguments != null) {
    print('Command line arguments: $arguments');
  } else {
    print('Failed to retrieve command line arguments.');
  }
}

ABridge类API

• public functions

  Future<List<String>?> getArgumentList()
  

  返回一个Future，该Future解析为从平台接口检索到的参数列表。

  Future<Map<String, dynamic>?> getArgumentPair({String separator = "="})
  

  返回一个Future，该Future解析为参数列表中的键值对映射，每个键值对代表一个参数及其对应的值。separator参数指定用于在参数中分离键值对的字符。

  示例代码：

  ABridge aBridge = ABridge();
  List<String>? arguments = await aBridge.getArgumentList();
  if (arguments != null) {
    print('Command line arguments: $arguments');
  } else {
    print('Failed to retrieve command line arguments.');
  }
  
  Map<String, dynamic>? mapArguments = aBridge.getArgumentPair(separator: '=');
  if (mapArguments != null) {
    print('Argument Map: $mapArguments');
    for (var key in mapArguments.keys) {
      var value = mapArguments[key];
      print('Key: $key, Value: $value');
    }
  } else {
    print('Failed to retrieve argument map.');
  }
  

贡献

欢迎对ABridge进行贡献！如果您遇到问题或有改进建议，请在GitHub上提交问题。

示例代码

示例代码如下：

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

import 'package:flutter/services.dart';
import 'package:a_bridge/a_bridge.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

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

class _MyAppState extends State<MyApp> {
  List<String> _argument = ['Unknown'];
  final _aBridgePlugin = ABridge();

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

  // Platform messages are asynchronous, so we initialize in an async method.
  Future<void> initPlatformState() async {
    List<String> arguments;
    // Platform messages may fail, so we use a try/catch PlatformException.
    // We also handle the message potentially returning null.
    try {
      arguments =
          (await _aBridgePlugin.getArgumentList()) ?? ['No params received'];
    } on PlatformException {
      arguments = ['No params received'];
    }

    // If the widget was removed from the tree while the asynchronous platform
    // message was in flight, we want to discard the reply rather than calling
    // setState to update our non-existent appearance.
    if (!mounted) return;

    setState(() {
      _argument = arguments;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Expanded(
              child: ListView.builder(
                itemCount: _argument.length,
                itemBuilder: (context, index) {
                  return ListTile(
                    title: Text(_argument[index]),
                    onTap: () {
                      print('Tapped on ${_argument[index]}');
                    },
                  );
                },
              ),
            ),
            SizedBox(height: 20), // Spacer between ListView and FlatButton
            TextButton(
              onPressed: () async {
                // Add your button onPressed logic here
                print('Button pressed');
                List<String> arguments =
                    (await _aBridgePlugin.getArgumentList()) ??
                        ['No params received'];
                setState(() {
                  _argument = arguments;
                });
              },
              style: ButtonStyle(
                backgroundColor: MaterialStateProperty.all<Color>(Colors.blue),
                foregroundColor: MaterialStateProperty.all<Color>(Colors.white),
              ),
              child: Text('Press Me'),
            ),
          ],
        ),
      ),
    );
  }
}