Flutter页面导航与控制插件pagepilot的使用

该插件用于在你的应用中快速且简便地集成PagePilot。

示例代码

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

import 'package:flutter/services.dart';
import 'package:pagepilot/models/config_model.dart';
import 'package:pagepilot/models/styles_model.dart';
import 'package:pagepilot/pagepilot.dart';
import 'app_theme.dart';

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

// TODO : 添加你的凭证
const applicationId = "";
const userId = "21"; //1234

GlobalKey keyDialog = GlobalKey();
GlobalKey keyTooltip = GlobalKey();
GlobalKey keyBeacon = GlobalKey();

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

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

class _MyAppState extends State<MyApp> {
  String _platformVersion = '未知';
  final _pagepilotPlugin = Pagepilot();

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

  // 平台消息是异步的，所以我们通过异步方法进行初始化。
  Future<void> initPlatformState() async {
    String platformVersion;
    // 平台消息可能会失败，所以我们使用一个try/catch来处理PlatformException。
    // 我们还处理消息可能返回null的情况。
    try {
      platformVersion = await _pagepilotPlugin.getPlatformVersion() ?? 
          '未知平台版本';
    } on PlatformException {
      platformVersion = '获取平台版本失败。';
    } catch (e) {
      print(e.toString());
      platformVersion = '获取平台版本失败。';
    }

    // 如果小部件从树中被移除时异步平台消息还在飞行，我们想丢弃回复而不是调用setState来更新我们的非存在的外观。
    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  initPagePilot() async {
    Map<String, GlobalKey> keys = {
      '#dialog': keyDialog,
      '#tooltip': keyTooltip,
      '#beacon': keyBeacon
    };

    Config config = Config(
      credentials: {
        "applicationId": applicationId,
      },
      keys: keys,
      styles:
          Styles(shadowColor: Colors.blue, shadowOpacity: 0.3, textSkip: "OK"),
    );
    try {
      await _pagepilotPlugin.init(config!); // 初始化库
      _pagepilotPlugin.setUserIdentifier(userId: userId);
    } on PlatformException {
      // 记录异常并报告给studio@gameolive.com
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      theme: AppTheme.lightTheme,
      home: App(
        platformVersion: _platformVersion,
        pagepilotPlugin: _pagepilotPlugin,
      ),
    );
  }
}

class App extends StatelessWidget {
  final String platformVersion;
  final Pagepilot pagepilotPlugin;

  App({
    super.key,
    required this.platformVersion,
    required this.pagepilotPlugin,
  });

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('插件示例应用'),
      ),
      body: Column(
        children: [
          Center(
            child: Text('运行于: $platformVersion\n'),
          ),
          ElevatedButton(
            key: keyBeacon,
            onPressed: () {
              pagepilotPlugin.show(context: context, screen: "home"); // 显示名为"home"的屏幕
            },
            child: Text("点击我！"),
          ),
          SizedBox(height: 20),
          Row(
            mainAxisAlignment: MainAxisAlignment.spaceAround,
            children: [
              Text(key: keyDialog, '对话框'),
              Text(key: keyTooltip, '工具提示'),
            ],
          ),
          SizedBox(height: 20),
          Center(
            child: Text('引导'),
          ),
        ],
      ),
    );
  }
}