Flutter快捷操作插件quick_actions_ios的使用

quick_actions_ios

quick_actions_ios 是 Flutter 插件 quick_actions 的 iOS 实现部分。

使用方法

这个插件是被推荐的，这意味着你可以正常地使用 quick_actions。当你这样做时，这个包会自动包含在你的应用程序中，因此你不需要在 pubspec.yaml 文件中添加它。

然而，如果你直接导入这个包来使用它的任何 API，那么你需要像往常一样在 pubspec.yaml 中添加它。

贡献

如果你想为插件做出贡献，请查看我们的贡献指南。

示例代码

以下是一个完整的示例 demo，展示了如何使用 quick_actions_ios 插件：

// Copyright 2013 The Flutter Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

// ignore_for_file: public_member_api_docs

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

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Quick Actions Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key});

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  String shortcut = 'no action set'; // 初始化快捷操作类型

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

    final QuickActionsIos quickActions = QuickActionsIos(); // 创建快捷操作实例
    quickActions.initialize((String shortcutType) { // 初始化快捷操作回调
      setState(() {
        shortcut = shortcutType; // 设置当前快捷操作类型
      });
    });

    quickActions.setShortcutItems(<ShortcutItem>[ // 设置快捷操作项
      const ShortcutItem( // 第一个快捷操作项
        type: 'action_one', // 操作类型
        localizedTitle: 'Action one', // 标题
        localizedSubtitle: 'Action one subtitle', // 副标题
        icon: 'AppIcon', // 图标名称
      ),
      const ShortcutItem( // 第二个快捷操作项
          type: 'action_two', // 操作类型
          localizedTitle: 'Action two', // 标题
          icon: 'ic_launcher'), // 图标名称
    ]).then((void _) {
      setState(() {
        if (shortcut == 'no action set') {
          shortcut = 'actions ready'; // 如果没有设置快捷操作，则显示“actions ready”
        }
      });
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(shortcut), // 显示当前快捷操作类型
      ),
      body: const Center(
        child: Text('在主屏幕上长按应用图标以获取“Action one”或“Action two”选项。点击该操作应设置工具栏标题。'),
      ),
    );
  }
}