美文网首页基础架构知识
腾讯插件化框架shadow

腾讯插件化框架shadow

作者: 淼素 | 来源:发表于2022-08-09 17:43 被阅读0次

    前阵子使用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动态命令。

    damo仅供参考和讨论

    相关文章

      网友评论

        本文标题:腾讯插件化框架shadow

        本文链接:https://www.haomeiwen.com/subject/lwcdirtx.html