RePlugin插件接入指南

只需两步，就能让您的App变成“RePlugin插件”：

有关“混淆”

RePlugin的AAR自带Proguard文件，您无需关心，直接引入AAR即可生效。此外，其内部仅Keep了关键的接口类，大部分都是允许被混淆的，故对应用来说也没有影响。

第 1 步：添加 RePlugin Plugin Gradle 依赖

在项目根目录的 build.gradle（注意：不是 app/build.gradle）中添加 replugin-plugin-gradle 依赖：

buildscript {dependencies {classpath 'com.qihoo360.replugin:replugin-plugin-gradle:2.2.4'...}
}

第 2 步：添加 RePlugin Plugin Library 依赖

在 app/build.gradle 中应用 replugin-plugin-gradle 插件，并添加 replugin-plugin-lib 依赖:

apply plugin: 'replugin-plugin-gradle'dependencies {compile 'com.qihoo360.replugin:replugin-plugin-lib:2.2.4'...
}

接下来

接下来您就可以像单品那样，开发您的插件。生成出来的是APK，既可以“安装到设备”，又可以“作为插件”使用。

如果您想进一步了解如何开发插件，请移步到详细教程，了解更多玩法。

宿主调试

cundong edited this page on 24 Feb · 8 revisions

本文来讲述如何“利用神奇的host-gradle”来实现插件的快速安装、快速调试等。

1.环境配置

1.1仓库配置

buildscript {

repositories {jcenter()}dependencies {classpath 'com.qihoo360.replugin:replugin-host-gradle:2.2.4'}

}

1.2插件使用配置

（这个apply plugin尽量放在android配置之后吧，因为可以自动读取android中的配置项，方便以后升级。简单的说，就是放在你build.gradle文件末尾即可）

apply plugin: 'replugin-host-gradle'

// If use AppCompat, open the useAppCompat repluginHostConfig { useAppCompat = true }

2.插件的Gradle任务

2.1 rpGenerateDebugBuiltinJson或rpGenerateReleaseBuiltinJson等

生成内置插件的配置文件（一般很少使用，编译时会自动处理）

2.2 rpGenerateDebugHostConfig或rpGenerateReleaseHostConfig等

生成插件们的坑位配置文件（一般很少使用，编译时会自动处理）

2.3 rpShowPluginsDebug和rpShowPluginsRelease等

查看所有内置插件的信息

插件调试

cundong edited this page on 24 Feb · 8 revisions

本文来讲述如何“利用神奇的plugin-gradle”来实现插件的快速安装、快速调试等。

1.环境配置

1.1仓库配置

buildscript {

repositories {jcenter()}dependencies {classpath 'com.qihoo360.replugin:replugin-plugin-gradle:2.2.4'}

}

1.2插件使用配置

（这个apply plugin需要放在android配置之后，因为需要读取android中的配置项。简单的说，就是放在你build.gradle文件末尾即可）

apply plugin: 'replugin-plugin-gradle'

repluginPluginConfig {

//插件名
pluginName = "demo3"
//宿主app的包名
hostApplicationId = "com.qihoo360.replugin.sample.host"
//宿主app的启动activity
hostAppLauncherActivity = "com.qihoo360.replugin.sample.host.MainActivity"

}

2.插件的Gradle任务

一些Gradle任务依赖宿主中添加 RePlugin.enableDebugger(base, BuildConfig.DEBUG); 这行代码

2.1 rpForceStopHostApp

强制停止宿主程序

2.2 rpInstallAndRunPluginDebug或rpInstallAndRunPluginRelease等

安装插件到宿主并运行（常用任务）

2.3 rpInstallPluginDebug或rpInstallPluginRelease等

仅仅安装插件到宿主

2.4 rpRestartHostApp

重启宿主程序

2.5 rpRunPluginDebug或rpRunPluginRelease等

仅仅运行插件，如果插件前面没安装，则执行不成功

2.6 rpStartHostApp

启动宿主程序

2.7 rpUninstallPluginDebug或rpUninstallPluginRelease

仅仅卸载插件，如果完全卸载，还需要执行rpRestartHostApp任务

RePlugin Sample

RePlugin Sample工程主要为您展现RePlugin插件的主要用法。

它并非是“纯粹”的工程，其内部包含了大量可供参考的调用代码，并含有一些测试代码，帮助开发者在接入时能够对RePlugin有所了解。

包括下列内容：

host → 主程序的Sample
plugin-demo1 → 插件1Sample，大部分逻辑都在其中（内置插件实例）
plugin-demo2 → 插件2的Sample，主要是配合插件1而做的工作（内置插件实例）
plugin-demo3-kotlin → 插件3的Sample，kotlin插件实例（外置插件实例）

阅读Sample代码需要和RePlugin的用法相结合。请访问我们的WiKi，以了解更多的内容。