SDKHotfix(SDK 熱（rè）修複（fù）工具包)1.3 最新免費版

SDKHotfix(SDK熱修複工具包)特點（diǎn）

5分鍾即可（kě）讓你的SDK擁有熱修複的能力通遼在線app下（xià）載-通遼在線客戶端1.2.1 安卓版

節省踩坑和開發成本

hookandcreateGradleTask

Kotlin+groovy

熱修複（fù）

非對稱加（jiā）密+對稱加密

擴展美團Robust開源庫，使（shǐ）其具有其他熱更庫不具備的補（bǔ）丁回滾功能

數據和監控思維

優點

無兼容問題

實時生效

修複（fù）成功率高達99.9%

在用戶規模千萬級別的（de）app中驗證過，可信賴

支（zhī）持補丁異常（cháng）自（zì）動失效，不（bú）用再擔心補丁造成（chéng）crash啦~

使用方法

1.添（tiān）加配置和開關

1.1在項目gradle.properties中添加開關和配置

#接入第（dì）一步：添加配置和開關
#Application模式，Robust需要是Application才能插入代碼和打（dǎ）補丁
isAppModule=false
#Application模（mó）式下開啟這個就可以打補丁
isPatchModule=false
#你的業（yè）務sdk的包名
sdkPackageName=com.feelschaotic.samplesdk
#是否開啟混淆，一般情況下sdk默認不混淆
isProguard=false
#業（yè）務sdk版本號，請（qǐng）保持三位，且無後綴，且在打包前就要確定好版本，確保版本打在包中
SDK_VERSION=0.0.1
#業務sdk的upload_artifact_id
SDK_ARTIFACT_ID=MY-SAMPLES-SDK

1.2在sdkbuild.gradle中加入配置替換原有的 applyplugin:'com.androids.library'

//注意！！一定要放在文件最前麵
//applyplugin表示該（gāi）項目會使用指定（dìng）的插件,sdk對應的是com.androids.library
if(isAppModule.toBoolean()){
  applyplugin:'com.androids.application'
  if(isPatchModule.toBoolean()){
    //製作補丁時將這個打開，auto-patch-plugin緊（jǐn）跟著com.androids.application
    applyplugin:'auto-patch-plugin'
  }
  applyplugin:'robust'
}else{
  applyplugin:'com.androids.library'
}

applyfrom:rootProject.getRootDir().getAbsolutePath()+"/packPlugin.gradle"

1.3加入buildConfigField

//視（shì）情況而定，如果（guǒ）你在初始化熱更（gèng）sdk時的（de）傳入的版本號有（yǒu）另外的取值方式，也可以不加此buildConfig
androids{
defaultConfig{
 buildConfigField"String","SDK_VERSION",""${SDK_VERSION}""
 buildConfigField"String","SDK_ARTIFACT_ID",""${SDK_ARTIFACT_ID}""
}
}

1.4在sdkbuild.gradle中配置簽名

androids{
 //簽名的配置
  signingConfigs{
    debug{

    }
    //release版本的簽（qiān）名
    release{
      //簽名的（de）一些信息
      keyAlias'key0'
      keyPassword'123456'
      storeFilefile('./hotfix.jks')
      storePassword'123456'
    }
  }
}

1.5配置混淆

複製粘貼配置到sdkbuild.gradle

androids{
 buildTypes{
    innerTest{
      //...
      matchingFallbacks=['debug','release']
    }
    release{
      signingConfigsigningConfigs.release
      minifyEnabledisProguard.toBoolean()//此處（chù）取的isProguard就是1.1在（zài）項目（mù）`gradle.properties`中（zhōng）添加的isProguard開（kāi）關
      proguardFilesgetDefaultProguardFile('proguard-androids.txt'),'proguard-rules.pro'
    }
  }

  sourceSets{
     main{
       //Application和Library清單文件處理方式不同
       if(isAppModule.toBoolean()){
         manifest.srcFile'src/main/debug/androidsManifest.xml'
       }else{
         manifest.srcFile'src/main/release/androidsManifest.xml'
       }
     }
   }
}

複製粘貼示例sdk的lib-proguard-rules.pro到業務SDKmodule目錄下，修（xiū）改文件中的包名

接著配置好sdk自（zì）己的混淆規則

androids{
  defaultConfig{
    consumerProguardFiles'lib-proguard-rules.pro'
  }
}

2.導庫

在sdk的 build.gradle 中引入庫

implementation'com.github.feelschaotic:SDKHotFix:XX-RELEASE'

XX為最新SDK版本號，例如implementation'com.github.feelschaotic:SDKHotFix:1.3-RELEASE'

注：最新（xīn）版本見README標誌 

在根項目build.gradle中加入maven配置

repositories{
  //接入第二步:增加maven配置
  maven{url"https://mvnrepository.com/"}
}
...
allprojects{
  repositories{
    maven{url"https://mvnrepository.com/"}
  }
}

再添加classpath配置

//Application模式下引入（rù）Robust腳（jiǎo）本插件
 if(isAppModule.toBoolean()){
    classpath'com.github.feelschaotic:Robust.gradle-plugin:0.4.87.5-RELEASE'
    classpath'com.github.feelschaotic:Robust.auto-patch-plugin:0.4.87.5-RELEASE'
 }

4.複製示（shì）例（lì）項目的（de）腳本和文件

4.1複製MainActivity.java到sdkmodule的java包名目錄下（目的是為了application打包配置不報錯（cuò））

4.2複製debug和release2個文件夾到main目錄（lù）下，修改（gǎi）裏麵的androidsManifest.xml，更改為你自己（jǐ）業務SDK的包名

<manifestpackage="${packageName}"
     xmlns:androids="http://schemas.androids.com/apk/res/androids"
     xmlns:tools="http://schemas.androids.com/tools">

4.3複製robust.xml到sdkmodule根目錄，更改下包名

4.4複製packPlugin.gradle到項目的根目錄

5.初始（shǐ）化熱（rè）更庫

valconfig:HotfixConfig=HotfixConfig.Builder().debug(true)
        .appVersion(BuildConfig.VERSION_NAME)
        .packageName(BuildConfig.APPLICATION_ID)
        .build()
    HotfixManager.init(application,config)

6.添加權限

<uses-permissionandroids:name="androids.permission.INTERNET"/>
<uses-permissionandroids:name="androids.permission.ACCESS_NETWORK_STATE"/>
<uses-permissionandroids:name="androids.permission.ACCESS_WIFI_STATE"/>
<uses-permissionandroids:name="androids.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permissionandroids:name="androids.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>

7.加入混（hún）淆

-keepclasscom.alibaba.sdk.androids.oss.**{*;}
-dontwarnokio.**
-dontwarnorg.apache.commons.codec.binary.**

待改進

在編譯階段插件侵（qīn）入了（le）產品代碼，對運行效率、方法數（shù）、包體（tǐ）積還（hái）是產生了一（yī）些副作用。（可（kě）指定某些（xiē）class無（wú）需插入方法，減少插樁數）

so和（hé）資源的替換目前暫未實現

對（duì）於隻有字段訪（fǎng）問的函數無法直接修複，可通過調用處間接修複（fù）

上傳GradleTask尚（shàng）未在MAC環境下測試

上傳的補丁支持（chí）按包名存檔（dàng）

要商用（yòng）的小夥伴要注意（yì），建議換成自己的後端接口或（huò）自己續（xù）費一個bmob應用，因為bmob雲函數服務超過40天需要收費，所以本項目需要定期更新應用秘鑰。

SDKHotfix(SDK熱修複工具包)是一款讓SDK開發者能快速賦（fù）予SDK熱修複的能力.