通过Bugly进行自动更新

概述

升级功能是专为App的灰度升级而开发的组件,在bugly内测页面配置好App的更新策略,策略指定的老版本App在启动时会自动检测更新并提示升级,为团队的应用分发,灰度内测提供一站式解决方案。

自动导入(推荐)

使用Android Studio创建project

配置示例(路径app/build.gradle):

  android {
        defaultConfig {
          ndk {
            //设置支持的SO库架构
            abiFilters 'armeabi' //, 'x86', 'armeabi-v7a', 'x86_64', 'arm64-v8a'
          }
        }
      }
      dependencies {
          //注释掉原有bugly的仓库
          //compile 'com.tencent.bugly:crashreport:latest.release'//其中latest.release指代最新版本号,也可以指定明确的版本号,例如2.3.2
          compile 'com.tencent.bugly:crashreport_upgrade:latest.release'//其中latest.release指代最新版本号,也可以指定明确的版本号,例如1.2.0
          compile 'com.tencent.bugly:nativecrashreport:latest.release' //其中latest.release指代最新版本号,也可以指定明确的版本号,例如2.2.0
      }

后续更新升级SDK时,只需变更配置脚本中的版本号即可。


参数配置

在AndroidMainfest.xml中进行以下配置:

1. 权限配置

<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_LOGS" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

2. Activity配置

<activity
    android:name="com.tencent.bugly.beta.ui.BetaActivity"
    android:configChanges="keyboardHidden|orientation|screenSize|locale"
    android:theme="@android:style/Theme.Translucent" />

混淆配置

为了避免混淆SDK,在Proguard混淆文件中增加以下配置:

-dontwarn com.tencent.bugly.**
-keep public class com.tencent.bugly.**{*;}
-keep class android.support.**{*;}

SDK初始化

注意:如果您之前使用过Bugly SDK,请将以下这句注释掉。

CrashReport.initCrashReport(getApplicationContext(), "注册时申请的APPID", false); 

统一初始化方法:

Bugly.init(getApplicationContext(), "注册时申请的APPID", false);

参数解析:

参数1:上下文对象

参数2:注册时申请的APPID

参数3:是否开启debug模式,true表示打开debug模式,false表示关闭调试模式

提示:已经接入Bugly用户改用上面的初始化方法,不影响原有的crash上报功能; init方法会自动检测更新,不需要再手动调用Beta.checkUpgrade(), 如需增加自动检查时机可以使用Beta.checkUpgrade(false,false);

参数1:isManual 用户手动点击检查,非用户点击操作请传false

参数2:isSilence 是否显示弹窗等交互,[true:没有弹窗和toast] [false:有弹窗或toast]




Bugly Android 应用升级 SDK 高级配置


我们提供Beta类作为Bugly的初始化扩展,通过Beta类可以修改升级的检测时机,界面元素以及自定义升级行为,可以参考BetaSDKDemo的相关设置。

自动初始化开关

 Beta.autoInit = true;

true表示app启动自动初始化升级模块; false不会自动初始化; 开发者如果担心sdk初始化影响app启动速度,可以设置为false,在后面某个时刻手动调用Beta.init(getApplicationContext(),false);

自动检查更新开关

Beta.autoCheckUpgrade = true;

true表示初始化时自动检查升级; false表示不会自动检查升级,需要手动调用Beta.checkUpgrade()方法;

升级检查周期设置

Beta.upgradeCheckPeriod = 60 * 1000;

设置升级检查周期为60s(默认检查周期为0s),60s内SDK不重复向后台请求策略);

延迟初始化

 Beta.initDelay = 1 * 1000;

设置启动延时为1s(默认延时3s),APP启动1s后初始化SDK,避免影响APP启动速度;

设置通知栏大图标

  Beta.largeIconId = R.drawable.ic_launcher;

largeIconId为项目中的图片资源;

设置状态栏小图标

 Beta.smallIconId = R.drawable.ic_launcher;

smallIconId为项目中的图片资源id

设置更新弹窗默认展示的banner

  Beta.defaultBannerId = R.drawable.ic_launcher;

defaultBannerId为项目中的图片资源Id; 当后台配置的banner拉取失败时显示此banner,默认不设置则展示“loading...“;

设置sd卡的Download为更新资源存储目录

 Beta.storageDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS);

后续更新资源会保存在此目录,需要在manifest中添加WRITE_EXTERNAL_STORAGE权限;

设置开启显示打断策略

Beta.showInterruptedStrategy = true;

