Flutter设备管理策略插件device_policy_controller的使用

Flutter设备管理策略插件device_policy_controller的使用

device_policy_controller

该device_policy_controller插件允许您的Flutter应用成为设备管理策略控制器（DPC）并管理设备策略。通过此插件，您可以设置应用程序限制、锁定设备、安装应用等。

开始使用

安装

在命令行中运行以下命令：

flutter pub add device_policy_controller

设置DPC

要使您的应用成为设备管理策略控制器（DPC），可以使用云服务、二维码、近场通信（NFC）或直接从计算机使用ADB（Android调试桥）。如果您拥有设备，可以使用以下命令：

1. 打开终端并导航到您的Flutter项目的根目录。
2. 将您的Android设备连接到计算机，并确保Flutter应用正在设备上运行。
3. 运行以下命令以使您的应用成为设备管理员：

adb shell dpm set-device-owner com.your_flutter_app_id/com.itisnajim.device_policy_controller.AppDeviceAdminReceiver

将com.your_flutter_app_id替换为您的应用的包名。您可以在android/app/build.gradle文件的android.defaultConfig.applicationId下找到应用的包名。

为了生成二维码或将配置数据写入NFC标签，您可以使用位于example文件夹中的provisioning_data.example.json文件中的信息。此JSON文件包含将您的Flutter应用配置为设备管理策略控制器（DPC）所需的数据。

使用

在设置好应用作为设备管理策略控制器后，您可以使用插件来管理设备策略。DevicePolicyController类提供了多种方法与设备交互。以下是如何使用插件的示例：

import 'package:device_policy_controller/device_policy_controller.dart';

// 创建一个DevicePolicyController实例
final dpc = DevicePolicyController.instance;

// 示例：锁定设备，密码可选
final bool locked = await dpc.lockDevice("password123");
if (locked) {
  print("Device locked successfully!");
} else {
  print("Failed to lock the device.");
}

// 示例：设置应用程序限制
Map<String, String> restrictions = {
  "max_password_length": "10",
  "allow_camera": "false",
};
await dpc.setApplicationRestrictions("com.example.app", restrictions);

特性

该插件提供了以下功能：

• 获取和设置指定包的应用程序限制。
• 添加和清除设备上的用户限制。
• 使用可选密码锁定设备。
• 从给定的APK URL安装应用。
• 获取设备信息，如型号和操作系统版本。（无需管理员权限）
• 如果需要，请求管理员权限。
• 设置是否保持屏幕常亮。（无需管理员权限）
• 检查管理员权限是否激活。
• 将应用锁定在访客模式下。（如果没有管理员权限，系统默认的固定行为将被应用）
• 如果应用被插件锁定，则解锁应用。（如果没有管理员权限，系统默认的解锁行为将被应用）

更多内容请参见API参考文档。

注意：此插件处理设备策略和管理员权限，请谨慎使用，并确保您的应用遵守所有相关的Google Play和Android企业政策。

故障排除

如果您遇到任何问题或有关于device_policy_controller插件的问题，请随时联系插件维护者在GitHub仓库。

许可证

此插件包发布在MIT许可证下。

示例代码

main.dart

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

import 'task_actions.dart';

class ScreenAwakeStatusProvider extends ChangeNotifier {
  bool _isScreenAwake = false;

  bool get isScreenAwake => _isScreenAwake;

  Future<void> updateScreenAwakeStatus({bool? value}) async {
    _isScreenAwake = value ?? await dpc.isScreenAwake();
    notifyListeners();
  }
}

final _statusProvider = ScreenAwakeStatusProvider();

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  initKioskMode();
  runApp(
    ChangeNotifierProvider(
      create: (context) => _statusProvider,
      child: const MyApp(),
    ),
  );
}

const bootCompletedHandlerStartedKey = "bootCompletedHandlerStarted";
Future<void> enableKioskMode() async {
  try {
    await dpc.setAsLauncher();
    await dpc.lockApp();
    await dpc.setKeepScreenAwake(true);
    _statusProvider.updateScreenAwakeStatus(value: true);

    await dpc.put(bootCompletedHandlerStartedKey, content: "false");
  } catch (e) {
    print('dpc:: enableKioskMode error: $e');
  }
}

Future<void> initKioskMode() async {
  dpc.handleBootCompleted((_) async {
    final startedValue = await dpc.get(bootCompletedHandlerStartedKey);
    final isStarted = startedValue == "true";
    print('dpc:: handleBootCompleted:: isStarted: $isStarted');
    await dpc.put(bootCompletedHandlerStartedKey, content: "true");
    if (!isStarted) {
      try {
        await dpc.startApp();
      } catch (e) {
        print('dpc:: handleBootCompleted startApp error: $e');
      }
    }

    // 注意：如果handleBootCompleted较早被调用，
    // dpc.startApp()可能会导致Flutter引擎重置（或失效）到初始入口点"main"。
    // 因此，后续代码可能不会按预期执行。
    // 我们将不在这里调用enableKioskMode方法。
    // enableKioskMode();
  });

  final startedValue = await dpc.get(bootCompletedHandlerStartedKey);
  final isStarted = startedValue == "true";
  print('dpc:: init:: startedValue $startedValue, isStarted: $isStarted');

  if (isStarted) {
    enableKioskMode();
  }
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(
      home: HomePage(),
    );
  }
}

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

  [@override](/user/override)
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  [@override](/user/override)
  void initState() {
    super.initState();
    _statusProvider.updateScreenAwakeStatus();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    final screenSizeWidth = MediaQuery.sizeOf(context).width;

    return Scaffold(
      appBar: AppBar(
        title: const Text('Device Policy Controller Example'),
        actions: [
          TextButton(
            onPressed: () {
              dpc.setKeepScreenAwake(!_statusProvider.isScreenAwake).then(
                (value) {
                  _statusProvider.updateScreenAwakeStatus(
                      value: !_statusProvider.isScreenAwake);
                },
              );
            },
            child: Consumer<ScreenAwakeStatusProvider>(
                builder: (context, statusProvider, _) {
              return Icon(
                Icons.flash_on,
                color: statusProvider.isScreenAwake
                    ? Colors.amberAccent
                    : Colors.blueGrey,
                size: 36,
              );
            }),
          ),
          const SizedBox(width: 12),
        ],
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Expanded(
              child: GridView.builder(
                padding: const EdgeInsets.all(16.0),
                gridDelegate: SliverGridDelegateWithFixedCrossAxisCount(
                  crossAxisCount: 2,
                  crossAxisSpacing: 10.0,
                  mainAxisSpacing: 10.0,
                  childAspectRatio:
                      (screenSizeWidth / 2) / (screenSizeWidth / 7),
                ),
                itemCount: taskActions.length,
                itemBuilder: (context, index) {
                  final action = taskActions[index];
                  if (action.label == toggleScreenAwakeLabel) {
                    action.didPressed = () {
                      _statusProvider.updateScreenAwakeStatus();
                    };
                  }
                  return action.button(context);
                },
              ),
            ),
          ],
        ),
      ),
    );
  }
}