Flutter插件开发之APK自动安装

实现Flutter Plugin开发

Posted by Yuzo on June 10, 2019

Flutter插件开发之APK自动安装

本文适用于Android开发人员

什么是Flutter Plugin

Flutter Plugin是一种特殊的包,包含一个用Dart编写的API定义,结合Android和iOS的平台特定实现,从而达到二者兼容。

  • 应用的Flutter部分通过平台通道(platform channel)将消息发送到其应用程序的所在的宿主(iOS或Android)
  • 宿主监听的平台通道,并接收该消息。然后它会调用特定于该平台的API(使用原生编程语言) - 并将响应发送回客户端,即应用程序的Flutter部分 使用平台通道在客户端(Flutter UI)和宿主(平台)之间传递消息,如下图所示 enter image description here

    创建Flutter App

    相关代码见运行第一个Flutter App

    创建Flutter Plugin

    右键工程->New->Module,如下图所示 enter image description here 选择Flutter Plugin,点击Next,如下图所示 enter image description here 输入工程名(Project name),点击Next,如下图所示 enter image description here 输入包名(Package name),点击Finish,入下图所示 enter image description here 到此Flutter plugin创建完成。

    引入插件

    在工程目录下找到pubspec.yaml文件,在dev_dependencies添加如下依赖,如下图所示 enter image description here 相关代码如下

    1
    2
    3
    4
    5
    
    dev_dependencies:
    flutter_test:
      sdk: flutter
    install_apk_plugin:
      path: install_apk_plugin
    

    获取版本号demo

    打开插件lib下的dart文件,会有平台自动生成的代码,具体是实现获取APP版本号,如下面代码所示

1
2
3
4
5
6
7
8
9
10
class InstallApkPlugin {
  static const MethodChannel _channel =
      const MethodChannel('install_apk_plugin');

  static Future<String> get platformVersion async {
    final String version = await _channel.invokeMethod('getPlatformVersion');
    return version;
  }

}

java部分的代码如下面所示

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
public class InstallApkPlugin implements MethodCallHandler {
    private static final String TAG = "InstallApkPlugin";

    private final Registrar registrar;

    /**
     * Plugin registration.
     */
    public static void registerWith(Registrar registrar) {
        final MethodChannel channel = new MethodChannel(registrar.messenger(), "install_apk_plugin");
        channel.setMethodCallHandler(new InstallApkPlugin(registrar));
    }

    private InstallApkPlugin(Registrar registrar) {
        this.registrar = registrar;
    }

    @Override
    public void onMethodCall(MethodCall call, Result result) {
        if (call.method.equals("getPlatformVersion")) {
            result.success("Android " + android.os.Build.VERSION.RELEASE);
        } else {
            result.notImplemented();
        }
    }

}

实现自动安装APK

实现自动安装APK,需要从Flutter应用层传入一个APK安装包的地址到host层,dart代码如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
class InstallApkPlugin {
  static const MethodChannel _channel =
      const MethodChannel('install_apk_plugin');

  static Future<String> get platformVersion async {
    final String version = await _channel.invokeMethod('getPlatformVersion');
    return version;
  }

  static Future<bool> installApk(String path) async {
    final bool isSuccess = await _channel.invokeMethod('installApk', path);
    return isSuccess;
  }
}

java部分的代码如下所示

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
public class InstallApkPlugin implements MethodCallHandler {
    private static final String TAG = "InstallApkPlugin";

    private final Registrar registrar;

    /**
     * Plugin registration.
     */
    public static void registerWith(Registrar registrar) {
        final MethodChannel channel = new MethodChannel(registrar.messenger(), "install_apk_plugin");
        channel.setMethodCallHandler(new InstallApkPlugin(registrar));
    }

    private InstallApkPlugin(Registrar registrar) {
        this.registrar = registrar;
    }

    @Override
    public void onMethodCall(MethodCall call, Result result) {
        if (call.method.equals("getPlatformVersion")) {
            result.success("Android " + android.os.Build.VERSION.RELEASE);
        } else if (call.method.equals("installApk")) {
            final String path = (String) call.arguments;
            Log.d(TAG, "installApk path is " + path);
        } else {
            result.notImplemented();
        }
    }
}

到此,host层就能获取到APK安装包的路径了,后面只需实现Android安装APK的代码逻辑即可,在日志下面添加如下代码

1
2
    File file = new File(path);
    installApk(file, registrar.context());

installApk代码实现如下所示

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
    private void installApk(File apkFile, Context context) {
        Intent installApkIntent = new Intent();
        installApkIntent.setAction(Intent.ACTION_VIEW);
        installApkIntent.addCategory(Intent.CATEGORY_DEFAULT);
        installApkIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);

        Uri apkUri = null;
        if (Build.VERSION.SDK_INT > Build.VERSION_CODES.M) {
            apkUri = FileProvider.getUriForFile(context, context.getPackageName() + ".fileprovider", apkFile);
            installApkIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
        } else {
            apkUri = Uri.fromFile(apkFile);
        }
        installApkIntent.setDataAndType(apkUri, "application/vnd.android.package-archive");

        if (context.getPackageManager().queryIntentActivities(installApkIntent, 0).size() > 0) {
            context.startActivity(installApkIntent);
        }
    }

除此之外,还需修改AndroidManifest.xml内的代码,如下面代码所示

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.yuzo.install_apk_plugin">

    <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />

    <application>
        <!--provider start-->
        <provider
            android:name="androidx.core.content.FileProvider"
            tools:replace="android:authorities"
            android:authorities="com.yuzo.opengit.fileprovider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                tools:replace="android:resource"
                android:resource="@xml/file_path" />
        </provider>
        <!--provider end-->
    </application>
</manifest>

file_path.xml放在res->xml文件夹下面,如下面代码所示

1
2
3
4
5
6
7
8
9
<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:tools="http://schemas.android.com/tools"
    tools:ignore="ResourceName">

    <root-path
        name="root_path"
        path="." />

</paths>

运行代码如下图所示 enter image description here

源代码

项目地址-OpenGit客户端