设置点击过确认的弹窗在App下次启动自动检查更新时会再次显示。

添加可显示弹窗的Activity

Beta.canShowUpgradeActs.add(MainActivity.class);

例如,只允许在MainActivity上显示更新弹窗,其他activity上不显示弹窗; 如果不设置默认所有activity都可以显示弹窗。

设置自定义升级对话框UI布局

 Beta.upgradeDialogLayoutId = R.layout.upgrade_dialog;

upgrade_dialog为项目的布局资源。 注意:因为要保持接口统一,需要用户在指定控件按照以下方式设置tag,否则会影响您的正常使用: - 特性图片:beta_upgrade_banner,如:android:tag="beta_upgrade_banner"

  • 标题:beta_title,如:android:tag="beta_title"

  • 升级信息:beta_upgrade_info 如: android:tag="beta_upgrade_info"

  • 更新属性:beta_upgrade_feature 如: android:tag="beta_upgrade_feature"

  • 取消按钮:beta_cancel_button 如:android:tag="beta_cancel_button"

  • 确定按钮:beta_confirm_button 如:android:tag="beta_confirm_button"

设置自定义tip弹窗UI布局

Beta.tipsDialogLayoutId = R.layout.tips_dialog;

注意:因为要保持接口统一,需要用户在指定控件按照以下方式设置tag,否则会影响您的正常使用:

  • 标题:beta_title,如:android:tag="beta_title"

  • 提示信息:beta_tip_message 如: android:tag="beta_tip_message"

  • 取消按钮:beta_cancel_button 如:android:tag="beta_cancel_button"

  • 确定按钮:beta_confirm_button 如:android:tag="beta_confirm_button"

设置升级对话框生命周期回调接口

Beta.upgradeDialogLifecycleListener = new UILifecycleListener<UpgradeInfo>() {
            @Override
            public void onCreate(Context context, View view, UpgradeInfo upgradeInfo) {
                Log.d(TAG, "onCreate");

            }

            @Override
            public void onStart(Context context, View view, UpgradeInfo upgradeInfo) {
                Log.d(TAG, "onStart");
            }

            @Override
            public void onResume(Context context, View view, UpgradeInfo upgradeInfo) {
                Log.d(TAG, "onResume");
                // 注:可通过这个回调方式获取布局的控件,如果设置了id,可通过findViewById方式获取,如果设置了tag,可以通过findViewWithTag,具体参考下面例子:

                // 通过id方式获取控件,并更改imageview图片
                ImageView imageView = (ImageView) view.findViewById(R.id.icon);
                imageView.setImageResource(R.mipmap.ic_launcher);

                // 通过tag方式获取控件,并更改布局内容
                TextView textView = (TextView) view.findViewWithTag("textview");
                textView.setText("my custom text");

                // 更多的操作:比如设置控件的点击事件
                imageView.setOnClickListener(new View.OnClickListener() {
                    @Override
                    public void onClick(View v) {
                        Intent intent = new Intent(getApplicationContext(), OtherActivity.class);
                        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                        startActivity(intent);
                    }
                });
            }

            @Override
            public void onPause(Context context, View view, UpgradeInfo upgradeInfo) {
                Log.d(TAG, "onPause");
            }

            @Override
            public void onStop(Context context, View view, UpgradeInfo upgradeInfo) {
                Log.d(TAG, "onStop");
            }

            @Override
            public void onDestroy(Context context, View view, UpgradeInfo upgradeInfo) {
                Log.d(TAG, "onDestory");
            }

        };

如果想监听升级对话框的生命周期事件,可以通过设置OnUILifecycleListener接口 回调参数解释: - context - 当前弹窗上下文对象 - view - 升级对话框的根布局视图,可通过这个对象查找指定view控件 - upgradeInfo - 升级信息

设置是否显示消息通知

Beta.enableNotification = true;

如果你不想在通知栏显示下载进度,你可以将这个接口设置为false,默认值为true。

设置Wifi下自动下载

Beta.autoDownloadOnWifi = false;

如果你想在Wifi网络下自动下载,可以将这个接口设置为true,默认值为false。

设置是否显示弹窗中的apk信息

Beta.canShowApkInfo = true;

如果你使用我们默认弹窗是会显示apk信息的,如果你不想显示可以将这个接口设置为false。

关闭热更新能力

Beta.enableHotfix = true;

升级SDK默认是开启热更新能力的,如果你不需要使用热更新,可以将这个接口设置为false。


初始化统一接口

 Bugly.init(this, APP_ID, false);


  • 0
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 2
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值