如何在Flutter integration_test中访问主机系统文件？

一、主机文件供测试中Android应用使用的方案 #

1. 测试前通过ADB推送文件到设备 #

这是最直接的方式，利用ADB的文件传输能力，在启动测试前将主机上的压缩文件推送到设备的可读写目录：

adb push ./host_path/test_data.zip /sdcard/Download/

在Flutter测试代码中，通过路径提供者插件获取对应目录，即可读取文件：

import 'package:path_provider/path_provider.dart';
import 'dart:io';

Future<File> getHostFile() async {
  final externalDir = await getExternalStorageDirectory();
  return File('${externalDir!.path}/test_data.zip');
}

2. 利用Flutter Driver的通信通道传输文件 #

如果需要动态传递文件（比如测试过程中根据逻辑发送不同文件），可以借助Flutter Driver的双向通信机制，将文件内容编码后从主机发送到设备：

主机端Driver脚本：

import 'dart:io';
import 'dart:convert';
import 'package:flutter_driver/flutter_driver.dart';

void main() {
  late FlutterDriver driver;

  setUpAll(() async {
    driver = await FlutterDriver.connect();
    // 读取主机文件并编码为Base64
    final fileBytes = await File('./test_data.zip').readAsBytes();
    await driver.requestData(base64Encode(fileBytes));
  });

  test('Process host file', () async {
    // 执行测试逻辑
  });
}

设备端测试代码：

import 'package:flutter/services.dart';
import 'package:integration_test/integration_test.dart';
import 'package:path_provider/path_provider.dart';
import 'dart:convert';
import 'dart:io';

void main() {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  testWidgets('Use file from host', (tester) async {
    // 接收主机发送的Base64编码内容
    final message = await ServicesBinding.instance.defaultBinaryMessenger
        .handlePlatformMessage('flutter.driver', null, (_) async => null);
    
    if (message != null) {
      final fileBytes = base64Decode(String.fromCharCodes(message));
      // 保存到设备临时目录
      final tempDir = await getTemporaryDirectory();
      final targetFile = File('${tempDir.path}/test_data.zip');
      await targetFile.writeAsBytes(fileBytes);
      // 后续使用该文件
    }
  });
}

3. 静态文件打包进测试APK（适合固定文件） #

如果文件是测试固定依赖的，可以将文件放在test/assets目录，在pubspec.yaml中声明：

flutter:
  assets:
    - test/assets/test_data.zip

测试代码中通过rootBundle读取：

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

Future<Uint8List> getPackedFile() async {
  return rootBundle.load('test/assets/test_data.zip').then((value) => value.buffer.asUint8List());
}

二、Integration Test执行涉及的服务与主机架构 #

Integration Test的执行依赖主机与设备间的多组件协作，核心组件及职责如下：

• 主机端Flutter Driver客户端：即你编写的driver.dart脚本，运行在开发主机上，负责发起测试命令、接收设备返回的结果和日志，控制测试流程。
• 设备端Flutter Driver服务：嵌入在测试APK中，运行在Android模拟器/真机的Flutter进程内，监听来自主机的命令，执行UI操作、数据查询等测试逻辑，并回传结果。
• ADB（Android Debug Bridge）：作为主机与Android设备的通信中介，所有命令、日志、文件传输都通过ADB的TCP/IP通道转发，是两者交互的核心桥梁。
• 主机端Flutter Tool：通过flutter driver命令触发，负责编译测试APK、安装到设备、启动测试进程，同时协调Flutter Driver客户端与设备端服务的连接。
• Android模拟器/真机：运行测试APK的实际环境，承载Flutter应用进程和集成测试的执行逻辑。

核心通信流程： #

1. 主机端Flutter Tool通过ADB将编译好的测试APK安装到设备并启动。
2. 设备端测试APK启动后，初始化Flutter Driver服务并等待连接。
3. 主机端Flutter Driver客户端通过ADB连接到设备端的Driver服务。
4. 主机端发送测试命令（如点击控件、获取数据），经ADB转发到设备端执行。
5. 设备端将执行结果和日志通过ADB回传给主机，由Driver客户端处理并生成测试报告。

内容的提问来源于stack exchange，提问作者Vishnu