最近專案裡的採用免費的Bugly應用升級功能，由於預設的 UI 非常的簡陋且與專案整體風格不搭，所以需要自定義UI，本篇文章記錄在實現過程中的一些注意事項。根據官方文件可知，自定義升級介面有以下兩種方式。

#### 一、固定控制元件ID

這種方式比較簡單，只需要自己編寫佈局，並設定控制元件的Tag 即可。

```
<textview android:layout_width="match_parent" android:layout_height="@dimen/dp_62" android:gravity="center" android:tag="beta_title" android:textsize="@dimen/sp_16" android:textcolor="@color/white" android:text="發現新版本"></textview>
```

這裡有個需要注意的地方就是`beta_title` `beta_upgrade_info` `beta_upgrade_feature` `beta_cancel_button` `beta_confirm_button` 這幾個控制元件 Tag 缺一不可，缺了會導致整個頁面是黑色的。

透過以上設定，基本就可以展示自己的 UI 了，但隨即也會發現一個問題：狀態列是黑色，下方還有一條灰色的類似 ActionBa r的東西。

查閱文件發現，可以注 Bugly 彈窗的生命週期回撥，如下所示。

```
Beta.upgradeDialogLifecycleListener = object :UILifecycleListener<upgradeinfo>{
            override fun onCreate(p0: Context?, p1: View?, p2: UpgradeInfo?) {
            }

override fun onStart(p0: Context?, p1: View?, p2: UpgradeInfo?) {
            }

override fun onResume(p0: Context?, p1: View?, p2: UpgradeInfo?) {
            }

override fun onPause(p0: Context?, p1: View?, p2: UpgradeInfo?) {
            }

override fun onStop(p0: Context?, p1: View?, p2: UpgradeInfo?) {
            }

override fun onDestroy(p0: Context?, p1: View?, p2: UpgradeInfo?) {
            }

}
```

對應的就是 BetaActivity 的生命週期，於是只需要在 onCreate 回撥中，設定沉浸式狀態即可。

至於怎麼設定可以按照自己專案裡的來，我設定了沉浸式，但有一條灰色的還是去不掉。而且這個方式無法滿足我

們專案產品的要求，需要有進度條顯示。於是可以用另外一種自定義 Activity的方式。

#### 二、自定義Activity

使用這種方式雖然比第一種稍微複雜了一點點?，但是可定製的範圍卻大了很多。彈窗介面的繪製與生命週期均由自己維護，Bugly 負責下載時回撥與事件上報，並提供相關介面控制任務下載，獲取任務狀態等。

##### 1.設定接收更新策略回撥

```kotlin
Beta.upgradeListener = object : UpgradeListener {
            override fun onUpgrade(p0: Int, p1: UpgradeInfo?, p2: Boolean, p3: Boolean) {
                p1?.let {
                    startActivity(Intent(applicationContext, UpdateActivity::class.java).apply {
                        flags = Intent.FLAG_ACTIVITY_NEW_TASK
                    })
                }
            }
  }
```

注意這一步要寫在 init 之前。在這裡判斷了 如果 UpgradeInfo 不會null的話，說明有更新了，於是跳轉到自定義的 Activity 即可。

更新一般都是彈窗，然後我們跳轉到 Activity，就無法看見下方 Activity，跳轉動畫也比較生硬，符合習慣的應該是像普通彈窗一樣彈出即可。所以這裡需要將 Activity Dialog化。

##### 2. 設定 Activity 透明

只需要自定義一個 Style 即可，如下。

```xml
<style name="updateStyle" parent="Theme.AppCompat.Light.NoActionBar">
        <item name="android:windowFrame">@null</item>
        
        <item name="android:windowIsTranslucent">true</item>
        
        <item name="android:windowNoTitle">true</item>
        
        <item name="android:windowBackground">@color/transparent</item>
        
        <item name="android:backgroundDimEnabled">true</item>
</style>
```

然後給自定義的Activity設定上即可。

```xml
 <activity android:name=".activity.setting.UpdateActivity" android:exported="false" android:theme="@style/updateStyle" android:screenorientation="portrait"></activity>
```

