Android studio3.0 命令行方式简单集成腾讯Tinker热修复插件

简介:

关于热修复的介绍现在网上有很多，所以在此我就不过多BB，此篇博客的特点有两个，首先，这是一个针对Android studio3.0用户的博客，其次，这里采用的是命令行的方式，这是方式在工作中并不经常使用，相反，在工作中基本都是使用gradle配置的方式，但是命令行的方式相比于gradle是简单很多的，所以这就这是一个入门级的tinker集成，意在让大家了解tinker这个相对最为全面的热修复框架（高手请绕路，前方低能）。

1、在gradle.properties中配置我们tinker的版本。这种配置方式就相当于定义一个变量，用于指定我们导入依赖的版本，这样对于同一框架的多个依赖可以进行很好的版本控制。

粘贴板:TINKER_VERSION=1.9.0

2、module中导入依赖，在这里可以看到我们刚刚定义的变量在这里得以使用

粘贴板:

    //可选，用于生成application类    implementation("com.tencent.tinker:tinker-android-lib:${TINKER_VERSION}") { changing = true }    //tinker的核心库    annotationProcessor("com.tencent.tinker:tinker-android-anno:${TINKER_VERSION}") { changing = true }    compileOnly("com.tencent.tinker:tinker-android-anno:${TINKER_VERSION}") { changing = true }    implementation "com.android.support:multidex:1.0.2"

3、创建一个管理类，来管理我们Tinker中所有的api，方便我们的使用和以后对其他工程的植入。代码都有注释，这里就直接上代码了

