ZeusPlugin是一个简单易懂的Android插件补丁框架。下面通过对它开发一个插件zeusplugin_hello.apk
,熟悉插件开发的流程。
前置工作
clone项目
git clone https://github.com/iReaderAndroid/ZeusPlugin
替换aapt
用ZeusPlugin项目中的aapt(位于ZeusPlugin\aapt\目录下,该aapt.exe基于6.0源码编译,包含windows、mac和linux(64位)版本。测试替换23.0.2、23.0.3都没有问题,其还集成了资源混淆功能。
),替换sdk下的aapt(请根据自己的系统,选择对应的版本!)。
sdk路径可见项目根目录文件local.properties
内容,sdk.dir=X\:\\your-android-sdk-path\\sdk
。
例如,windows系统,把ZeusPlugin\aapt\aapt(windows版).exe
替换X:\your-android-sdk-path\sdk\build-tools\23.0.2\aapt.exe
后,运行成功。
ps:可以先备份一下sdk下的aapt.exe为aapt.exe.bak。
正式开始
1. 插件配置,PluginConfig.java
文件增加以下内容:
public static final String PLUGIN_HELLO = "zeusplugin_hello"; //插件hello,新增!
static {
mDefaultList.put(PLUGIN_TEST, 1);
mDefaultList.put(PLUGIN_HELLO, 1); //插件hello,新增!
mDefaultList.put(HOTFIX_TEST, 1);
}
2. 新建插件项目hello(此处普通app一样开发调试即可)。
我们简单的,新建一个Activity为com.test.android.hello.MainActivity
,独立运行成功。
3. hello项目新建assets目录,在里面新建meta配置文件zeusplugin.meta
。
{
"name": "zeusplugin_hello",
"minVersion": "1",
"version": "1",
"mainClass": "com.test.android.hello.MainActivity"
}
4. 打包hello项目apk为zeusplugin_hello.apk
。
android studio普通开发操作,build --> build APK
。
5. 复制步骤4的zeusplugin_hello.apk
到宿主项目app的assets目录下。
6. 宿主项目app中AndroidManifest.xml
增加hello项目相关的Activity。
<!--校验用的activity,为了骗过android的activity存在校验-->
<activity android:name="com.zeus.ZeusActivityForStandard"/>
<activity android:name="com.test.android.hello.MainActivity"/>
7. 插件调用
ImageButton ib_previous = (ImageButton) findViewById(R.id.ib_previous);
ib_previous.setOnClickListener(new OnClickListener() {
public void onClick(View v) {
PluginManager.loadLastVersionPlugin(PluginConfig.PLUGIN_HELLO);//加载插件,一定记得是新增的PluginConfig.PLUGIN_HELLO
try {
Class cl = PluginManager.mNowClassLoader.loadClass(PluginManager.getPlugin(PluginConfig.PLUGIN_HELLO).getPluginMeta().mainClass);
Intent intent = new Intent(PriceActivity.this, cl);//这种方式为通过在宿主AndroidManifest.xml中预埋activity实现
//startActivity(intent);
//这种方式为通过欺骗android系统的activity存在性校验的方式实现
PluginManager.startActivity(PriceActivity.this,intent);
} catch (ClassNotFoundException e) {
e.printStackTrace();
}
}
});
最后,如果你的插件项目用到资源文件,还要修改hello项目的build.gradle
文件,添加如aaptOptions.additionalParameters '--PLUG-resoure-proguard', '--PLUG-resoure-id', '0x7d'
等配置更改资源ID(插件或补丁的资源packageID不能与其他插件或者是宿主相同
),详细看官方文档。
TODO
- 插件项目是否一定要继承
ZeusBaseActivity.java
或者调用相关函数? - 宿主、插件混淆处理?