Flutter任务管理插件flutter_tasker的使用

使用

首先检查是否具有相关的权限！

使用 FlutterTasker.checkStatus() 获取任务器状态 (TaskerStatus) 来检查是否可以触发任务。

使用 FlutterTasker.checkCommandPermission() 检查任务器命令系统的权限是否被授予 (bool)。

请求相关的权限如果需要！

使用 FlutterTasker.requestCommandPermission() 触发一个权限对话框以请求命令系统权限。

使用 FlutterTasker.openExternalAccessSetting() 打开任务器中的外部访问菜单以便用户启用它。

请求并触发任务

使用 FlutterTasker.getTasks() 获取命名任务列表 (List<String>).

使用 FlutterTasker.triggerTask(String task) 触发一个任务。

通过任务器命令系统发送命令

使用 FlutterTasker.sendCommand(String command) 发送命令。

如何安装

在插件的 Android 清单文件中已经声明了相关的权限：

<uses-permission android:name="net.dinglisch.android.tasker.PERMISSION_SEND_COMMAND"/>
<uses-permission android:name="net.dinglisch.android.tasker.PERMISSION_RUN_TASKS"/>
<queries>
	<package android:name="net.dinglisch.android.taskerm" />
</queries>

此外，还需要在任务器设置中启用选项 允许外部访问。提供辅助函数 (FlutterTasker.checkStatus() 和 FlutterTasker.openExternalAccessSetting()) 可用于检查此选项是否已启用，并为用户提供打开相关菜单的功能。

示例

查看示例应用程序以获取简单的实现示例。

许可证

本项目根据 BSD-3 Clause 许可证授权，完整的许可证文本可以在包含的 LICENSE 文件中找到。

TaskerIntent.java 文件由任务器开发者在此处提供：https://tasker.joaoapps.com/code/TaskerIntent.java

贡献

问题和拉取请求总是欢迎的！
如果你觉得这个项目对你有帮助，请考虑请我喝杯咖啡。

• PayPal

示例代码

以下是示例代码：

// Copyright 2022 Pepe Tiebosch (byme.dev/Jellepepe). All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

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

void main() {
  runApp(
    const MaterialApp(
      home: MyApp(),
    ),
  );
}

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

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

class _MyAppState extends State<MyApp> {
  String command = '';
  bool commandPermission = false;
  TaskerStatus status = TaskerStatus.invalid;
  List<String> tasks = [];

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('任务器插件示例'),
      ),
      body: Column(
        children: [
          Row(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              TextButton(
                onPressed: () {
                  FlutterTasker.checkStatus().then((value) {
                    setState(() {
                      status = value;
                    });
                  });
                },
                child: Text('检查状态: $status'),
              ),
              TextButton(
                onPressed: () {
                  FlutterTasker.checkCommandPermission().then((value) {
                    setState(() {
                      commandPermission = value;
                    });
                  });
                },
                child: Text("检查命令权限: ${commandPermission ? '已授予' : '缺少'}"),
              ),
            ],
          ),
          Row(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              TextButton(
                onPressed: () {
                  FlutterTasker.openExternalAccessSetting().then((value) {
                    ScaffoldMessenger.of(context)
                        .showSnackBar(SnackBar(content: Text('成功打开外部访问菜单: $value')));
                  });
                },
                child: const Text('打开外部访问菜单'),
              ),
              TextButton(
                onPressed: () {
                  FlutterTasker.requestCommandPermission().then((value) {
                    ScaffoldMessenger.of(context)
                        .showSnackBar(SnackBar(content: Text('成功请求权限: $value')));
                  });
                },
                child: const Text('请求命令权限'),
              ),
            ],
          ),
          TextButton(
            onPressed: () {
              FlutterTasker.getTasks().then((value) {
                ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text('任务: $value')));
                setState(() {
                  tasks = value ?? [];
                });
              });
            },
            child: const Text('获取任务'),
          ),
          Column(
            children: [
              for (String task in tasks)
                TextButton(
                  onPressed: () {
                    FlutterTasker.triggerTask(task);
                  },
                  child: Text('运行任务: $task'),
                )
            ],
          ),
          const Text('命令:'),
          TextField(
            decoration: const InputDecoration(
              labelText: '命令',
            ),
            onChanged: (value) {
              command = value;
            },
          ),
        ],
      ),
      floatingActionButton: FloatingActionButton(
        child: const Icon(Icons.send),
        onPressed: () {
          try {
            FlutterTasker.sendCommand(command).then(
              (value) => ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text('命令结果: $value'))),
            );
          } catch (e) {
            ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text('命令失败: $e')));
          }
        },
      ),
    );
  }
}