【r_upgrade】快來升級你的Flutter應用

介紹

在移動開發過程當中，應用升級是必不可少的一個環節，因此，r_upgrade應用升級插件就出現了，這裏先鼓掌歡迎👏👏，下面是使用介紹

r_upgrade

Android和IOS的升級應用插件==Flutter應用升級插件

• 網頁連接形式升級
• apk下載形式升級使用Service或者DownloadManager
• 跳轉到應用商店升級
• Android熱更新

開始吧

1.使用插件:

在pubspec.yaml文件添加下面代碼

dependencies:
 r_upgrade: last version
複製代碼

2.使用打開連接的方式進行更新（Android和IOS通用）

void upgradeFromUrl()async{
        bool isSuccess =await RUpgrade.upgradeFromUrl(
                    'https://www.baidu.com',
                  );
        print(isSuccess);
    }
複製代碼

Android平臺

1.跳轉到應用商店更新

void upgradeFromAndroidStore(){
       bool isSuccess = await RUpgrade.upgradeFromAndroidStore(AndroidStore.BAIDU);
       print('${isSuccess?'跳轉成功':'跳轉失敗'}');
    }
複製代碼

2.經過下載連接進行apk下載

1.添加升級下載進度監聽

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.

// [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後返回

void cancel() async {
      bool isSuccess=await RUpgrade.cancel(id);
    }
複製代碼

4. 安裝應用

useDownloadManager:

• false: id由調用upgrade或調用getLastUpgradedId後返回
• true : id由調用upgrade後返回

void install() async {
      bool isSuccess=await RUpgrade.install(id);
    }
複製代碼

5. 暫停下載(Service)

useDownloadManager:

• false: id由調用upgrade或調用getLastUpgradedId後返回

void pause() async {
      bool isSuccess=await RUpgrade.pause(id);
    }
複製代碼

6. 繼續下載(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]，將會安裝應用
      // 當文件被刪除時，從新下載
    }
複製代碼

7. 獲取最後一次下載的ID(Service)

該方法只會尋找當前應用版本名和版本號下下載過的ID

void getLastUpgradeId() async {
     int id = await RUpgrade.getLastUpgradedId();
    }
複製代碼

8. 獲取ID對應的下載狀態(Service)

useDownloadManager:

• false: id由調用upgrade或調用getLastUpgradedId後返回

void getDownloadStatus()async{
    DownloadStatus status = await RUpgrade.getDownloadStatus(id);
   }
複製代碼

9. 熱更新 (使用 DownloadManager)

• 你可使用升級返回的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, //
}
複製代碼

IOS平臺

1.跳轉到AppStore進行更新

void upgradeFromAppStore() async {
        bool isSuccess =await RUpgrade.upgradeFromAppStore(
                '您的AppId',//例如:微信的AppId:414478124
              );
        print(isSuccess);
    }
複製代碼

2.獲取AppStore中你的應用最後的版本名

void getVersionFromAppStore() async {
        String versionName = await RUpgrade.getVersionFromAppStore(
                '您的AppId',//例如:微信的AppId:414478124
               );
        print(versionName);
    }
複製代碼

結尾：Dart客棧已經推出Aqueduct框架系列教程專輯，歡迎喜歡學習Dart語言開發的小夥伴關注👏👏