前阵子使用shadow，文档无敌少，就那么几篇，还有很多收费的，只能和源码issue较劲，今天写一个入门damo，记录一下。
准备工作
1.腾讯开源的Shadow开源的插件化框架https://github.com/Tencent/Shadow。
因为文档非常缺乏，看源码，看示例，看issue，写测试，出问题，看源码，看issue...无限循环，这是我使用时的主要感受。所以先把源码下载下来再说。
2.搭建一个maven仓库，发布sdk，有现成的仓库更好
2.1.Nexus下载地址https://help.sonatype.com/repomanager3/product-information/download
2.2 安装
3.x的Nexus搭建就是傻瓜式的，百度一下就好，不在详细说明
2.3 修改源码maven.gradle文件配置
2.3.1修改maven.gradle文件，知道maven上传的自行修改，不知道的看下面或者自己百度。
2.3.2publicationVersion版本号，每次上传都要修改，基本不修改或者不更新是一次就够了。
2.3.3coreGroupId和dynamicGroupId看你喜好，引用的包名，会影响到gradle引用，开始可以直接使用腾讯的包名，后面可以发版在修改。
2.3.4修改repositories内的参数。直接替换成自己的仓库地址，用户名之类的
def NEXUS_USERNAME = "用户名" //
def NEXUS_PASSWORD = "密码" //
maven {
allowInsecureProtocol true
name = "shadow"
credentials {
username = NEXUS_USERNAME
password = NEXUS_PASSWORD
}
//仓库地址
url "http://*.*.*.*:8081/repository/maven-releases/"
}
2.4发布sdk
![]()
上传.png
直接使用as上传可以避免环境变量导致的各种问题。只要你as能编译成功，基本上传没问题。
在pom文件里面有引用的名称和版本号，可以直接在这里查看。
引用
implementation "com.******.shadow.core:common:${showversion}"
implementation "com.******.shadow.dynamic:host:${showversion}"
implementation "com.******.shadow.dynamic:host-multi-loader-ext:${showversion}"
3 开始看源码
源码demo的位置https://github.com/Tencent/Shadow/tree/master/projects/sample。
自己照着作者提供的demo跑一边。
4 多个插件打包
我写的demo地址https://github.com/anxiao521/testshadowplugin
作者的多插件打包，都在一个压缩包里面，但是我们的需求是完全独立的。
首先还是按照上面上传代码库，我这里做了一下修改。主要解决gradle7.1.1打包apk会在intermediates文件夹下，sdk是在outputs找的，会出现找不到apk的情况
ShadowPluginHelper类的loaderFile改掉
// val loaderFile = File(
// "${project.rootDir}" +
// "/${extension.loaderApkProjectPath}/build/outputs/apk/$loaderFileParent/$loaderApkName"
// )
val loaderFile = File(
"${project.rootDir}" +
"/${extension.loaderApkProjectPath}/$loaderFileParent/$loaderApkName"
)
pluginApk.gradle代码
apply plugin: 'com.tencent.shadow.plugin'
shadow {
transform {
// useHostContext = ['abc']
}
packagePlugin {
pluginTypes {
debug {
loaderApkConfig = new Tuple2('xatestloader-debug.apk', ':xatestloader:assembleDebug')
runtimeApkConfig = new Tuple2('xa-runtime-debug.apk', ':xa-runtime:assembleDebug')
pluginApks {
pluginApk1 {
businessName =project.ext["businessName"]
partKey = project.ext['partKey']
buildTask =project.ext[ 'buildTaskDebug']
apkPath = project.ext['apkPathDebug']
hostWhiteList = ["com.tj.host_connector"]
uuid=project.ext["uuid"]
}
}
}
release {
loaderApkConfig = new Tuple2('xatestloader-release.apk', ':xatestloader:assembleRelease')
runtimeApkConfig = new Tuple2('xa-runtime-release.apk', ':xa-runtime:assembleRelease')
pluginApks {
pluginApk1 {
businessName =project.ext["businessName"]
partKey = project.ext['partKey']
buildTask =project.ext['buildTaskRelease']
apkPath = project.ext['apkPathRelease']
hostWhiteList = ["com.tj.host_connector"]
uuid=project.ext["uuid"]
}
}
}
}
loaderApkProjectPath = 'xatestloader/build/intermediates/apk/'
runtimeApkProjectPath = 'xa-runtime/build/intermediates/apk/'
archiveSuffix = project.ext["archiveSuffix"]?: ""
archivePrefix = project.ext["archivePrefix"]
destinationDir = "${getRootProject().getBuildDir()}"
version = project.ext["version"]
compactVersion = [1, 2, 3]
uuidNickName = project.ext["uuidNickName"]
}
}
pluginApk.gradle代码的使用位置查看plugin1的gradle
project.ext.uuid = "123456789a"
project.ext.archiveSuffix = "1"
project.ext.archivePrefix = "plugin"
project.ext.version = 3
project.ext.uuidNickName = "1.1.5"
project.ext.apkPathDebug = "plugin1/build/intermediates/apk/plugin/debug/plugin1-plugin-debug.apk"
project.ext.apkPathRelease = "plugin1/build/intermediates/apk/plugin/release/plugin1-plugin-release.apk"
project.ext.businessName = "plugin1"
project.ext.partKey = "plugin1"
project.ext.buildTaskDebug = ":plugin1:assemblePluginDebug"
project.ext.buildTaskRelease = ":plugin1:assemblePluginRelease"
apply from: "${project.rootDir}/pluginApk.gradle"
其他的插件的写法基本上和shadow提供的一样，我的只是拆出了，相对看的简单。
SampleComponentManager可能修改的地方在
/**
* xa-runtime模块中定义的壳子Activity，需要在宿主AndroidManifest.xml注册
*/
private static final String DEFAULT_ACTIVITY = "com.xa.xa_runtime.PluginDefaultProxyActivity";
private static final String SINGLE_INSTANCE_ACTIVITY = "com.xa.xa_runtime.PluginSingleInstance1ProxyActivity";
private static final String SINGLE_TASK_ACTIVITY = "com.xa.xa_runtime.PluginSingleTask1ProxyActivity";
/**
* 配置插件Activity 到 壳子Activity的对应关系
*
* @param pluginActivity 插件Activity
* @return 壳子Activity
*/
@Override
public ComponentName onBindContainerActivity(ComponentName pluginActivity) {
//参数是全路径，主要对应非默认开启模式的activity，singletask需要单独对应activity
//pluginActivity.getClassName()==com.xa.plugin1.MainActivity
switch (pluginActivity.getClassName()) {
/**
* 这里配置对应的对应关系
*/
}
return new ComponentName(context, DEFAULT_ACTIVITY);
}
插件打包的as上选择对应插件，双击即可在最外成的build中生成。
我这样的写法是，一个插件包（插件apk+独立的runtime+独立的loader）对应一个manager，对应一个单独的进程pps。这样不会出一堆莫莫名其妙的问题。感觉shadow设计上就是一一对应的。所以如果没有预留的pps，像我这样网络配置插件显示的，增加插件就要更新宿主。所以可以在宿主预留一堆pps。这样写插件就完全独立了。不用考虑更新后影响其他组件，坏处就是交互能力降低了，包的体积会变大，插件会重复打包一些东西，反正我觉得插件和插件既然是能完全独立运行的为啥会交互，主要是简单。
5 宿主界面显示多个不同插件提供的view
最后提供一个只返回view实现的方法，因为最后我们的程序做成了一个类似桌面的东西，通过后台发布布局信息，显示不同的插件view。
参考的源码damo.的dynamic-apk
模块是pluginview模块。
加载类在宿主模块主要看 ViewImplLoader和DynamicPluginViewManager。
为了尽量简单，直接在宿主的mainactivity中加载实现的。我们是通过Manager.apk做了一次回调返回的宿主，仅供参考和学习。注意：插件不支持四大组件的实现，仅支持view或者数据提供。现在android壳流行的情况下，可以通过这样的方法提供对h5的动态数据插件。上次讨论发现确实有公司是用这种方法提供的h5的js动态命令。
