腾讯插件化框架shadow

前阵子使用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

直接使用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动态命令。

damo仅供参考欢迎讨论