easy_app_installer

Description:

easy app installer

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

下载并安装apk - 仅支持 Android
取消下载中的任务 - 仅支持 Android
仅安装apk - 仅支持 Android
跳转到应用市场-指定应用详情页 - 支持Android与iOS
跳转到设置-应用详情页 - 支持Android与iOS

效果：效果演示 #
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>
copied to clipboard
最后，打开 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 >
copied to clipboard
示例：示例文件
使用 #
安装 #
看这里: 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);
}
);
copied to clipboard
2.取消下载中的任务



参数名称
参数意义
是否必传




cancelTag
要取消任务的tag
是



EasyAppInstaller.instance.cancelDownload(_cancelTag);
copied to clipboard
3.仅安装apk



参数名称
参数意义
是否必传




filePath
apk文件的绝对路径
是


explainContent
权限弹窗的提示内容
否


positiveText
权限弹窗的确认文字
否


negativeText
权限弹窗的取消文字
否



ps:自定义权限弹窗仅在Android 6~10 中弹出，Android 10以上交由系统处理权限
await EasyAppInstaller.instance.installApk(filePath);
copied to clipboard
4.跳转到应用市场-指定应用页面
仅支持Android



参数名称
参数意义
是否必传




applicationPackageName
指定应用包名(默认为空)
否


targetMarketPackageName
指定应用市场包名(默认为空)
否


isOpenSystemMarket
是否打开厂商应用市场(默认为true)
否



/// 'applicationPackageName' 如果为空，则默认打开当前应用。
/// 注意，'targetMarketPackageName' 的优先级是高于 'isOpenSystemMarket' 的，
/// 所以仅在 'targetMarketPackageName' 为空的情况下 'isOpenSystemMarket' 才会生效。
///
/// 简单来说，如果你有指定的应用市场，就传递 'targetMarketPackageName' 为对应的包名；
/// 如果你没有指定的应用市场，但是想让大部分机型都打开厂商应用商店，那么就设置 'isOpenSystemMarket' 为true
await EasyAppInstaller.instance.openAppMarket();
copied to clipboard
5.跳转到AppStore-指定应用页面
仅支持iOS



参数名称
参数意义
是否必传




appId
Apple为应用生成的AppId
是



EasyAppInstaller.instance.openAppStore(appId: "${appId}");
copied to clipboard
6.跳转到设置-应用详情页
支持Android&iOS



参数名称
参数意义
是否必传




applicationPackageName
指定应用包名(默认为空)
否



/// Android 支持打开指定应用设置页面，'applicationPackageName' 如果为空，则默认打开当前应用。
/// iOS 无法跳转到其他应用详情页，所以无需传递参数
await EasyAppInstaller.instance.openAppSettingDetails(applicationPackageName: "$targetAppPackage");
copied to clipboard
类说明 #
下载状态
enum EasyAppInstallerState {
//准备下载 (该状态回调在获取到权限之后)
onPrepared,
//下载中
onDownloading,
//下载成功
onSuccess,
//下载失败
onFailed,
//取消下载
onCanceled
}
copied to clipboard