Flutter系统级功能访问插件shizuku_api的使用

通过使用 shizuku_api 插件，您可以在 Flutter 应用中轻松访问系统的高级功能。本文档将指导您如何在 Flutter 应用中配置和使用该插件。

🌟 关于

此插件用于我的 Google Play 商店应用 System App Remover，允许用户在不使用root权限或电脑的情况下卸载系统应用（Android 10及以下版本仍需要电脑运行Shizuku）。

⚡ 安装

在您的项目中添加插件：

flutter pub add shizuku_api

📋 要求

• 必须安装并运行 Shizuku 应用。

🔧 配置

app/build.gradle

确保 minSdk 大于等于 24：

minSdkVersion 24

AndroidManifest.xml

在 <application> 标签内添加以下内容：

<application>
    <!-- 其他代码 -->
    
    <provider
        android:name="rikka.shizuku.ShizukuProvider"
        android:authorities="${applicationId}.shizuku"
        android:multiprocess="false"
        android:enabled="true"
        android:exported="true"
        android:permission="android.permission.INTERACT_ACROSS_USERS_FULL" />
</application>

🚀 使用

⚠️ 重要

在调用其他任何方法之前，必须先执行以下步骤：

• 确保已安装 Shizuku 应用。
• 检查 Shizuku 是否正在运行。

bool isBinderRunning = await _shizukuApiPlugin.pingBinder() ?? false; // 尝试连接 Shizuku

🛠️ 检查 Shizuku 权限

final _shizukuApiPlugin = ShizukuApi();

// 检查用户是否已授予 Shizuku 权限
// 返回值为 true 表示已允许权限，否则表示未允许或从未请求
bool checkPermission = await _shizukuApiPlugin.checkPermission();

print(checkPermission);

🛠️ 请求 Shizuku 权限

final _shizukuApiPlugin = ShizukuApi();

// 触发 Shizuku 弹出窗口
// 返回值为 true 表示已允许权限，否则表示未允许
bool requestPermission = await _shizukuApiPlugin.requestPermission(); 

print(requestPermission);

💻 运行命令

• ⚡ 不支持 root 环境 (su)
• ✅ 可以运行 ADB shell 命令 (正常工作)

String command = 'pm uninstall --user 0 com.android.chrome';
await _shizukuApiPlugin.runCommand(command); // 返回成功如果卸载系统应用成功，失败则返回失败

示例代码

以下是完整的示例代码，展示了如何在 Flutter 应用中使用 shizuku_api 插件：

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

import 'package:flutter/services.dart';
import 'package:shizuku_api/shizuku_api.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> {
  bool _isShizukuPermissionGranted = false;
  final _shizukuApiPlugin = ShizukuApi();
  var singleOutputController = TextEditingController(text: 'wm size');

  String outputString = '';

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

  Future<void> requestPermission() async {
    bool shizukuApiPermission;
    try {
      shizukuApiPermission = await _shizukuApiPlugin.requestPermission() ?? false;
      if (kDebugMode) {
        print(shizukuApiPermission);
      }
    } on PlatformException {
      shizukuApiPermission = false;
    }

    if (!mounted) return;

    setState(() {
      _isShizukuPermissionGranted = shizukuApiPermission;
    });
  }

  Future<bool> isBinderRunning() async {
    bool isBinderRunning = await _shizukuApiPlugin.pingBinder() ?? false;
    if (kDebugMode) {
      print('isBinderRunning $isBinderRunning');
    }
    return isBinderRunning;
  }

  Future<bool> checkPermission() async {
    bool isShizukuGranted = await _shizukuApiPlugin.checkPermission() ?? false;
    if (kDebugMode) {
      print('checkPermission() $isShizukuGranted');
    }
    return isShizukuGranted;
  }

  void runCommand(String command) async {
    outputString = await _shizukuApiPlugin.runCommand(command) ?? '';
    setState(() {});
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: lightMode,
      darkTheme: darkMode,
      home: Scaffold(
        appBar: buildAppBar(),
        body: Padding(
          padding: const EdgeInsets.all(8.0),
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.center,
            children: [
              ElevatedButton(
                onPressed: () async {
                  bool isShizukuRunning = await isBinderRunning();
                  if (isShizukuRunning == true) {
                    _isShizukuPermissionGranted = await checkPermission();
                    setState(() {});
                  }
                },
                child: Text(
                    '检查 Shizuku 权限是否授予: $_isShizukuPermissionGranted'),
              ),
              ElevatedButton(
                onPressed: () async {
                  bool i = await isBinderRunning();
                  if (i == true) {
                    requestPermission();
                  }
                },
                child: const Text('请求 Shizuku 权限'),
              ),
              TextField(
                decoration: const InputDecoration(
                    label: Text('命令'),
                    helperText:
                        '例如: pm uninstall --user 0 &lt;packageName&gt;, wm size'),
                controller: singleOutputController,
              ),
              ElevatedButton.icon(
                icon: const Icon(Icons.chevron_right_rounded),
                onPressed: () {
                  runCommand(singleOutputController.text);
                },
                label: const Text('运行命令'),
              ),
              Text(outputString)
            ],
          ),
        ),
      ),
    );
  }

  AppBar buildAppBar() {
    return AppBar(
      centerTitle: true,
      title: const Text('Shizuku Api'),
    );
  }
}

final lightMode = ThemeData(
  colorScheme: ColorScheme.fromSeed(
    seedColor: Colors.purple,
  ),
  useMaterial3: true,
);
final darkMode = ThemeData(
  colorScheme: ColorScheme.fromSeed(
    brightness: Brightness.dark,
    seedColor: Colors.purple,
  ),
  useMaterial3: true,
);