package com.jiaxin.tinkerthree.tinker;import android.content.Context;import com.tencent.tinker.lib.tinker.Tinker;import com.tencent.tinker.lib.tinker.TinkerInstaller;import com.tencent.tinker.loader.app.ApplicationLike;/** * Created by Zzw on 2017/12/24.14:06 * * @function 对Tinker的所有api做一层封装 */public class TinkerManger {    //判断tinker是否已经初始化    private static boolean isInstalled = false;    private static ApplicationLike mAppLike;    /**     * 由外部调用完成tinker 的初始化     * @param applicationLike     */    public static void instaillTinker(ApplicationLike applicationLike){        mAppLike = applicationLike;        if (isInstalled){            return;        }        TinkerInstaller.install(mAppLike);//完成tinker初始化        isInstalled = true;    }    /**     * 完成patch文件加载     * @param path     */    public static  void loadPatch(String path){        if (Tinker.isTinkerInstalled()){            TinkerInstaller.onReceiveUpgradePatch(getApplicationContext(), path);        }    }    /**     * 通过applicationLike获取context     * @return     */    private static Context getApplicationContext(){        if (mAppLike != null){            return mAppLike.getApplication().getApplicationContext();        }        return null;    }}

3、根据官方的要求我们要使用ApplicationLike这个类，来生成application，所以我们这里创建一个类来继承他

package com.jiaxin.tinkerthree.tinker;import android.app.Application;import android.content.Context;import android.content.Intent;import android.support.multidex.MultiDex;import com.tencent.tinker.anno.DefaultLifeCycle;import com.tencent.tinker.loader.app.ApplicationLike;import com.tencent.tinker.loader.shareutil.ShareConstants;/** * Created by Zzw on 2017/12/24.14:11 */@DefaultLifeCycle(application = ".MyTinkerApplication" ,        flags = ShareConstants.TINKER_ENABLE_ALL , loadVerifyFlag = false)public class CustomTinkerLike extends ApplicationLike {    public CustomTinkerLike(Application application, int tinkerFlags, boolean tinkerLoadVerifyFlag, long applicationStartElapsedTime, long applicationStartMillisTime, Intent tinkerResultIntent) {        super(application, tinkerFlags, tinkerLoadVerifyFlag, applicationStartElapsedTime, applicationStartMillisTime, tinkerResultIntent);    }    @Override    public void onBaseContextAttached(Context base) {        super.onBaseContextAttached(base);        MultiDex.install(base);//使应用支持分包        TinkerManger.instaillTinker(this);    }}

注意这里我们使用了 一个注解，注解中后面两个参数可以认为是固定参数，第一个是我们指定的生成Application类的名字，这里我们叫他"MyTinkerApplication"

以上配置都完毕后我们编译整个工程，tinker的注解就会为我们生成一个MyTinkerApplication类。

4、清单文件中配置

这里的配置就是指定application为我们刚刚生成的"MyTinkerApplication"，还有一个TINKER_ID的配置，这个主要是因为tinker在加载补丁文件的时候会只能的判断当前版本和补丁版本是否一致，如果不一致就会认为此补丁文件无效，就不会加载，所以我们这里做测试的话两次apk生成的时候只要这里不该动就好了

<?xml version="1.0" encoding="utf-8"?><manifest xmlns:android="http://schemas.android.com/apk/res/android"    package="com.jiaxin.tinkerthree">    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />    <application

<!-- 此处指定application为tinker为我们生成的application -->        android:name=".tinker.MyTinkerApplication"        android:allowBackup="true"        android:icon="@mipmap/ic_launcher"        android:label="@string/app_name"        android:roundIcon="@mipmap/ic_launcher_round"        android:supportsRtl="true"        android:theme="@style/AppTheme">        <activity android:name=".MainActivity">            <intent-filter>                <action android:name="android.intent.action.MAIN" />                <category android:name="android.intent.category.LAUNCHER" />            </intent-filter>        </activity>        <meta-data            android:name="UMENG_CHANNEL"            android:value="${UMENG_CHANNEL_VALUE}" />

<!-- 此处为tinker配置当前的应用版本 -->        <meta-data            android:name="TINKER_ID"            android:value="tinker_id_123456"            />    </application></manifest>

5、以上步骤完成后，我们tinker的配置工作基本也就完成了，接下来只要使用我们的tinker管理类，生成两个不同版本的apk即可，这里因为tinker是支持布局文件的修改的，所以我模拟了点击一个按钮增加一个按钮的功能， 下面是我activity中的使用，布局就不写了哈

package com.jiaxin.tinkerthree;import android.os.Bundle;import android.os.Environment;import android.support.v7.app.AppCompatActivity;import android.util.Log;import android.view.View;import android.widget.Toast;import com.jiaxin.tinkerthree.tinker.TinkerManger;import java.io.File;public class MainActivity extends AppCompatActivity {    //log key    public static final String TAG = "myLog";    //file's end name    private static final String FILE_END = ".apk";    //patch file's path    private String mPatchDir;    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_main);        mPatchDir = Environment.getExternalStorageDirectory().getAbsolutePath();        Log.d(TAG, "onCreate: " + mPatchDir);        File file = new File(mPatchDir);        if (file.exists()){            Toast.makeText(this, "文件存在", Toast.LENGTH_SHORT).show();        }else{            boolean mkdirs = file.mkdir();            Toast.makeText(this, mkdirs ? "创建成功" : "创建失败", Toast.LENGTH_SHORT).show();        }    }    /**     * @click     * @param view     * load tinker patch for application     */    public void loadPatch(View view){        TinkerManger.loadPatch(getPathName());    }    //get tinker patch fileName    private String getPathName() {        return mPatchDir.concat("/tinker").concat(FILE_END);    }}

6、好，接下来我们只要改变布局文件生成两个版本不同的apk即可，我这里是在新的apk中添加了一个按钮，所以old版本的apk只有一个按钮，用于点击加载补丁文件，new版本的apk中在第一个按钮的基础上又添加了一个按钮。

7、两个apk版本生成成功后接下来就是生成补丁apk，我们采用的是命令行的方式，所以当然是要使用tinker为我们提供的工具，我们将所有要使用到的文件和新旧两个版本的apk文件以及jks签名文件放在同一个目录下(建议新建一个文件夹)，然后打开命令行工具进入该文件夹，执行jar文件:

java -jar  tinker-patch-cli-1.7.7.jar

可以看到tinker提示我们该命令需要一堆参数，可以看到新旧版本apk文件我们已经准好了，只差一个tinker_config文件，我们打开这个文件，修改其中的loader为我们的application的名字，修改issue配置为我们签名的配置和密码

8、配置完毕后，打开命令行工具，指定好参数在执行刚刚的命令就可以在output文件夹中看到tinker为我们生成的apk文件，将patch_signed.apk(签名版的)这个文件改为我们一开始指定的文件名称(我这里是tinker.apk)，再将其拷贝到我们一开始指定的路径，我这里指定的是sd下默认路径，安装old版本apk整个过程就完成了~~。

9、打开安装好的旧版本apk，点击按钮，程序会闪退，再次打开就会发现后添加的按钮就已经被添加上去了，这里闪退不用担心，这是tinker默认的设置，因为tinker在加载补丁文件完毕后，不重新启动是不会生效的。这个也可以通过配置来更改，具体可以通过查看相关文档来实现。

工具下载请戳我~~