如圖所示，Activity 已經變得和 Dialog 一模一樣了。

##### 3.獲取策略資訊

```kotlin
val upgradeInfo = Beta.getUpgradeInfo()
binding.run {
   if (upgradeInfo.upgradeType==2){//如果是強制升級
        betaCancelButton.gone()//隱藏下次再說按鈕
    }
    betaUpgradeFeature.text = upgradeInfo.newFeature //顯示更新內容
}
```

UpgradeInfo 包含如下資訊，如果是強制升級的話，需要隱藏相應按鈕，並且遮蔽掉返回按鍵。

```java
		public String id = "";//唯一標識
    public String title = "";//升級提示標題
    public String newFeature = "";//升級特性描述
    public long publishTime = 0;//升級釋出時間,ms
    public int publishType = 0;//升級型別 0測試 1正式
    public int upgradeType = 1;//升級策略 1建議 2強制 3手工
    public int popTimes = 0;//提醒次數
    public long popInterval = 0;//提醒間隔
    public int versionCode;
    public String versionName = "";
    public String apkMd5;//包md5值
    public String apkUrl;//APK的CDN外網下載地址
    public long fileSize;//APK檔案的大小
    pubilc String imageUrl; // 圖片url
```

##### 4.獲取下載任務

```kotlin
 var strategyTask = Beta.getStrategyTask()
```

在 strategyTask 物件中，我們可以判斷之前是否已經下載完了。

```kotlin
strategyTask?.let {
    if (it.saveFile!=null){
         betaCancelButton.gone()
         betaConfirmButton.text = "安裝"
         isFileSave = true
      }
    }
```

如果存在之前下載好但沒安裝的 Apk ，就可以直接去安裝即可。

```kotlin
 Beta.installApk(strategyTask?.saveFile)
```

##### 4.下載

```kotlin
 //首先 Activity 實現 DownloadListener 介面
class UpdateActivity : AppCompatActivity(), DownloadListener {
		override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        Beta.registerDownloadListener(this)//註冊下載事件回撥
     }
     
      override fun onDestroy() {
        super.onDestroy()
        Beta.unregisterDownloadListener()//取消監聽下載事件
    }
    
     override fun onBackPressed() {
     	//遮蔽返回按鈕
    }

//下載接收中
    override fun onReceive(p0: DownloadTask?) {
    p0?.let {        		binding.pb.setProgress(((it.savedLength.toDouble()/it.totalLength.toDouble())*100).toInt())
       }
    }
		//下載完成
    override fun onCompleted(p0: DownloadTask?) {
       binding.betaConfirmButton.text = "安裝"
        binding.betaConfirmButton.isClickable = true
        isFileSave = p0?.saveFile!=null
    }
		//下載失敗
    override fun onFailed(p0: DownloadTask?, p1: Int, p2: String?) {
    
    }
}
```

我們先註冊回撥，直接呼叫`Beta.startDownload()`就可以開始下載了，在onReceive 中可以獲取下載進度。下載完成後會自定安裝。也可以設定 `Beta.autoInstallApk = false`手動安裝

#### 三：顯示小紅點

在 App 關於中，一般都有一個版本顯示，點選可以手動檢查更新，或者又更新的話顯示一個小紅點提醒使用者去點選，用Bugly其實也可以實現，步驟如下。

```kotlin
 Beta.getUpgradeInfo()?.let {
    ivRedDot.show()
 }?:let { ivRedDot.gone() }
```

獲取升級資訊，不為null就說明又更新策略，顯示小紅點即可。

下面是點選檢查升級，注意第二個引數，是是否顯示彈窗。

```kotlin
rlCheckUpdate.click {
   Beta.checkUpgrade(true,false)
}
```

以上就是關於 Bugly 應用升級相關功能的實現記錄。

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/45a8c005d47a4c9e9625c01e362cb2ae.jpeg#pic_center)</upgradeinfo>

Android技術分享| Bugly 應用升級自定義UI

相關文章