RePlugin/README.md

   

RePlugin开源进入倒计时，今日开源！

首先非常感谢您们关注RePlugin，在前几天还没有彻底开源的前提下，能达到如此多的Star，300多个Watching，以及很多业内人士的关注，这些都出乎我们所料。在此非常感谢您们的支持！

为此，我们郑重宣布：就在今天！RePlugin在6月30日，将彻底开源！

而且我们还要补充一点：我们“绝不搞内测”，而是直接开源上线（版本是2.1.0，而非Pre版）。您们拿到的，就是这些亿级别App在用的，经过了多年验证的。

再次感谢，希望大家能一如既往的支持RePlugin，无论是加Star，还是提Issue，还是未来提PR，我们都非常的欢迎。

让“全面插件化”（无论大小项目均可使用，稳定与灵活兼得）时代，因RePlugin和您的出现，而更加精彩！

---

RePlugin是一套完整的、稳定的、适合全面使用的，占坑类插件化方案。其主要优势有：

• 极其灵活：主程序无需升级（无需在Manifest中预埋组件），即可支持新增的四大组件，甚至全新的插件
• 非常稳定：Hook点仅有一处（ClassLoader）。其崩溃率仅为“万分之一”，并完美兼容市面上近乎所有的Android ROM
• 特性丰富：支持近乎所有在“单品”开发时的特性。包括静态Receiver、Task-Affinity坑位、自定义Theme、进程坑位、AppCompat、DataBinding等
• 易于集成：无论插件还是主程序，只需“数行”就能完成接入
• 进程任意：可让各组件跑在UI、常驻，甚至是“任意坑位进程”
• 自由隔离：想隔离就隔离（如不稳定或占资源的插件，易于释放），不想隔离的模块就混用（如各种基础、UI插件，都跑在UI进程内，性能优异）
• 管理成熟：拥有成熟稳定的“插件管理方案”，支持插件安装、升级、卸载、版本管理，甚至包括进程通讯、协议版本、安全校验等
• 数亿支撑：有360手机卫士庞大的数亿用户做支撑，三年多的残酷验证，确保App用到的方案是最稳定、最适合使用的

支持的特性

特性	描述
支持的组件	Activity, Service, Receiver, Provider, Application
新组件无需修改主程序Manifest	支持
支持Android特性	近乎所有特性
插件类型	自带插件（自动识别）、外置插件
TaskAffinity	完美支持（独创坑位方案）
多进程任意分配	支持（静态和动态均可）
插件间耦合	支持Binder、ClassLoader、资源等
自定义Theme	支持
AppComat	支持
DataBinding	支持
SO库随心用	支持
高级进程间通信	支持
跨插件资源	支持
安全校验	支持（毕竟是安全公司嘛）
PendingIntent	支持
首页也能变插件	支持
Hook点	仅一个
兼容性	几乎所有的设备
支持的android版本	API Level 9+ （2.3及以上）

截止2017年6月底，RePlugin的：

特性	描述
插件数	103个
核心插件	57个
插件占应用比	高达83%
年发版次数	高达596次
平均每日发版次数	2~3次
崩溃率	万分之一（0.01%）
时间	2014年，3年验证

目前360公司几乎所有的亿级用户量的APP，以及多款主流第三方APP，都采用了RePlugin方案。

有关RePlugin的详细介绍，请点击这里阅读《RePlugin 官方 WiKi》。

愿景

让插件化能飞入寻常应用家，做到稳定、灵活、自由，大小项目兼用。

使用方法

RePlugin的使用方法非常简单，大部分情况下和“单品”开发无异。

若您是第一次接触RePlugin，则请点击这里阅读《快速上手》，跟随我们的指引，了解更多的内容。

若您想了解更多有关RePlugin的玩法，则请点击这里阅读《详细教程》，了解更多好玩的玩法。

若您想看下RePlugin的Sample工程，进而了解框架的具体用法，则请点击这里查看Sample源代码。

常见问题

以下针对在Issue中提到的“最常见问题”做出回答，希望能对您有帮助。

Q：您们和360之前发的DroidPlugin的主要区别是什么？

A： 其实最主要的技术区别就一个：Hook点的多少。

DroidPlugin要Hook的点非常多，好处是可以让APK“直接运行在主程序中”，但代价是失去了一定的稳定性（这点非常关键）。

相反，RePlugin只Hook了ClassLoader，所以极为稳定，且同样支持绝大多数单品的特性。而APK只需要通过我们的Gradle编译，无需开发者修改Java Code，即可运行在主程序中。但出于稳定性考虑，我们不支持（也不打算支持）“直接将APK，不经修改就放到主程序中”。

当然，还有一点，就是使用场景的不同：

DroidPlugin解决的是各个独立功能拼装在一起，能够快速发布，不需要有任何的交互。目前市面上的一些双开应用，和DroidPlugin的思路有共同之处。当然了，要做到完整的双开，则仍需要大量的修改，如Native Hook等。

RePlugin解决的是各个功能模块能独立升级，又能需要和宿主之间有一定交互。其宗旨是“允许插件少量修改，来换得最佳稳定和灵活”。

另外在项目启动时间上，RePlugin最早是2014年中旬用于360手机卫士（完整占坑类方案），DroidPlugin是2015年下旬用于360手机助手。

Q：您们是否支持DataBinding？

A： 支持。我们有几个插件在用。除此之外，我们的Sample工程，其Demo2就是用DataBinding做的，而Demo1是ButterKnife。您们可以体验一下。

Q：插件可以复用主程序的资源吗？

A： 可以的，RePlugin会同时把Host和Plugin的Context传递给插件，供开发者选择。

这块儿后续我们还会有文章来专门介绍，敬请期待。

已接入RePlugin的应用

我们诚挚期待您成为咱们RePlugin应用大家庭中的一员！

除了360集团旗下的亿级别应用，还有一些对稳定要求极其严苛的“金融类”产品，及第三方应用，也接入了RePlugin（目前为SDK）：

[360手机卫士]	[360手机助手]	[360安全浏览器]	[花椒相机]	[清理大师]
[360影视大全]	[借钱吧]	[借了吗]	[海淘一号]	[华润通]
[360OS app]	[360借条]	[你的app]	[你的app]	[你的app]

其中，360手机助手App——即DroidPlugin的创始团队的应用——，现已“全面切换到RePlugin”上。

这里衷心感谢 “360手机助手”，以及其它各App团队成员，帮助我们发现了很多需要改进的地方，并给予了非常积极的反馈。您们的鼓励与支持，让咱们的RePlugin能走的更远、更好！

// TODO 说好的图和链接呢？稍安勿躁

已接入RePlugin的插件

目前已有的插件，可以分为以下几类，供各App开发者参考：

• 展示插件：如卫士首页（是的，你没看错）、体检、信息流等
• 业务插件：如清理、骚扰拦截、悬浮窗等
• 合作插件：如程序锁、免费WiFi、安全桌面等
• 后台插件：如Push、服务管理、Protobuf等
• 基础插件：如安全WebView、分享、定位等

截止2017年6月底，这样的插件，我们有103个。衷心希望您能成为这个数字中的新的一员！

贡献自己的力量

我们欢迎任何形式的贡献，并致以诚挚的感谢！

你可以贡献代码、提出问题、编写文档等。有关“贡献”相关的内容，请点击这里阅读《贡献力量》

License

RePlugin is Apache v2.0 licensed.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.