前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >【r_upgrade】快来升级你的Flutter应用

【r_upgrade】快来升级你的Flutter应用

作者头像
rhyme_lph
发布2020-06-16 15:07:13
1.4K0
发布2020-06-16 15:07:13
举报
文章被收录于专栏:Flutter&DartFlutter&Dart

image

介绍

在移动开发过程中,应用升级是必不可少的一个环节,所以,r_upgrade应用升级插件就出现了,这里先鼓掌欢迎??,下面是使用介绍

r_upgrade

Android和IOS的升级应用插件==Flutter应用升级插件

  • 网页链接形式升级
  • apk下载形式升级使用Service或者DownloadManager
  • 跳转到应用商店升级
  • Android热更新

开始吧

1.使用插件:

pubspec.yaml文件添加下面代码

代码语言:javascript
复制
dependencies:
  r_upgrade: last version

2.使用打开链接的方式进行更新(AndroidIOS通用)

代码语言:javascript
复制
    void upgradeFromUrl()async{
        bool isSuccess =await RUpgrade.upgradeFromUrl(
                    'https://www.baidu.com',
                  );
        print(isSuccess);
    }

Android平台

1.跳转到应用商店更新

代码语言:javascript
复制
    void upgradeFromAndroidStore(){
       bool isSuccess = await RUpgrade.upgradeFromAndroidStore(AndroidStore.BAIDU);
       print('${isSuccess?'跳转成功':'跳转失败'}');
    }

2.通过下载链接进行apk下载

1.添加升级下载进度监听
代码语言:javascript
复制
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,请自行判断

2.立即升级你的应用

目前分为两部分 useDownloadManager:

  • true: 调用系统的DownloadManager进行下载
    • 优势:接入简单,无需担心操作,下载全由系统管理
    • 劣势:无法使用http方式进行下载,无法在下载过程中点击通知栏进行暂停,无法根据有无网络进行暂停和继续下载,适配机型问题等
  • false: 调用Service进行下载(默认使用)
    • 优势:功能较全,支持http/https下载,支持网络断开后自动暂停下载,连接上后继续下载,支持断点续传,支持查询最后一次下载等
    • 劣势:暂无发现,如果发现bug欢迎提issue.
代码语言:javascript
复制
    // [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);
    }
3. 取消下载

useDownloadManager:

  • false: id由调用upgrade或调用getLastUpgradedId后返回
  • true : id由调用upgrade后返回
代码语言:javascript
复制
    void cancel() async {
      bool isSuccess=await RUpgrade.cancel(id);
    }
4. 安装应用

useDownloadManager:

  • false: id由调用upgrade或调用getLastUpgradedId后返回
  • true : id由调用upgrade后返回
代码语言:javascript
复制
    void install() async {
      bool isSuccess=await RUpgrade.install(id);
    }
5. 暂停下载(Service)

useDownloadManager:

  • false: id由调用upgrade或调用getLastUpgradedId后返回
代码语言:javascript
复制
    void pause() async {
      bool isSuccess=await RUpgrade.pause(id);
    }
6. 继续下载(Service)

useDownloadManager:

  • false: id由调用upgrade或调用getLastUpgradedId后返回
代码语言:javascript
复制
    void pause() async {
      bool isSuccess=await RUpgrade.upgradeWithId(id);
      // 返回 false 即表示从来不存在此ID
      // 返回 true
      //    调用此方法前状态为 [STATUS_PAUSED]、[STATUS_FAILED]、[STATUS_CANCEL],将继续下载
      //    调用此方法前状态为 [STATUS_RUNNING]、[STATUS_PENDING],不会发生任何变化
      //    调用此方法前状态为 [STATUS_SUCCESSFUL],将会安装应用
      // 当文件被删除时,重新下载
    }
7. 获取最后一次下载的ID(Service)

该方法只会寻找当前应用版本名和版本号下下载过的ID

代码语言:javascript
复制
    void getLastUpgradeId() async {
     int id = await RUpgrade.getLastUpgradedId();
    }
8. 获取ID对应的下载状态(Service)

useDownloadManager:

  • false: id由调用upgrade或调用getLastUpgradedId后返回
代码语言:javascript
复制
    void getDownloadStatus()async{
    DownloadStatus status = await RUpgrade.getDownloadStatus(id);
   }
9. 热更新 (使用 DownloadManager)
  • 你可以使用升级返回的id进行热更新,下载的文件需要将新版本生成的isolate_snapshot_datakernel_blob.binvm_snapshot_data打进zip文件中下载 步骤:
    • 运行 flutter clean 清理build文件
    • 运行 flutter build bundle 生成需要的产物,下面标记星号为必须文件
代码语言:javascript
复制
|- AssetManifest.json
|- FontManifest.json
|- fonts
    |- ...
|- isolate_snapshot_data *
|- kernel-blob.bin       *
|- LICENSE
|- packages
    |- ...
|- vm_snapshot_data      *
代码语言:javascript
复制
- 将标记星号的文件打包成zip文件,上传到服务器
- 调用`RUpgrade.upgrade(...)`方法进行下载
- 下载完成后,将上面获取到的id进行热更新,调用如下代码
代码语言:javascript
复制
           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('热更新失败,请等待更新包下载完成')));
              }
代码语言:javascript
复制
- 重启应用即可

注意,在Android应用中,请确保AndroidManifest.xml中声明以下权限,并在6.0系统上进行动态授权,不然会调用升级方法将抛出权限异常

代码语言:javascript
复制
    <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,添加下面代码

代码语言:javascript
复制
<?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,默认为显示预计完成时间.

代码语言:javascript
复制
/// Notification show style about content text
enum NotificationStyle {
  speechAndPlanTime, // 100kb/s 预计1秒后完成
  planTimeAndSpeech, // 预计1秒后完成 100kb/s
  speech,// 100kb/s
  planTime, // 预计1秒后完成
  none, //
}

IOS平台

1.跳转到AppStore进行更新

代码语言:javascript
复制
    void upgradeFromAppStore() async {
        bool isSuccess =await RUpgrade.upgradeFromAppStore(
                '您的AppId',//例如:微信的AppId:414478124
              );
        print(isSuccess);
    }

2.获取AppStore中你的应用最后的版本名

代码语言:javascript
复制
    void getVersionFromAppStore() async {
        String versionName = await RUpgrade.getVersionFromAppStore(
                '您的AppId',//例如:微信的AppId:414478124
               );
        print(versionName);
    }

结尾:Dart客栈已经推出Aqueduct框架系列教程专辑,欢迎喜欢学习Dart语言开发的小伙伴关注??

本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 介绍
  • r_upgrade
    • 开始吧
      • 1.使用插件:
      • 2.使用打开链接的方式进行更新(Android和IOS通用)
    • Android平台
      • 1.跳转到应用商店更新
      • 2.通过下载链接进行apk下载
    • 安卓平台通知栏
      • IOS平台
        • 1.跳转到AppStore进行更新
        • 2.获取AppStore中你的应用最后的版本名
    领券
    问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档