RePlugin初体验

RePlugin已经开放有一段时间了，但是一直没空搞这东西，这几天有机会来学习一下，并且打算使用到公司项目中去，刚刚集成完毕，打算和大家分享一下集成过程。
RePlugin是360新开发的插件化库，听说集成简单、效率高、稳定性强，最主要的是安装插件之后不需要重启，至于前几个特点，我也不知道怎么说，用用看吧。RePlugin、中文官网这个官网不是官方注册的，但是得到了官方的认可。
先看一下效果：

RePlugin分为内置和外置集成，这里就只介绍外置集成。
一、配置项目目录下的gradle：

buildscript {    repositories {        mavenLocal()        jcenter()    }    dependencies {        classpath 'com.android.tools.build:gradle:2.3.3'        classpath 'com.qihoo360.replugin:replugin-host-gradle:2.1.5'        // NOTE: Do not place your application dependencies here; they belong        // in the individual module build.gradle files    }}allprojects {    repositories {        mavenLocal()        jcenter()    }}task clean(type: Delete) {    delete rootProject.buildDir}

注意mavenLocal()必须放在jcenter()之前。
二、配置app目录下的gradle：

apply plugin: 'com.android.application'apply plugin: 'replugin-host-gradle'// If use AppCompat, open the useAppCompatrepluginHostConfig {    useAppCompat = true}android {    compileSdkVersion 25    buildToolsVersion "25.0.3"    defaultConfig {        applicationId "com.morse.testapp"        minSdkVersion 20        targetSdkVersion 25        versionCode 1        versionName "1.0"        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"    }    buildTypes {        release {            minifyEnabled false            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'        }    }}dependencies {    compile fileTree(include: ['*.jar'], dir: 'libs')    androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {        exclude group: 'com.android.support', module: 'support-annotations'    })    compile 'com.android.support:appcompat-v7:25.3.1'    compile 'com.android.support.constraint:constraint-layout:1.0.2'    testCompile 'junit:junit:4.12'    compile 'com.umeng.analytics:analytics:latest.integration'    compile 'org.xutils:xutils:3.5.0'    compile 'com.android.support:recyclerview-v7:25.3.1'    compile 'com.qihoo360.replugin:replugin-host-lib:2.1.5'    compile 'org.xutils:xutils:3.5.0'}

这里引入xtuils是为了下载插件。
三、配置Application，这里采用继承式，继承RePluginApplication：

package com.morse.testapp;import com.qihoo360.replugin.RePlugin;import com.qihoo360.replugin.RePluginApplication;import com.qihoo360.replugin.RePluginCallbacks;import com.qihoo360.replugin.RePluginConfig;import org.xutils.x;/** * @Author:曾明 * @Time:2017/5/19 18:26 * @Description: */public class TestApplication extends RePluginApplication {    private static TestApplication mInstance;    @Override    public void onCreate() {        super.onCreate();//        CrashHandler crashHandler = CrashHandler.getInstance();//        crashHandler.init(getApplicationContext());        mInstance = this;        x.Ext.init(this);        x.Ext.setDebug(BuildConfig.DEBUG); // 开启debug会影响性能        RePlugin.App.onCreate();    }    public static TestApplication getAppContext() {        return mInstance;    }    @Override    protected RePluginConfig createConfig() {        RePluginConfig c = new RePluginConfig();        // 允许“插件使用宿主类”。默认为“关闭”        c.setUseHostClassIfNotFound(true);        // FIXME RePlugin默认会对安装的外置插件进行签名校验，这里先关掉，避免调试时出现签名错误        c.setVerifySign(false);        c.setPrintDetailLog(BuildConfig.DEBUG);        c.setUseHostClassIfNotFound(true);        // 针对“安装失败”等情况来做进一步的事件处理        c.setEventCallbacks(new HostEventCallbacks(this));        c.setMoveFileWhenInstalling(true);        // FIXME 若宿主为Release，则此处应加上您认为"合法"的插件的签名，例如，可以写上"宿主"自己的。        // RePlugin.addCertSignature("AAAAAAAAA");        return c;    }    @Override    protected RePluginCallbacks createCallbacks() {        return new HostCallbacks(this);    }}

HostEventCallbacks和HostCallbacks是自定义的，分别集成RePluginEventCallbacks和RePluginCallbacks。RePluginCallbacks这个回调可以监测到本地有没有下载插件apk，并且可以做一下自定义的行为：

package com.morse.testapp;import android.app.ProgressDialog;import android.content.Context;import android.content.Intent;import android.util.Log;import android.widget.Toast;import com.qihoo360.replugin.RePlugin;import com.qihoo360.replugin.RePluginCallbacks;import com.qihoo360.replugin.model.PluginInfo;import org.xutils.common.Callback;import org.xutils.http.RequestParams;import org.xutils.x;import java.io.File;/** * 宿主针对RePlugin的自定义行为 * * @Author:曾明 * @Time:2017/7/15 17:32 * @Description: */public class HostCallbacks extends RePluginCallbacks {    public HostCallbacks(Context context) {        super(context);    }    @Override    public boolean onLoadLargePluginForActivity(Context context, String plugin, Intent intent, int process) {        return super.onLoadLargePluginForActivity(context, plugin, intent, process);    }    @Override    public boolean onPluginNotExistsForActivity(final Context context, final String plugin, Intent intent, int process) {        // FIXME 当插件"没有安装"时触发此逻辑，可打开您的"下载对话框"并开始下载。        // FIXME 其中"intent"需传递到"对话框"内，这样可在下载完成后，打开这个插件的Activity        if (BuildConfig.DEBUG) {            Log.d("morse", "onPluginNotExistsForActivity: Start download... p=" + plugin + "; i=" + intent);        }        return super.onPluginNotExistsForActivity(context, plugin, intent, process);    }}

RePluginEventCallbacks是安装插件apk是使用的回调，能够监测到插件apk的安装情况：

package com.morse.testapp;import android.content.Context;import android.util.Log;import com.qihoo360.replugin.RePluginEventCallbacks;import com.qihoo360.replugin.model.PluginInfo;/** * @Author:曾明 * @Time:2017/7/15 17:33 * @Description: */public class HostEventCallbacks extends RePluginEventCallbacks {    public HostEventCallbacks(Context context) {        super(context);    }    @Override    public void onInstallPluginSucceed(PluginInfo info) {        Log.d("morse", "onInstallPluginSucceed: Failed! info=" + info);        super.onInstallPluginSucceed(info);    }    @Override    public void onInstallPluginFailed(String path, InstallResult code) {        // FIXME 当插件安装失败时触发此逻辑。您可以在此处做“打点统计”，也可以针对安装失败情况做“特殊处理”        // 大部分可以通过RePlugin.install的返回值来判断是否成功        Log.d("morse", "onInstallPluginFailed: Failed! path=" + path + "; r=" + code);        super.onInstallPluginFailed(path, code);    }    @Override    public void onStartActivityCompleted(String plugin, String activity, boolean result) {        // FIXME 当打开Activity成功时触发此逻辑，可在这里做一些APM、打点统计等相关工作        Log.d("morse", "onStartActivityCompleted: plugin=" + plugin + "\r\n result=" + result);        super.onStartActivityCompleted(plugin, activity, result);    }}

四、启动插件，在启动插件的时候，有几个地方需要注意一下：
1、需要检测插件是否安装；
2、如果没有安装，检测本地是否下载插件；
3、没有下载插件，需要先下载插件；
4、如果没有安装插件，需要安装插件；
5、启动插件；

//检测插件是否安装PluginInfo info = MP.getPlugin("androidhelper", true);                    //未安装插件                    if (null == info) {                        //检测插件是否下载                        File file = new File("/sdcard/dht", "androidhelper.apk");                        if (!file.exists()) {                            //下载插件                            Toast.makeText(MainActivity.this, "插件不存在", Toast.LENGTH_SHORT).show();                        } else {                            //安装插件                            PluginInfo in = RePlugin.install("/sdcard/dht/androidhelper.apk");                            if (null == in) {                                Toast.makeText(MainActivity.this, "安装插件失败", Toast.LENGTH_SHORT).show();                            }                        }                        return;                    }                    //启动插件                    RePlugin.startActivity(MainActivity.this, RePlugin.createIntent("androidhelper", "com.morse.replugin.MainActivity"));

到这里，宿主集成就完成了。
插件apk的集成也差不多：
一、项目目录下的gradle配置：

// Top-level build file where you can add configuration options common to all sub-projects/modules.buildscript {    repositories {        jcenter()    }    dependencies {        classpath 'com.android.tools.build:gradle:2.3.3'        classpath 'com.qihoo360.replugin:replugin-plugin-gradle:2.1.5'        // NOTE: Do not place your application dependencies here; they belong        // in the individual module build.gradle files    }}allprojects {    repositories {        jcenter()    }}task clean(type: Delete) {    delete rootProject.buildDir}

二、app目录下的gradle配置：

apply plugin: 'com.android.application'apply plugin: 'replugin-plugin-gradle'android {    compileSdkVersion 26    buildToolsVersion "26.0.0"    defaultConfig {        applicationId "com.morse.replugin"        minSdkVersion 15        targetSdkVersion 26        versionCode 1        versionName "1.0"        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"    }    buildTypes {        release {            minifyEnabled false            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'        }    }}dependencies {    compile fileTree(dir: 'libs', include: ['*.jar'])    androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {        exclude group: 'com.android.support', module: 'support-annotations'    })    compile 'com.android.support:appcompat-v7:26.+'    compile 'com.android.support.constraint:constraint-layout:1.0.2'    testCompile 'junit:junit:4.12'    compile 'com.qihoo360.replugin:replugin-plugin-lib:2.1.5'}

三、这一步与宿主的配置不一样，宿主不需要配置清单文件，插件需要：

<?xml version="1.0" encoding="utf-8"?><manifest xmlns:android="http://schemas.android.com/apk/res/android"          package="com.morse.replugin">    <application        android:allowBackup="true"        android:icon="@mipmap/ic_launcher"        android:label="@string/app_name"        android:roundIcon="@mipmap/ic_launcher_round"        android:supportsRtl="true"        android:exported="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="com.qihoo360.plugin.name"            android:value="androidhelper" />        <meta-data            android:name="com.qihoo360.plugin.version.ver"            android:value="100" />    </application></manifest>

注意meta，name是固定的，只需要修改value就ok，还有，activity必须暴露，否则无法访问到。

好了，RePlugin的集成到这里就完成了，赶紧去试试吧。

传送门

RePlugin使用的时候，可能在控制台会打印出一下日志：

这个日志并不说明安装插件失败了，看到下面PInfo的信息就表示已经集成RePlugin成功了。

本文提供RePlugin1.X版本的集成方案，如果博友使用的是最新的RePlugin库，请移步：RePlugin 2.X使用教程