Flutter自动化GUI测试插件dart_autogui的使用

Dart Autogui 是一个基于 Python 的 autogui 模块的包装器。要使此包正常工作，您的计算机上需要安装 Python、pyautogui 和 pyscreeze。

安装

Python 包安装

pip3 install pyautogui pyscreeze

Dart 包安装

在 pubspec.yaml 文件中添加以下依赖：

dependencies:
  dart_autogui: 0.0.1

验证 dart_autogui 是否安装成功：

print(await Validate.installed());
// 如果所有依赖项都已安装，返回 true；否则返回 false

功能

鼠标功能

getPosition() ✅
moveTo() ✅
moveRel() ✅
dragTo() ✅
dragRel() ✅
click() ✅
rightClick() ✅
middleClick() ✅
doubleClick() ✅
tripleClick() ✅
scroll()
mouseDown()
mouseUp()
onLeftClick()
onRightClick()

键盘功能

keyboardKeys() ✅
typeWord() ✅
hotKey() ✅

示例

以下是一个完整的示例代码，展示了如何使用 dart_autogui 进行自动化 GUI 测试。

import 'package:dart_autogui/dart_autogui.dart';

// 获取鼠标当前位置
Future<void> pos() async {
  final position = await Mouse.pos();
  print("X: ${position.x}, Y: ${position.y}");
}

// 将鼠标移动到指定位置
Future<void> moveTo() async {
  await Mouse.moveTo(
    x: 100,
    y: 100,
    duration: Duration(seconds: 5), // 移动时间为 5 秒
    tween: MouseTween.easeInElastic, // 使用弹性动画效果
  );
}

// 相对移动鼠标位置
Future<void> moveRel() async {
  await Mouse.moveRel(
    x: 100,
    y: 100,
    duration: Duration(seconds: 5),
  );
}

// 拖动鼠标到指定位置
Future<void> dragTo() async {
  await Mouse.dragTo(
    x: 100,
    y: 100,
    duration: Duration(seconds: 5),
    tween: MouseTween.easeInElastic,
    button: MouseButton.right, // 使用右键拖动
  );
}

// 相对拖动鼠标
Future<void> dragRel() async {
  await Mouse.dragRel(
    x: 100,
    y: 100,
    duration: Duration(seconds: 2),
    tween: MouseTween.easeInElastic,
  );
}

// 右键点击
Future<void> rightClick() async {
  await Mouse.rightClick(
    x: 100,
    y: 100,
    clicks: 5, // 点击次数为 5 次
    tween: MouseTween.easeInQuad, // 使用二次方动画效果
  );
}

// 获取键盘按键信息
Future<void> keyboardKeys() async {
  final data = await Keyboard.keyboardKeys();
  data.forEach((element) {
    print(element);
  });
}

// 输入文字
Future<void> typeWord() async {
  await Keyboard.typeWord('Adib Mohsin', interval: 0); // 每个字符间隔时间为 0 秒
}

// 执行快捷键组合
Future<void> hotkey() async {
  await Keyboard.hotKey(['ctrl', 'v']); // 执行 Ctrl + V 快捷键
}

// 验证安装是否成功
Future<void> validateInstall() async {
  print(await Validate.installed());
}

void main() async {
  // 验证安装
  validateInstall();

  // 调用其他函数进行测试
  pos();
  moveTo();
  moveRel();
  dragTo();
  dragRel();
  rightClick();
  keyboardKeys();
  typeWord();
  hotkey();
}