深刻解析Android-Plugin-Framework

时间 2020-11-18 标签 html 前端 android git github web 面试 api app 框架

Android-Plugin-Framework是一个Android插件化框架，用于经过动态加载的方式免安装运行插件apkhtml

最新版本: ‘com.github.limpoxe:Android-Plugin-Framework:0.0.70@aar’

此项目主要目标是为了运行非独立插件，而不是任意第三方app。

尽管此框架支持独立插件，但目标并非为了支持任意三方app，不一样于平行空间或应用分身之类的产品。非独立插件相比任意三方app来讲，能够预见到其使用了哪些系统api和特性，并且全部行为都是能够预测的。而任意三方app是不可预测的。框架的作法是按需hook，即须要用到哪些系统特性和api，就对哪些特性和api提供支持。这种作法对开发非独立插件和二方独立插件而言彻底足够。目前已经添加了对经常使用特性和api的支持，如需使用的api还未支持请联系做者。前端

FEATURE

框架透明, 插件开发与普通apk开发无异，无约定约束
支持非独立插件和独立插件(非任意三方)
支持四大组件/Application/Fragment/Accessibility/LaunchMode/so
支持插件Theme/Style,宿主Theme/Style,轻松支持基于主题属性的皮肤切换
支持插件发送Notification/时在RemoteViews中携带插件中的资源（只支持5.x及以上, 且不支持miui8）
支持插件热更新：即在插件模块已经被唤起的状况先安装新版本插件，无需重启插件进程（前提是插件高度内敛，宿主不主动持有插件中的任何对象）
支持全局服务：即插件向容器注册一个服务，其余全部插件已经宿主都获取并调用此服务
支持DataBinding（仅限独立插件）
支持插件WebView加载插件本地HTML文件
支持插件Fragment/View内嵌宿主Activity中
支持FileProvider
支持2.3-9.0

LIMIT

不支持插件Activity转场动画使用插件中的动画资源
不支持插件Manifest中申请权限，全部权限必须预埋到宿主Manifest中
不支持第三方app试图唤起插件中的组件时直接使用插件组件的Intent。第三方app要唤起插件中的静态组件，例如Activity/service/Provider，必须由宿主程序进行桥接，即此组件需同时预埋到宿主和插件的Manifest中
不支持android.app.NativeActivity
不支持当一个插件依赖另外一个插件时，被插件依赖的包含资源
不支持插件中的webview弹出原生Chrome组件 例如经过html的标签设置时间选择器。说明：是否能支持原生组件取决于系统中使用WebView的实现。若是是使用的Android System Webview，则能够支持。由于它packageId是以0x3f开头；若是是使用的Chrome Webview，则不支持。由于它packageId是以0x7f开头，会和插件冲突。这是采用Public.xml进行资源分组的缺陷。
可能不支持对插件或者宿主进行加壳加固处理，何尝试

使用方法

allprojects {
    		repositories {
    			...
    			maven { url 'https://jitpack.io' }
    		}
    }

宿主侧

一、新建一个工程，做为宿主工程android

二、在宿主工程的build.gradle文件下添加以下3个配置git

//插件脚本
    apply from: "https://raw.githubusercontent.com/limpoxe/Android-Plugin-Framework/master/FairyPlugin/host.gradle"        

    android {
        defaultConfig {
            //这个配置不可省略
            applicationId 宿主app包名        
        }
    }

dependencies {
        //请务必使用@aar结尾，以中断依赖传递
        implementation('com.github.limpoxe:Android-Plugin-Framework:0.0.70@aar')
        //可选，用于支持插件全局函数式服务，不使用全局函数式服务不须要添加此依赖
        //implementation('com.limpoxe.support:android-servicemanager:1.0.5@aar')
    }

fairy {
        //可选配置，用于指定插件进程名。默认插件进程为单独的进程，进程名为":plugin"
        //若设置为空串或者null便是使用宿主进程做为插件进程
        //pluginProcess = ""
        //pluginProcess = null
        //pluginProcess = ":xxx"
    }

三、在宿主工程中新建一个类继承自Application类, 并配置到AndroidManifest.xml中并重写这个类的下面2个方法github

@Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(base);

        //框架日志开关, 默认false
        FairyGlobal.setLogEnable(true);

        //首次加载插件会建立插件对象，比较耗时，经过弹出loading页来过渡。
        //这个方法是设置首次加载插件时, 定制loading页面的UI, 不传即默认没有loading页
        //在宿主中建立任意一个layout传进去便可
        //注意：首次唤起插件组件时，若是是经过startActivityForResult唤起的，若是配置了loading页，
        //则实际是先打开了loading页，再转到目标页面，此时会忽略ForResult的结果。这种状况下应该禁用loading页配置
        FairyGlobal.setLoadingResId(R.layout.loading);

        //是否支持插件中使用本地html, 默认false
        FairyGlobal.setLocalHtmlenable(true);

        //初始化框架
        PluginLoader.initLoader(this);
    }

