Android版本更新库

Android版本更新库

转载自GitHub地址：https://github.com/AlexLiuSheng/CheckVersionLib

• 任何地方都可以调用
• 简单简单简单简单
• 扩展性强大
• 更强大的自定义界面支持
• 支持强制更新（一行代码）
• 支持静默下载 （一行代码）
• 适配到Android O

---

导入

compile ‘com.allenliu.versionchecklib:library:2.0.3’

使用

请求版本一些其他的http参数可以设置，如下

 AllenVersionChecker
            .getInstance()
            .requestVersion()
            .setHttpHeaders(httpHeader)
            .setRequestMethod(HttpRequestMethod.POSTJSON)
            .setRequestParams(httpParam)
            .setRequestUrl(requestUrl)
            .request(new RequestVersionListener() {
                @Nullable
                @Override
                public UIData onRequestVersionSuccess(String result) {
                    //拿到服务器返回的数据，解析，拿到downloadUrl和一些其他的UI数据
                    ...
                    UIData uiData = UIData
                            .create()
                            .setDownloadUrl(downloadUrl)
                            .setTitle(updateTitle)
                            .setContent(updateContent);
                    //放一些其他的UI参数，拿到后面自定义界面使用
                    uiData.getVersionBundle().putString("key", "your value");
                    return uiData;

                }

                @Override
                public void onRequestVersionFailure(String message) {

                }
            })
            .excuteMission(context);

一些其他的function设置

解释下，下面的builder叫DownloadBuilder

 DownloadBuilder builder=AllenVersionChecker
            .getInstance()
            .downloadOnly();

  or          

 DownloadBuilder builder=AllenVersionChecker
             .getInstance()
             .requestVersion()
             .request()

取消任务

AllenVersionChecker.getInstance().cancelAllMission(this);

静默下载

 builder.setSilentDownload(true); 默认false

强制更新

设置此listener即代表需要强制更新，会在用户想要取消下载的时候回调 需要你自己关闭所有界面

builder.setForceUpdateListener(() -> {
          forceUpdate();
      });

下载忽略本地缓存

如果本地有安装包缓存也会重新下载apk

 builder.setForceRedownload(true); 默认false

是否显示下载对话框

builder.setShowDownloadingDialog(false); 默认true

是否显示通知栏

builder.setShowNotification(false);  默认true

自定义通知栏

      builder.setNotificationBuilder(
             NotificationBuilder.create()
                     .setRingtone(true)
                     .setIcon(R.mipmap.dialog4)
                     .setTicker("custom_ticker")
                     .setContentTitle("custom title")
                     .setContentText(getString(R.string.custom_content_text))
     );

是否显示失败对话框

  builder.setShowDownloadFailDialog(false); 默认true

自定义下载路径

  builder.setDownloadAPKPath(address); 默认：/storage/emulated/0/AllenVersionPath/

可以设置下载监听

 builder.setApkDownloadListener(new APKDownloadListener() {
         @Override
         public void onDownloading(int progress) {

         }

         @Override
         public void onDownloadSuccess(File file) {

         }

         @Override
         public void onDownloadFail() {

         }
     });

自定义界面

自定义界面使用回调方式，开发者需要返回自己定义的Dialog（父类android.app）

• 所有自定义的界面必须使用listener里面的context实例化

• 界面展示的数据通过UIData拿

自定义显示更新界面

设置 CustomVersionDialogListener

• 定义此界面必须有一个确定下载的按钮，按钮id必须为@id/versionchecklib_version_dialog_commit

• 如果有取消按钮（没有忽略本条要求），则按钮id必须为@id/versionchecklib_version_dialog_cancel

   builder.setCustomVersionDialogListener((context, versionBundle) -> {
      BaseDialog baseDialog = new BaseDialog(context, R.style.BaseDialog, R.layout.custom_dialog_one_layout);
      //versionBundle 就是UIData，之前开发者传入的，在这里可以拿出UI数据并展示
      TextView textView = baseDialog.findViewById(R.id.tv_msg);
      textView.setText(versionBundle.getContent());
      return baseDialog;
  });
  

自定义下载中对话框界面

设置CustomDownloadingDialogListener

• 如果此界面要设计取消操作（没有忽略），请务必将id设置为@id/versionchecklib_loading_dialog_cancel

   builder.setCustomDownloadingDialogListener(new CustomDownloadingDialogListener() {
      @Override
      public Dialog getCustomDownloadingDialog(Context context, int progress, UIData versionBundle) {
          BaseDialog baseDialog = new BaseDialog(context, R.style.BaseDialog, R.layout.custom_download_layout);
          return baseDialog;
      }
  //下载中会不断回调updateUI方法
      @Override
      public void updateUI(Dialog dialog, int progress, UIData versionBundle) {
          TextView tvProgress = dialog.findViewById(R.id.tv_progress);
          ProgressBar progressBar = dialog.findViewById(R.id.pb);
          progressBar.setProgress(progress);
          tvProgress.setText(getString(R.string.versionchecklib_progress, progress));
      }
  });
  

自定义下载失败对话框

设置CustomDownloadFailedListener

• 如果有重试按钮请将id设置为@id/versionchecklib_failed_dialog_retry

• 如果有 确认/取消按钮请将id设置为@id/versionchecklib_failed_dialog_cancel

     builder.setCustomDownloadFailedListener((context, versionBundle) -> {
      BaseDialog baseDialog = new BaseDialog(context, R.style.BaseDialog, R.layout.custom_download_failed_dialog);
      return baseDialog;
  });