galileo_prompts 是一个用于在 Flutter 应用中实现提示与引导功能的插件。它可以帮助开发者在应用中添加引导步骤、提示信息等，以提升用户体验。以下是如何使用 galileo_prompts 插件的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 galileo_prompts 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  galileo_prompts: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来获取依赖。

2. 导入包

在你的 Dart 文件中导入 galileo_prompts 包：

import 'package:galileo_prompts/galileo_prompts.dart';

3. 使用 GalileoPrompts

GalileoPrompts 是一个 Widget，你可以将它添加到你的应用中的任何地方。它通常用于在用户首次使用应用时显示引导步骤或提示信息。

基本用法

class MyHomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Galileo Prompts Example'),
      ),
      body: Center(
        child: GalileoPrompts(
          steps: [
            GalileoStep(
              target: GlobalKey(),
              content: Text('This is the first step.'),
            ),
            GalileoStep(
              target: GlobalKey(),
              content: Text('This is the second step.'),
            ),
            GalileoStep(
              target: GlobalKey(),
              content: Text('This is the third step.'),
            ),
          ],
          onComplete: () {
            print('All steps completed!');
          },
        ),
      ),
    );
  }
}

参数说明

• steps: 一个 List<GalileoStep>，表示引导步骤的列表。每个 GalileoStep 包含一个 target（目标 Widget 的 GlobalKey）和 content（提示内容）。
• onComplete: 当所有步骤完成时触发的回调函数。

GalileoStep 参数

• target: 目标 Widget 的 GlobalKey，提示信息将围绕这个 Widget 显示。
• content: 提示内容，通常是一个 Text 或 Widget。
• position: 提示信息相对于目标 Widget 的位置，默认为 GalileoPosition.bottom。
• shape: 提示信息的形状，默认为 GalileoShape.rectangle。

4. 控制引导流程

你可以通过 GalileoPromptsController 来控制引导流程，例如手动开始、跳过或完成引导。

class MyHomePage extends StatefulWidget {
  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final GalileoPromptsController _controller = GalileoPromptsController();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Galileo Prompts Example'),
      ),
      body: Center(
        child: GalileoPrompts(
          controller: _controller,
          steps: [
            GalileoStep(
              target: GlobalKey(),
              content: Text('This is the first step.'),
            ),
            GalileoStep(
              target: GlobalKey(),
              content: Text('This is the second step.'),
            ),
            GalileoStep(
              target: GlobalKey(),
              content: Text('This is the third step.'),
            ),
          ],
          onComplete: () {
            print('All steps completed!');
          },
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () {
          _controller.start();  // 手动开始引导
        },
        child: Icon(Icons.play_arrow),
      ),
    );
  }
}

5. 自定义样式

你可以通过 GalileoPrompts 的 style 参数来自定义提示信息的样式，例如背景颜色、文字颜色、边框等。

GalileoPrompts(
  style: GalileoStyle(
    backgroundColor: Colors.blue,
    textColor: Colors.white,
    borderRadius: BorderRadius.circular(8.0),
  ),
  steps: [
    // 步骤列表
  ],
);

6. 处理用户交互

你可以通过 GalileoStep 的 onTap 参数来处理用户点击提示信息的操作。

GalileoStep(
  target: GlobalKey(),
  content: Text('Click me!'),
  onTap: () {
    print('Step tapped!');
  },
);

7. 完成引导

当用户完成所有步骤后，onComplete 回调将被触发。你可以在这里执行一些操作，例如保存用户已经完成引导的状态。

GalileoPrompts(
  steps: [
    // 步骤列表
  ],
  onComplete: () {
    print('All steps completed!');
    // 保存状态或执行其他操作
  },
);

8. 跳过引导

你可以通过 GalileoPromptsController 的 skip 方法来跳过引导。

_controller.skip();

9. 重新开始引导

你可以通过 GalileoPromptsController 的 restart 方法来重新开始引导。

_controller.restart();

10. 销毁控制器

在 State 的 dispose 方法中销毁 GalileoPromptsController，以避免内存泄漏。

[@override](/user/override)
void dispose() {
  _controller.dispose();
  super.dispose();
}