@Override
    public Context getBaseContext() {
        return PluginLoader.fixBaseContextForReceiver(super.getBaseContext());
    }

四、在宿主工程中经过下面3个方法进行最基本的插件操做web

安装: PluginManagerHelper.installPlugin( SDcard上插件apk的路径 );
    卸载: PluginManagerHelper.remove( 插件packageName );
    列表: PluginManagerHelper.getPlugins();

五、经过构造一个插件组件Intent打开插件面试

例如打开插件的Launcher界面api

Intent launchIntent = getPackageManager().getLaunchIntentForPackage( 插件packageName );			
   startActivity(launchIntent);

宿主编译完成后，会在outputs/distrubites目录下生成一个名为host.bar的基线包，做为编译插件的基线。以上全部内容及更多详情能够参考Demoapp

插件侧

独立插件：框架

新建一个工程, 做为插件工程，无需任何其余配置，编译出来便可当插件apk安装到宿主中。

非独立插件：

一、新建一个工程, 做为插件工程。

二、在build.gradle中添加以下2个配置

//插件脚本
    apply from: "https://raw.githubusercontent.com/limpoxe/Android-Plugin-Framework/master/FairyPlugin/plugin.gradle"

    android {
        defaultConfig {
            //这个配置不可省略
            applicationId 插件app包名        
        }
    }

    dependencies {
        //***这是demo中的示例，请根据本身的实际状况修改，做用是指向插件依赖的宿主基线包***
        //支持文件、maven坐标等写法
        //baselinePatch 'xxx:xxx:xxx@bar'
        baselinePatch files(project(':Samples:PluginMain').getBuildDir().absolutePath + '/distributions/host.bar')
    }

完成以上2步后便可编译出非独立插件，以上全部内容及更多详情能够参考Demo

Demo编译方法

a）若是是命令行中：

cd  Android-Plugin-Framework

   ./gradlew clean

   ./gradlew :Samples:PluginMain:assembleF1Debug

   ./gradlew :Samples:PluginTesBase:assembleF1Debug

   ./gradlew assembleF1Debug

   ./gradlew :Samples:PluginMain:assembleF1Debug

   说明：因为框架、demo宿主和各个demo插件都在同一个工程下，依赖关系互相影响，所以须要必定的编译顺序才能正常运行

   第一个assembleF1Debug是为了编译宿主，产生基线bar文件

   第二个assembleF1Debug是为了编译基础插件，产生插件apk和jar，基础插件jar会被其余插件依赖

   第三个assembleF1Debug是为了编译全部插件，产生插件apk

   第四个assembleF1Debug是为了从新编译宿主，将前面编译生成的插件apk内置到宿主的assets目录中，做为内置插件使用

   接下来将宿主的out目录下的apk安装到设备上便可

b）若是是studio中：

打开studio右侧gradle面板区，点clean、点assembleDebug。不要使用菜单栏的菜单编译。

重要：

一、因为编译脚本依赖Task.doLast, 使用其余编译方法（如菜单编译）可能不会触发Task.doLast致使编译失败

    二、必须先编译宿主，再编译非独立插件。（这也是使用菜单栏编译会失败的缘由之一）
       缘由很简单，既然是非独立插件，确定是须要引用宿主的类和资源的。因此编译非独立插件时会用到编译宿主时的输出物

    三、因为宿主和插件在同一个工程中，点击assembleDebug时编译顺序不可控，会致使每次clean后，首次assembleDebug会失败，此时从新编译便可
       可能须要执行3次assembleDebug，
           第一次是编译宿主，产生bar文件，
           第二次是依赖bar编译插件，产生插件文件
           第三次是从新编译宿主，将插件文件内置到宿主assets中
        因此若是使用其余编译方法，请务必仔细阅读build.gradle，了解编译过程和依赖关系后能够自行调整编译脚本，不然可能会失败。

    四、Demo中使用了arm平台的so，若在x86平台上测试Demo可能会有so异常，请自行适配so。

待插件编译完成后，便可经过宿主在运行时下载插件apk或者将插件apk复制到sdcard调用PluginManagerHelper.installPlugin(“插件apk绝对路径”)进行插件安装。

一般插件会内置一个版本到宿主中随宿主一块儿发布，则须要将插件配置到宿主的assets目录下，再编译一次宿主（即上述3中的第三次编译）。配置方法以下：

dependencies {
        //支持坐标依赖
        //innerPlugin 'xxx:xxx:xxx@apk'
        innerPlugin '/xx/xx/xx/xx.apk'
    }

增长这个配置之后，宿主在打包时会将这个依赖的插件apk打包到宿主的assets目录中