easy_app_installer 1.0.0 copy "easy_app_installer: ^1.0.0" to clipboard
easy_app_installer: ^1.0.0 copied to clipboard

It provides easy installation and upgrade for applications, come on, take a look.

easy_app_installer #

为Flutter提供简便的应用内升级

效果:效果演示 #

English document:English document #

配置 - Android #

1.如果要使用应用内升级的相关功能,则需要配置 FileProvider

android - app - src - main - res 下,新建 xml 文件夹, 随后在 xml 内新建 file_provider_path.xml 文件,内容如下:

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

最后,打开 android - app - src - main - AndroidManifest.xml 文件, 在 application 标签下添加:

<provider
android:authorities = "${applicationId}.fileprovider"
android:exported = "false"
android:grantUriPermissions = "true"
android:name = "androidx.core.content.FileProvider">
    <meta-data
    android:name = "android.support.FILE_PROVIDER_PATHS"
    android:resource = "@xml/file_provider_path" />
</provider >

示例:示例文件

使用 #

安装 #

看这里: easy_app_installer

文档说明 #

1.下载并安装apk

在Android 11上,首次同意'允许安装应用'权限会造成应用进程关闭,这是系统行为,这个问题在Android 12上已经修复。

参数名称 参数意义 是否必传
fileUrl 要下载apk的url地址
fileDirectory 文件夹路径(无须拼接反斜杠)
fileName 文件名称(无需拼接反斜杠)
explainContent 权限弹窗的提示内容
positiveText 权限弹窗的确认文字
negativeText 权限弹窗的取消文字
isDeleteOriginalFile 如已存在相同文件,是否要删除(默认为true)
downloadListener 下载进度回调,double类型,值为 0~100
cancelTagListener 回调用于取消下载中任务的tag
stateListener 下载状态变化时回调,请参考下载状态

ps:自定义权限弹窗仅在Android 6~10 中弹出,Android 10以上交由系统处理权限

详细示例,请参考:example/lib/main.dart

String _cancelTag = "";

/// 仅支持将APK下载到沙盒目录下
/// 当前这个示例最终生成的文件路径就是 '/data/user/0/$applicationPackageName/files/updateApk/new.apk'
/// 如果连续调用此方法,并且参数传递的完全一致,那么Native端将拒绝执行后续任务,直到下载中的任务执行完毕。
EasyAppInstaller.instance.downloadAndInstallApk(
    fileUrl: "https://xxxx.apk",
    fileDirectory: "updateApk",
    fileName: "new.apk",
    downloadListener: (progress) {
        if (progress < 100) {
            EasyLoading.showProgress(progress / 100, status: "下载中");
        } else {
            EasyLoading.showSuccess("下载成功");
        }
    },
    cancelTagListener: (cancelTag) {
        _cancelTag = cancelTag;
    },
    stateListener: (newState, attachParam) {
        _handleDownloadStateChanged(newState, attachParam);
    }
);

2.取消下载中的任务

参数名称 参数意义 是否必传
cancelTag 要取消任务的tag
EasyAppInstaller.instance.cancelDownload(_cancelTag);

3.仅安装apk

参数名称 参数意义 是否必传
filePath apk文件的绝对路径
explainContent 权限弹窗的提示内容
positiveText 权限弹窗的确认文字
negativeText 权限弹窗的取消文字

ps:自定义权限弹窗仅在Android 6~10 中弹出,Android 10以上交由系统处理权限

await EasyAppInstaller.instance.installApk(filePath);

4.跳转到应用市场-指定应用页面

仅支持Android

参数名称 参数意义 是否必传
applicationPackageName 指定应用包名(默认为空)
targetMarketPackageName 指定应用市场包名(默认为空)
isOpenSystemMarket 是否打开厂商应用市场(默认为true)
/// 'applicationPackageName' 如果为空,则默认打开当前应用。
/// 注意,'targetMarketPackageName' 的优先级是高于 'isOpenSystemMarket' 的,
/// 所以仅在 'targetMarketPackageName' 为空的情况下 'isOpenSystemMarket' 才会生效。
///
/// 简单来说,如果你有指定的应用市场,就传递 'targetMarketPackageName' 为对应的包名;
/// 如果你没有指定的应用市场,但是想让大部分机型都打开厂商应用商店,那么就设置 'isOpenSystemMarket' 为true
await EasyAppInstaller.instance.openAppMarket();

5.跳转到AppStore-指定应用页面

仅支持iOS

参数名称 参数意义 是否必传
appId Apple为应用生成的AppId
EasyAppInstaller.instance.openAppStore(appId: "${appId}");

6.跳转到设置-应用详情页

支持Android&iOS

参数名称 参数意义 是否必传
applicationPackageName 指定应用包名(默认为空)
/// Android 支持打开指定应用设置页面,'applicationPackageName' 如果为空,则默认打开当前应用。
/// iOS 无法跳转到其他应用详情页,所以无需传递参数
await EasyAppInstaller.instance.openAppSettingDetails(applicationPackageName: "$targetAppPackage");

类说明 #

下载状态

enum EasyAppInstallerState {
    //准备下载 (该状态回调在获取到权限之后)
    onPrepared,
    //下载中
    onDownloading,
    //下载成功
    onSuccess,
     //下载失败
    onFailed,
    //取消下载
    onCanceled
}
17
likes
160
pub points
85%
popularity

Publisher

unverified uploader

It provides easy installation and upgrade for applications, come on, take a look.

Repository (GitHub)
View/report issues

Documentation

API reference

License

MIT (LICENSE)

Dependencies

flutter, flutter_plugin_android_lifecycle

More

Packages that depend on easy_app_installer