Flutter安卓安装包管理插件android_package_installer的使用

android_package_installer 是一个用于从APK文件安装Android软件包的Flutter插件。该插件使用Android Package Installer，并且要求最低API级别为21。

使用方法

安装APK文件示例

在Dart代码中，您可以通过以下方式调用此插件来安装APK文件：

import 'package:android_package_installer/android_package_installer.dart';

int? statusCode = await AndroidPackageInstaller.installApk(apkFilePath: '/sdcard/Download/com.example.apk');
if (statusCode != null) {
  PackageInstallerStatus installationStatus = PackageInstallerStatus.byCode(statusCode);
  print(installationStatus.name); // 打印安装状态
}

注意: 为了安装Android包，应用程序需要请求权限。您可以使用permission_handler包来请求这些权限。

设置

在AndroidManifest.xml中添加权限

请确保在<projectDir>/android/app/src/main/AndroidManifest.xml中添加以下权限：

• android.permission.REQUEST_INSTALL_PACKAGES - 用于安装Android包。
• android.permission.READ_EXTERNAL_STORAGE - 用于访问外部存储，其中包含APK文件。

同时还需要添加一个Intent过滤器和FileProvider配置，以支持文件路径提供。

<manifest xmlns:tools="http://schemas.android.com/tools" ...>
  <!-- 添加以下权限 -->
  <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES"/>
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

  <application ...>
    <activity ...>
      <!-- 添加这个Intent过滤器 -->
      <intent-filter>
        <action android:name="com.android_package_installer.content.SESSION_API_PACKAGE_INSTALLED"
                android:exported="false"/>
      </intent-filter>
    </activity>

    <!-- 添加这个Provider -->
    <provider
      android:name="androidx.core.content.FileProvider"
      android:authorities="${applicationId}"
      android:grantUriPermissions="true">
      <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths"/>
    </provider>
  </application>
</manifest>

配置文件路径

检查您的自定义路径文件中的外部路径。如果它不存在，请在<projectDir>/android/app/src/main/res/xml/file_paths.xml创建它：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-path name="external_files" path="."/>
</paths>

示例Demo

下面是一个完整的示例项目，展示了如何使用android_package_installer插件选择并安装APK文件，同时也展示了如何请求必要的权限。

import 'package:android_package_installer/android_package_installer.dart';
import 'package:file_picker/file_picker.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:permission_handler/permission_handler.dart';

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

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

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _installationStatus = '';
  final TextEditingController _filePathFieldController = TextEditingController(text: '');

  @override
  void initState() {
    super.initState();
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example'),
        ),
        body: Center(
          child: Padding(
              padding: const EdgeInsets.all(30.0),
              child: Column(
                children: [
                  Row(
                    crossAxisAlignment: CrossAxisAlignment.end,
                    children: [
                      Expanded(
                          child: TextField(
                              controller: _filePathFieldController,
                              decoration: const InputDecoration(labelText: "APK file path", hintText: "Enter path"))),
                      _button('Select file', () async {
                        FilePickerResult? result = await FilePicker.platform.pickFiles(type: FileType.custom, allowedExtensions: ['apk']);
                        if (result != null) {
                          setState(() {
                            _filePathFieldController.text = result.files.single.path!;
                            _installationStatus = '';
                          });
                        }
                      }),
                    ],
                  ),
                  const SizedBox(height: 10),
                  Text('PackageManager installation status: $_installationStatus'),
                  const SizedBox(height: 30),
                  _button('Install apk file', () async {
                    if (_filePathFieldController.text.isNotEmpty) {
                      setState(() {
                        _installationStatus = '';
                      });
                      try {
                        int? code = await AndroidPackageInstaller.installApk(apkFilePath: _filePathFieldController.text);
                        if (code != null) {
                          setState(() {
                            _installationStatus = PackageInstallerStatus.byCode(code).name;
                          });
                        }
                      } on PlatformException {
                        print('Error at Platform. Failed to install apk file.');
                      }
                    }
                  }),
                  const Spacer(),
                  SizedBox(
                    child: Column(children: [
                      const Text('Permissions:'),
                      _button('External Storage', () => _requestPermission(Permission.storage)),
                      _button('Request Install Packages', () => _requestPermission(Permission.requestInstallPackages)),
                      _button(
                          'Manage External Storage\n(for Android 11+ target)', () => _requestPermission(Permission.manageExternalStorage)),
                    ]),
                  ),
                ],
              )),
        ),
      ),
    );
  }

  ElevatedButton _button(String text, VoidCallback? onPressed) {
    return ElevatedButton(
      onPressed: onPressed,
      child: Text(text),
    );
  }

  void _requestPermission(Permission permission) async {
    var status = await permission.status;
    if (status.isDenied) {
      await permission.request();
    }
  }
}

通过以上步骤，您可以成功地使用android_package_installer插件来管理和安装Android APK文件。希望这个指南对您有所帮助！如果有任何问题或需要进一步的帮助，请随时提问。