Skip to content

zhangyuChen1991/ShadowSample

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 

Repository files navigation

ShadowSample

使用腾讯Shadow实现插件化的Demo

下面记录一下接入流程和遇到的问题,方便以后查看。

结构

整个Demo由3个工程构成,分别是宿主App,插件管理App,插件App,三个工程相互完全独立。

|--HostApp //宿主
|
|--PluginManager  //负责加载插件,管理插件
|
|--BusinessApp  //插件app
   |--plugin-app  //业务app
   |--sample-loader  //配置了插件Activity到壳Activity的对应关系等
   |--sample-runtime  //定义了宿主中占位的Activity等

Shadow主要接入流程

  1. Clone Shadow的代码 Shdow Github地址,然后编译,上传本地maven库或者远程maven库,以便后续应用,不建议直接引用sdk代码,里面的库分很多块,三个工程各自需要引用的模块不一样,操作不方便,用maven可以分别按需引用。
  2. 参照腾讯Shadow的Sample中Maven下面的sample(结构也是一样的三个工程),分别创建工程,引用相应的库,实现必要的接口(占位的Activity、Service,插件管理类等),分别编译通过。
  3. PluginManager编译之后生成apk文件,BusinessApp编译之后生成一个zip包,需要将他们分别放到宿主指定的文件目录之下,让宿主能够加载到。

BusinessApp编译用如下命令: gradlew packageDebugPlugin
放文件的位置是宿主中配置的,pluginManager的apk存放位置在初始化管理类的时候定义的,关键代码是 FixedPathPmUpdater fixedPathPmUpdater = new FixedPathPmUpdater(new File(PLUGIN_MANAGER_APK_FILE_PATH)); 插件zip包的位置可以在启动插件四大组件的时候传: bundle.putString("plugin_path", "/data/local/tmp/plugin-debug.zip"); 也可以直接在PluginManager中硬编码: InstalledPlugin installedPlugin = installPlugin(pluginZipPath, null, true); 在PluginManager里面根据part_key来判断是哪个插件,然后直接判断出地址要方便一些

  1. 安装宿主App,测试是否可以加载插件app的页面、服务等。

==第二步的步骤很多==,可以参考这里

小注意点:
  1. 插件的包名和宿主的包名要一致
  2. 有一些类要求路径和类名是固定的,像loader里面的CoreLoaderFactoryImpl,写的时候要注意,弄错了很难排查问题。
  3. 占位的activity在宿主的manifest里面注册,在插件的runtime里面声明,在插件的loader里面写对应关系,类似这些地方要注意,包类名要对应上,不要写错
遇到问题:

1.实际按照这个博客做的时候,最后从宿主App跳到插件的时候报了如下错,

java.lang.ClassCastException: Cannot cast androidx.core.app.CoreComponentFactory to com.tencent.shadow.core.runtime.ShadowAppComponentFactory

没能找到具体原因,最后重新建了一个BusinessApp工程引入官方demo中Maven下面的Plugin-project,改了相关的配置,然后才测试通过的;

2.在插件的app配置时,业务app的build.gradle配置loader和runtime的apk路径已经插件模块的partKey等信息的时候,报了apkName无法识别的错误,没有解决,最后注释了这一行,后面也能测试通过,暂时不知道还有什么影响。

shadow {
    packagePlugin {
        pluginTypes {
            debug {
                loaderApkConfig = new Tuple2('sample-loader-debug.apk', ':sample-loader:assembleDebug')
                runtimeApkConfig = new Tuple2('sample-runtime-debug.apk', ':sample-runtime:assembleDebug')
                pluginApks {
                    pluginApk1 {
                        businessName = 'my-plugin'
//businessName相同的插件,context获取的Dir是相同的。businessName留空,表示和宿主相同业务,直接使用宿主的Dir。
                        partKey = 'my-plugin'
                        buildTask = 'assemblePluginDebug'
//                        apkName = 'plugin-app-plugin-debug.apk'
                        apkPath = 'plugin-app/build/outputs/apk/plugin/debug/plugin-app-plugin-debug.apk'
                    }
                }
            }

            release {
                loaderApkConfig = new Tuple2('sample-loader-release.apk', ':sample-loader:assembleRelease')
                runtimeApkConfig = new Tuple2('sample-runtime-release.apk', ':sample-runtime:assembleRelease')
                pluginApks {
                    pluginApk1 {
                        businessName = 'my-plugin'
                        partKey = 'my-plugin'
                        buildTask = 'assemblePluginRelease'
//                        apkName = 'plugin-app-plugin-release.apk'
                        apkPath = 'plugin-app/build/outputs/apk/plugin/release/plugin-app-plugin-release.apk'
                    }
                }
            }
        }

        loaderApkProjectPath = 'sample-loader'

        runtimeApkProjectPath = 'sample-runtime'

        version = 4
        compactVersion = [1, 2, 3]
        uuidNickName = "1.1.5"
    }
}

About

使用腾讯Shadow实现插件化的Demo

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published