前阵子使用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能编译成功,基本上传没问题。
image.png
在pom文件里面有引用的名称和版本号,可以直接在这里查看。
微信截图_20220810170229.png
引用
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中生成。
10.png
我这样的写法是,一个插件包(插件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动态命令。
网友评论