Flutter交互式功能增强插件 interactive 的使用

interactive 是一个强大的 Dart 交互式 shell 插件，提供了许多实用的功能来增强开发体验。以下是关于如何安装和使用该插件的详细指南。

安装

要安装 interactive，请按照以下步骤操作：

dart pub global activate interactive

这将全局激活 interactive 包，使其可以在命令行中直接使用。

基本用法

安装完成后，可以通过以下命令启动 interactive：

interactive

启动后，您将进入一个交互式的 Dart shell 环境，可以在这里执行各种 Dart 代码片段。

主要功能

1. 使用第三方包

在 interactive 中，您可以自由地使用任何第三方包。首先需要通过以下命令添加所需的包：

!dart pub add path // 添加 path 包
import 'package:path/path.dart'; // 导入 path 包
join('directory', 'file.txt') // 使用 join 函数
// 输出: directory/file.txt

2. 自动热重载

interactive 支持自动热重载，这意味着您可以在不重启 shell 的情况下修改代码并立即看到效果。例如：

import 'a.dart';
myFunc(); // 初始输出: hello, tom

// 修改 a.dart 文件中的内容，例如将 "tom" 改为 "alex"

myFunc(); // 修改后的输出: hello, alex

3. 支持完整的 Dart 语法

interactive 支持完整的 Dart 语法，包括定义变量、函数和类等：

a = 10;
int g() => a++; 
class A {} 
class B {}
class C extends A implements B {
  int b = 20;
  int f() { 
    int c = 30; 
    a++; 
    b++; 
    c++; 
    return a + b + c + g(); 
  }
}
c = C();
c.f(); // 输出: 74

4. 与现有代码一起使用

假设我们有一个名为 my_app.dart 的文件，其中包含以下代码：

class Counter {
  int count = 0;
  String greet() => 'Hi Tom, you have count $count!';
}

我们可以使用 interactive 来测试这段代码：

$ interactive --directory path/to/my/package
>>> import 'my_app.dart';
>>> counter = Counter();
>>> counter.count = 10;
>>> counter.greet();
// 输出: Hi Tom, you have count 10!
>>> counter.count = 20;
>>> counter.greet();
// 输出: Hi Tom, you have count 20!

如果我们发现需要修改代码，可以直接修改 my_app.dart 文件，然后继续测试，状态会被保留：

// 修改 my_app.dart 文件，将 "Tom" 改为 "Alex"
>>> counter.greet();
// 输出: Hi Alex, you have count 20!

示例 Demo

示例 1：展示功能

使用第三方包

>>> !dart pub add path
>>> import 'package:path/path.dart';
>>> join('directory', 'file.txt');
// 输出: directory/file.txt

自动热重载

>>> import 'a.dart';
>>> myFunc(); // 初始输出: hello, tom
// 修改 a.dart 文件的内容
>>> myFunc(); // 修改后的输出: hello, alex

支持完整语法

>>> a = 10;
>>> int g() => a++;
>>> class A {}
>>> class B {}
>>> class C extends A implements B {
...   int b = 20;
...   int f() { 
...     int c = 30; 
...     a++; 
...     b++; 
...     c++; 
...     return a + b + c + g(); 
...   }
... }
>>> c = C();
>>> c.f(); // 输出: 74

示例 2：工作流示例

假设我们有一个 my_app.dart 文件，并且我们想对其进行一些测试：

class Counter {
  int count = 0;
  String greet() => 'Hi Tom, you have count $count!';
}

我们可以使用 interactive 来测试这段代码：

$ interactive --directory path/to/my/package
>>> import 'my_app.dart';
>>> counter = Counter();
>>> counter.count = 10;
>>> counter.greet();
// 输出: Hi Tom, you have count 10!
>>> counter.count = 20;
>>> counter.greet();
// 输出: Hi Tom, you have count 20!

如果我们发现需要修改代码，可以直接修改 my_app.dart 文件，然后继续测试，状态会被保留：

// 修改 my_app.dart 文件，将 "Tom" 改为 "Alex"
>>> counter.greet();
// 输出: Hi Alex, you have count 20!

更多功能

表达式

>>> a = 'Hello'; b = ' world!';
>>> '$a, $b';
// 输出: Hello,  world!

语句

>>> print(a);
// 输出: Hello

函数

定义和重新定义

>>> String f() => 'old';
>>> f();
// 输出: old
>>> String f() => 'new';
>>> f();
// 输出: new

使用局部变量和全局变量

>>> a = 10;
>>> int f() { int b = 20; a++; b++; return a + b; }
>>> f();
// 输出: 32
>>> f();
// 输出: 33

类

定义和重新定义，保持状态

>>> class C { int a = 10; int f() => a * 2; }
>>> c = C(); print(c.f());
// 输出: 20
>>> class C { int a = 1000; int f() => a * 3; }
>>> c.f();
// 输出: 30

继承和实现

>>> class A { int f() => 10; } 
>>> class B extends A { int f() => 20; }
>>> A().f() + B().f();
// 输出: 30
>>> class B implements A { int f() => 30; }
>>> A().f() + B().f();
// 输出: 40

添加依赖项

使用 !dart pub add package_name 命令添加依赖项：

>>> !dart pub add path
Resolving dependencies...

+ path 1.8.2

Changed 1 dependency!

>>> import 'package:path/path.dart';
>>> join('directory', 'file.txt');
// 输出: directory/file.txt

多行输入

如果输入没有结束，interactive 会提示您继续输入：

>>> class C {
...   int a = 10;
... }

运行命令

使用前缀 ! 来运行命令：

>>> !whoami
tom
>>> !date
2022-10-22 ...outputs...

在现有包环境中执行

如果您想在现有的包环境中执行代码，可以使用以下命令：

interactive --directory path/to/your/package