image
在移动开发过程中,应用升级是必不可少的一个环节,所以,r_upgrade应用升级插件就出现了,这里先鼓掌欢迎??,下面是使用介绍
Android和IOS的升级应用插件==Flutter应用升级插件
使用Service或者DownloadManager
Android
热更新在pubspec.yaml
文件添加下面代码
dependencies:
r_upgrade: last version
Android
和IOS
通用) void upgradeFromUrl()async{
bool isSuccess =await RUpgrade.upgradeFromUrl(
'https://www.baidu.com',
);
print(isSuccess);
}
void upgradeFromAndroidStore(){
bool isSuccess = await RUpgrade.upgradeFromAndroidStore(AndroidStore.BAIDU);
print('${isSuccess?'跳转成功':'跳转失败'}');
}
RUpgrade.stream.listen((DownloadInfo info){
///...
});
info 里包含的信息如下:
字段 | 含义 |
---|---|
(int) id | 当前下载任务的id |
(int) max_length ( total已弃用 ) | 所需下载的总大小 (bytes) |
(int) current_length ( progress已弃用 ) | 当前已下载的大小 (bytes) |
(double) percent | 当前下载进度(0-100) |
(double) planTime | 计划下载完成所需时间/秒 (需要.toStringAsFixed(0)) |
(String) path ( address已弃用 ) | 当前下载的文件路径 |
(double) speed | 当前下载的速度kb/s |
(DownloadStatus) status | 当前下载状态 STATUS_PAUSED 下载已暂停 STATUS_PENDING等待下载 STATUS_RUNNING下载中 STATUS_SUCCESSFUL下载成功 STATUS_FAILED下载失败 STATUS_CANCEL下载取消 |
注意: 部分http下载链接可能返回 max_length = -1
,请自行判断
目前分为两部分
useDownloadManager
:
true
: 调用系统的DownloadManager
进行下载 false
: 调用Service
进行下载(默认使用) // [isAutoRequestInstall] 下载完成后自动弹出安装
// [apkName] 安装包的名字(需要包含.apk)
// [notificationVisibility] 通知栏显示方式
// [useDownloadManager] 是否使用DownloadManager,默认不使用(DownloadManager不支持http下载,下载手动暂停,断点续传等,不建议使用)
void upgrade() async {
int id = await RUpgrade.upgrade(
'https://raw.githubusercontent.com/rhymelph/r_upgrade/master/apk/app-release.apk',
apkName: 'app-release.apk',isAutoRequestInstall: true);
}
useDownloadManager
:
false
: id由调用upgrade
或调用getLastUpgradedId
后返回true
: id由调用upgrade
后返回 void cancel() async {
bool isSuccess=await RUpgrade.cancel(id);
}
useDownloadManager
:
false
: id由调用upgrade
或调用getLastUpgradedId
后返回true
: id由调用upgrade
后返回 void install() async {
bool isSuccess=await RUpgrade.install(id);
}
Service
)useDownloadManager
:
false
: id由调用upgrade
或调用getLastUpgradedId
后返回 void pause() async {
bool isSuccess=await RUpgrade.pause(id);
}
Service
)useDownloadManager
:
false
: id由调用upgrade
或调用getLastUpgradedId
后返回 void pause() async {
bool isSuccess=await RUpgrade.upgradeWithId(id);
// 返回 false 即表示从来不存在此ID
// 返回 true
// 调用此方法前状态为 [STATUS_PAUSED]、[STATUS_FAILED]、[STATUS_CANCEL],将继续下载
// 调用此方法前状态为 [STATUS_RUNNING]、[STATUS_PENDING],不会发生任何变化
// 调用此方法前状态为 [STATUS_SUCCESSFUL],将会安装应用
// 当文件被删除时,重新下载
}
Service
)该方法只会寻找当前应用版本名和版本号下下载过的ID
void getLastUpgradeId() async {
int id = await RUpgrade.getLastUpgradedId();
}
Service
)useDownloadManager
:
false
: id由调用upgrade
或调用getLastUpgradedId
后返回 void getDownloadStatus()async{
DownloadStatus status = await RUpgrade.getDownloadStatus(id);
}
id
进行热更新,下载的文件需要将新版本生成的isolate_snapshot_data
、kernel_blob.bin
、vm_snapshot_data
打进zip文件中下载
步骤: flutter clean
清理build文件flutter build bundle
生成需要的产物,下面标记星号为必须文件|- AssetManifest.json
|- FontManifest.json
|- fonts
|- ...
|- isolate_snapshot_data *
|- kernel-blob.bin *
|- LICENSE
|- packages
|- ...
|- vm_snapshot_data *
- 将标记星号的文件打包成zip文件,上传到服务器
- 调用`RUpgrade.upgrade(...)`方法进行下载
- 下载完成后,将上面获取到的id进行热更新,调用如下代码
bool isSuccess = await RUpgrade.hotUpgrade(id);
if (isSuccess) {
_state.currentState
.showSnackBar(SnackBar(content: Text('热更新成功,3s后退出应用,请重新进入')));
Future.delayed(Duration(seconds: 3)).then((_){
SystemNavigator.pop(animated: true);
});
}else{
_state.currentState
.showSnackBar(SnackBar(content: Text('热更新失败,请等待更新包下载完成')));
}
- 重启应用即可
注意,在Android应用中,请确保
AndroidManifest.xml
中声明以下权限,并在6.0系统上进行动态授权,不然会调用升级方法将抛出权限异常
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
注意:目前热更新尚处于测试阶段,只支持Flutter代码的变更,不支持资源文件等,热更新造成的一切的后果插件的作者概不负责,由使用者承担。
如果你想自定义通知栏显示的内容, 可以这样做, 修改或添加文件路径为project/android/app/main/res/r_upgrade_value.xml
,添加下面代码
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="r_upgrade_download_speech">%.2fkb/s</string>
<string name="r_upgrade_download_planTime">预计%.0f秒后完成</string>
<string name="r_upgrade_download_finish">下载完成</string>
<string name="r_upgrade_download_paused">下载被暂停</string>
<string name="r_upgrade_download_failed">下载失败</string>
</resources>
然后.当你使用upgrade
方法时,你应该设置参数notificationStyle
,默认为显示预计完成时间.
/// Notification show style about content text
enum NotificationStyle {
speechAndPlanTime, // 100kb/s 预计1秒后完成
planTimeAndSpeech, // 预计1秒后完成 100kb/s
speech,// 100kb/s
planTime, // 预计1秒后完成
none, //
}
void upgradeFromAppStore() async {
bool isSuccess =await RUpgrade.upgradeFromAppStore(
'您的AppId',//例如:微信的AppId:414478124
);
print(isSuccess);
}
void getVersionFromAppStore() async {
String versionName = await RUpgrade.getVersionFromAppStore(
'您的AppId',//例如:微信的AppId:414478124
);
print(versionName);
}
结尾:Dart客栈已经推出
Aqueduct框架系列教程
专辑,欢迎喜欢学习Dart语言开发的小伙伴关注??