Unity3D Bugly热更新操作指南
bugly的热更新使用的是腾讯开源的热更方案Tinker,使用的方法比较简单。需要用到的工具Android Studio
- Unity导出安卓工程到AndroidStudio中打开
- 在打开的工程中找到自己项目的build.gradle
buildscript {
repositories {
jcenter {
url "http://jcenter.bintray.com/"
}
google()
maven { url "https://maven.google.com" }
}
dependencies {
classpath 'com.android.tools.build:gradle:3.0.1'
//引入的tinker的support依赖,可以指定版本,此处指定的是最新版本
classpath "com.tencent.bugly:tinker-support:latest.release"
}
}
android{
defaultConfig {
/*
...其他的一些配置
*/
ndk {
abiFilters 'armeabi'
}
}
}
dependencies {
implementation "com.android.support:multidex:1.0.2" // 多dex配置
//注释掉原有bugly的仓库,如果本身的项目使用了Bugly的话,须删除之前的jar包和依赖否则会报错
//compile 'com.tencent.bugly:crashreport:latest.release'//其中latest.release指代最新版本号,也可以指定明确的版本号,例如1.3.4
implementation 'com.tencent.bugly:crashreport_upgrade:latest.release'
// 指定tinker依赖版本(注:应用升级1.3.5版本起,不再内置tinker)
implementation 'com.tencent.tinker:tinker-android-lib:latest.release'
implementation 'com.tencent.bugly:nativecrashreport:latest.release'
}
//添加tinker-support.gradle的引用
apply from: 'tinker-support.gradle'
3.添加tinker-support.gradle文件到需要打包的工程中(Unity导出的工程的话,就加在上一步修改build.gradle一个层级)
具体的内容如下:
apply plugin: 'com.tencent.bugly.tinker-support'
def bakPath = file("${buildDir}/bakApk/")
/**
* 此处填写每次构建生成的基准包目录
*/
def baseApkDir = "AndroidWeeder-0613-14-41-00"
/**
* 对于插件各参数的详细解析请参考
*/
tinkerSupport {
// 开启tinker-support插件,默认值true
enable = true
// 指定归档目录,默认值当前module的子目录tinker
autoBackupApkDir = "${bakPath}"
// 是否启用覆盖tinkerPatch配置功能,默认值false
// 开启后tinkerPatch配置不生效,即无需添加tinkerPatch
overrideTinkerPatchConfiguration = true
// 编译补丁包时,必需指定基线版本的apk,默认值为空
// 如果为空,则表示不是进行补丁包的编译
// @{link tinkerPatch.oldApk }
baseApk = "${bakPath}/${baseApkDir}/app-release.apk"
// 对应tinker插件applyMapping
baseApkProguardMapping = "${bakPath}/${baseApkDir}/app-release-mapping.txt"
// 对应tinker插件applyResourceMapping
baseApkResourceMapping = "${bakPath}/${baseApkDir}/app-release-R.txt"
// 构建基准包和补丁包都要指定不同的tinkerId,并且必须保证唯一性
//tinkerId = "base-1.0.1"
autoGenerateTinkerId = true
// 构建多渠道补丁时使用
buildAllFlavorsDir = "${bakPath}/${baseApkDir}"
// 是否启用加固模式,默认为false.(tinker-spport 1.0.7起支持)
isProtectedApp = true
// 是否开启反射Application模式
enableProxyApplication = true
// 是否支持新增非export的Activity(注意:设置为true才能修改AndroidManifest文件)
supportHotplugComponent = true
}
/**
* 一般来说,我们无需对下面的参数做任何的修改
* 对于各参数的详细介绍请参考:
* https://github.com/Tencent/tinker/wiki/Tinker-%E6%8E%A5%E5%85%A5%E6%8C%87%E5%8D%97
*/
tinkerPatch {
//oldApk ="${bakPath}/${appName}/app-release.apk"
ignoreWarning = false
useSign = true
dex {
dexMode = "jar"
pattern = ["classes*.dex"]
loader = []
}
lib {
pattern = ["lib/*/*.so"]
}
res {
pattern = ["res/*", "r/*", "assets/*", "resources.arsc", "AndroidManifest.xml"]
ignoreChange = []
largeModSize = 100
}
packageConfig {
}
sevenZip {
zipArtifact = "com.tencent.mm:SevenZip:1.1.10"
// path = "/usr/local/bin/7za"
}
buildConfig {
keepDexApply = false
//tinkerId = "1.0.1-base"
//applyMapping = "${bakPath}/${appName}/app-release-mapping.txt" // 可选,设置mapping文件,建议保持旧apk的proguard混淆方式
//applyResourceMapping = "${bakPath}/${appName}/app-release-R.txt" // 可选,设置R.txt文件,通过旧apk文件保持ResId的分配
}
}
注意:此配置在已经设置tinkerID为自动创建,无需自行指定tinkerID。
4.初始化Bugly,
Unity中已经初始化的代码注释掉后,在Android工程中创建UnityApplication,并将其在AndroidManifest-application节点中设置为启动类。
import android.app.Application;
import android.content.Context;
import android.content.res.Configuration;
import android.support.multidex.MultiDex;
import android.support.multidex.MultiDexApplication;
import android.util.Log;
import com.tencent.bugly.Bugly;
import com.tencent.bugly.beta.Beta;
import com.we.game.sdk.core.WeGameApplication;
/**
* Created by Administrator on 2019/5/5.
*/
public class UnityApplication extends MultiDexApplication {
@Override
public void onCreate() {
super.onCreate();
WeGameApplication.onCreate(this);
Bugly.init(this,"此处填写项目的BuglyID",false);
}
@Override
public void onTerminate() {
super.onTerminate();
WeGameApplication.onTerminate();
}
@Override
protected void attachBaseContext(Context base) {
super.attachBaseContext(base);
WeGameApplication.attachBaseContext(base);
///此处以下的为热更新所需要加入的
MultiDex.install(base);
// 安装tinker
Beta.installTinker();
}
@Override
public void onConfigurationChanged(Configuration newConfig) {
super.onConfigurationChanged(newConfig);
WeGameApplication.onConfigurationChanged(newConfig);
}
}
5.打基准包
基准包就是正常的打包流程,使用Gradle的build下边的各个配置打包
打出来的包会被放置在build-bakAPk下边,每次打包都会根据时间生成文件夹存储
6.打补丁
补丁可以在Gradle下tinker-support中找到对应平台的buildTinkerPatchsomeplatformRelease操作
生成的文件会被移动到Output-patch文件夹下。
将生成的三个文件中名称中包含7zip的文件通过bugly后台上传即可。