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 useAppCompat
repluginHostConfig {
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使用教程