Flutter任务锁定插件flutter_lock_task的使用

开始使用

在你的项目中添加flutter-lock-task插件：

$ flutter pub add flutter-lock-task

设置

AndroidManifest.xml

在你的项目中找到yourProject/android/app/src/main/AndroidManifest.xml文件，并添加以下内容：

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-permission android:name="android.permission.MANAGE_DEVICE_ADMINS" />
    <application
        android:label="flutter_lock_task_example"
        android:name="${applicationName}"
        android:icon="@mipmap/ic_launcher">
        <activity
            android:name=".MainActivity"
            android:exported="true"
            android:launchMode="singleTop"
            android:theme="@style/LaunchTheme"
            android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
            android:hardwareAccelerated="true"
            android:windowSoftInputMode="adjustResize">
            <meta-data
              android:name="io.flutter.embedding.android.NormalTheme"
              android:resource="@style/NormalTheme"
              />
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>
                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
        </activity>
        <receiver android:exported="true" android:name="flutter.lock.task.flutter_lock_task.DeviceAdmin" android:permission="android.permission.BIND_DEVICE_ADMIN">
            <meta-data android:name="android.app.device_admin" android:resource="@xml/policies" />
            <intent-filter>
                <action android:name="android.app.action.DEVICE_ADMIN_ENABLED" />
                <action android:name="android.app.action.ACTION_DEVICE_ADMIN_DISABLE_REQUESTED" />
                <action android:name="android.app.action.ACTION_DEVICE_ADMIN_DISABLED" />
                <action android:name="android.intent.action.PROFILE_PROVISIONING_COMPLETE"/>
                <action android:name="android.intent.action.BOOT_COMPLETED"/>
            </intent-filter>
        </receiver>
        <meta-data
            android:name="flutterEmbedding"
            android:value="2" />
    </application>
</manifest>

policies.xml

在你的项目中找到yourProject/android/app/src/main/res/xml/policies.xml文件，并添加以下内容：

<?xml version="1.0" encoding="utf-8"?>
<device-admin>
    <uses-policies>
        <limit-password />
        <watch-login />
        <reset-password />
        <force-lock />
        <wipe-data />
        <expire-password />
        <encrypted-storage />
        <disable-camera />
    </uses-policies>
</device-admin>

设置设备所有者（仅限root设备）

如果您的设备已经root，可以使用以下命令设置设备所有者：

./adb shell dpm set-device-owner YOU_PACKAGE_NAME/flutter.lock.task.flutter_lock_task.DeviceAdmin

其中YOU_PACKAGE_NAME可以通过以下方式获取：

FlutterLockTask().getPackageName()

使用方法

在你的Dart代码中，您可以使用以下方法来控制锁屏任务：

import 'package:flutter_lock_task/flutter_lock_task.dart';

// 启动锁屏任务
FlutterLockTask().startLockTask().then((value) {
  print("startLockTask: " + value.toString());
});

// 停止锁屏任务
FlutterLockTask().stopLockTask().then((value) {
  print("stopLockTask: " + value.toString());
});

// 检查是否处于锁屏模式
FlutterLockTask().isInLockTaskMode().then((value) {
  print("isInLockTaskMode: " + value.toString());
});

// 设置设备所有者应用（仅限root设备）
FlutterLockTask().setDeviceOwnerApp().then((value) {
  print("setDeviceOwnerApp: " + value.toString());
});

// 清除设备所有者应用
FlutterLockTask().clearDeviceOwnerApp().then((value) {
  print("clearDeviceOwnerApp: " + value.toString());
});

// 打开主设置页面
FlutterLockTask().openHomeSettings().then((value) {
  print(value);
});

// 获取包名
FlutterLockTask().getPackageName().then((value) {
  print(value);
});

完整示例

以下是一个完整的示例代码，展示了如何使用flutter-lock-task插件：

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

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

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

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

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: Column(children: [
            ElevatedButton(
              child: const Text('启动锁屏任务'),
              onPressed: () { 
                FlutterLockTask().startLockTask().then((value) {
                  print("startLockTask: " + value.toString());
                });
              }
            ),
            ElevatedButton(
              child: const Text('停止锁屏任务'),
              onPressed: () { 
                FlutterLockTask().stopLockTask().then((value) {
                  print("stopLockTask: " + value.toString());
                });
              }
            ),
            ElevatedButton(
              child: const Text('检查是否处于锁屏模式'),
              onPressed: () { 
                FlutterLockTask().isInLockTaskMode().then((value) {
                  print("isInLockTaskMode: " + value.toString());
                });
              }
            ),
            ElevatedButton(
              child: const Text('设置设备所有者应用（仅限root设备）'),
              onPressed: () { 
                FlutterLockTask().setDeviceOwnerApp().then((value) {
                  print("setDeviceOwnerApp: " + value.toString());
                });
              }
            ),
            ElevatedButton(
              child: const Text('清除设备所有者应用'),
              onPressed: () { 
                FlutterLockTask().clearDeviceOwnerApp().then((value) {
                  print("clearDeviceOwnerApp: " + value.toString());
                });
              }
            ),
            ElevatedButton(
              child: const Text('打开主设置页面'),
              onPressed: () { 
                FlutterLockTask().openHomeSettings().then((value) {
                  print(value);
                });
              }
            ),
            ElevatedButton(
              child: const Text('获取包名'),
              onPressed: () { 
                FlutterLockTask().getPackageName().then((value) {
                  print(value);
                });
              }
            )
          ]),
        ),
      ),
    );
  }
}