你想要的Android全量版本更新功能,我這兒都有!
2021-09-09 14:00:54

背景

前段時(shí)間我寫了一篇介紹我的一個(gè)開(kāi)源項(xiàng)目XUpdate的博客: 史上最好用的Android全量版本更新庫(kù)XUpdate使用指南, 收到了大家普遍的認(rèn)可,但與此同時(shí)也有人向我反饋了不少建議,比如說(shuō):

• 能否提供一個(gè)一鍵可使用的庫(kù)?
• 能否支持?jǐn)帱c(diǎn)續(xù)傳下載功能?

出于以上的建議, 同時(shí)也是為了能夠更加完善我的XUpdate生態(tài)圈,于是我抽出一點(diǎn)時(shí)間,簡(jiǎn)單地實(shí)現(xiàn)了一個(gè)XUpdate拓展庫(kù) XUpdateAPI, 項(xiàng)目的地址如下:

https://github.com/xuexiangjys/XUpdateAPI

?

?

項(xiàng)目介紹

為了方便大家更快地使用XUpdate, 降低集成的難度，我編寫了這個(gè)配套的拓展庫(kù)。本庫(kù)目前包含如下兩部分內(nèi)容：

• EasyUpdate: 提供快速接入XUpdate的功能，無(wú)需初始化便可直接使用。

• AriaDownloader: 提供斷點(diǎn)續(xù)傳下載的功能。

集成指南

添加Gradle依賴

1.先在項(xiàng)目根目錄的 build.gradle 的 repositories 添加:

allprojects {
     repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

2.然后在dependencies添加:

   implementation 'com.github.xuexiangjys:XUpdate:2.0.6'
   implementation 'com.github.xuexiangjys.XUpdateAPI:xupdate-easy:1.0.0'
   // 如果需要使用斷點(diǎn)續(xù)傳下載功能的話添加該依賴（可選）
   implementation 'com.github.xuexiangjys.XUpdateAPI:xupdate-downloader-aria:1.0.0'

3.自定義初始化配置（可選）

因?yàn)楸編?kù)采取了自動(dòng)初始化的功能，因此你無(wú)需進(jìn)行初始化，但是如果你需要自定義初始化配置的話，你可以實(shí)現(xiàn)IUpdateConfigProvider，并在Application的attachBaseContext前調(diào)用EasyUpdate.setUpdateConfigProvider方法設(shè)置自定義配置。

    @Override
    protected void attachBaseContext(Context base) {
        // 實(shí)現(xiàn)自定義配置
        EasyUpdate.setUpdateConfigProvider(new CustomUpdateConfigProvider());
        super.attachBaseContext(base);
    }

4.開(kāi)啟斷點(diǎn)續(xù)傳下載功能（可選）

• 方法一: 在自定義配置中設(shè)置下載代理

UpdateConfig.create()
        // 開(kāi)啟斷點(diǎn)續(xù)傳下載功能
        .setDownloadServiceProxy(new AriaDownloadServiceProxyImpl(context))

• 方法二: 使用AriaDownloader.enable開(kāi)啟

AriaDownloader.enable(this);

• 方法三: 使用AriaDownloader.getUpdateHttpService獲取下載服務(wù)

EasyUpdate.create(getContext(), Constants.UPDATE_DEFAULT_URL)
        .updateHttpService(AriaDownloader.getUpdateHttpService(getContext()))

注意事項(xiàng)

需要注意的是，在使用EasyUpdate的時(shí)候，務(wù)必保證服務(wù)器返回的json格式應(yīng)包括如下內(nèi)容：

{
  "Code": 0, //0代表請(qǐng)求成功，非0代表失敗
  "Msg": "", //請(qǐng)求出錯(cuò)的信息
  "UpdateStatus": 1, //0代表不更新，1代表有版本更新，不需要強(qiáng)制升級(jí)，2代表有版本更新，需要強(qiáng)制升級(jí)
  "VersionCode": 3,
  "VersionName": "1.0.2",
  "ModifyContent": "1、優(yōu)化api接口。
2、添加使用demo演示。
3、新增自定義更新服務(wù)API接口。
4、優(yōu)化更新提示界面。",
  "DownloadUrl": "https://raw.githubusercontent.com/xuexiangjys/XUpdate/master/apk/xupdate_demo_1.0.2.apk",
  "ApkSize": 2048
  "ApkMd5": "..."  //md5值沒(méi)有的話，就無(wú)法保證apk是否完整，每次都會(huì)重新下載。
}

如果你不想使用默認(rèn)的json格式的話，可參考XUpdate中如何自定義版本更新解析器

使用方法

EasyUpdate主要提供了如下兩個(gè)方法:

• EasyUpdate.create: 構(gòu)建版本更新檢查管理者

• EasyUpdate.checkUpdate: 直接版本更新

具體使用參見(jiàn) EasyUpdateFragment。

當(dāng)然XUpdate的所有方法也都是支持的，具體可以參考XUpdate的使用說(shuō)明.

混淆配置

• XUpdate

-keep class com.xuexiang.xupdate.entity.** { *; }

//注意，如果你使用的是自定義Api解析器解析，還需要給你自定義Api實(shí)體配上混淆，如下是本demo中配置的自定義Api實(shí)體混淆規(guī)則：
-keep class com.xuexiang.xupdatedemo.entity.** { *; }

• AriaDownloader

-dontwarn com.arialyy.aria.**
-keep class com.arialyy.aria.**{*;}
-keep class **$$DownloadListenerProxy{ *; }
-keep class **$$UploadListenerProxy{ *; }
-keep class **$$DownloadGroupListenerProxy{ *; }
-keep class **$$DGSubListenerProxy{ *; }
-keepclasseswithmembernames class * {
    @Download.* <methods>;
    @Upload.* <methods>;
    @DownloadGroup.* <methods>;
}

配套設(shè)置

• XUpdate核心庫(kù): https://github.com/xuexiangjys/XUpdate
• 后臺(tái)版本更新管理服務(wù): https://github.com/xuexiangjys/XUpdateService
• 后臺(tái)版本更新管理系統(tǒng): https://github.com/xuexiangjys/xupdate-management
• Flutter插件: https://github.com/xuexiangjys/flutter_xupdate
• React-Native插件: https://github.com/xuexiangjys/react-native-xupdate

聯(lián)系方式

更多資訊內(nèi)容，歡迎掃描關(guān)注我的個(gè)人微信公眾號(hào):【我的Android開(kāi)源之旅】