Android-Plugin-Framework

README: 中文

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

最新版本: 'com.github.limpoxe:Android-Plugin-Framework:[email protected]'

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

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

FEATURE

LIMIT

HOW TO USE

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

宿主侧

1、 新建一个工程,作为宿主工程

2、 在宿主工程的build.gradle文件下添加如下3个配置

    //插件脚本
    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:[email protected]')
        //可选,用于支持插件全局函数式服务,不使用全局函数式服务不需要添加此依赖
        //implementation('com.limpoxe.support:android-servicemanager:[email protected]')
    }
    fairy {
        //可选配置,用于指定插件进程名。默认插件进程为单独的进程,进程名为":plugin"
        //若设置为空串或者null即是使用宿主进程作为插件进程
        //pluginProcess = ""
        //pluginProcess = null
        //pluginProcess = ":xxx"
    }

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

    @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());
    }

4、在宿主工程中通过下面3个方法进行最基本的插件操作

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

5、通过构造一个插件组件Intent打开插件

例如打开插件的Launcher界面

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

宿主编译完成后,会在outputs/distrubites目录下生成一个名为host.bar的基线包,作为编译插件的基线。 以上所有内容及更多详情可以参考Demo

插件侧  

独立插件:

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

非独立插件:

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

2、在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:[email protected]'
        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。不要使用菜单栏的菜单编译。

重要:

    1、由于编译脚本依赖Task.doLast, 使用其他编译方法(如菜单编译)可能不会触发Task.doLast导致编译失败

    2、必须先编译宿主,再编译非独立插件。(这也是使用菜单栏编译会失败的原因之一)
       原因很简单,既然是非独立插件,肯定是需要引用宿主的类和资源的。所以编译非独立插件时会用到编译宿主时的输出物

    3、由于宿主和插件在同一个工程中,点击assembleDebug时编译顺序不可控,会导致每次clean后,首次assembleDebug会失败,此时重新编译即可
       可能需要执行3次assembleDebug,
           第一次是编译宿主,产生bar文件,
           第二次是依赖bar编译插件,产生插件文件
           第三次是重新编译宿主,将插件文件内置到宿主assets中
        所以如果使用其他编译方法,请务必仔细阅读build.gradle,了解编译过程和依赖关系后可以自行调整编译脚本,否则可能会失败。

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

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

通常插件会内置一个版本到宿主中随宿主一起发布,则需要将插件配置到宿主的assets目录下,再编译一次宿主(即上述3中的第三次编译)。 配置方法如下:

    dependencies {
        //支持坐标依赖
        //innerPlugin 'xxx:xxx:[email protected]'
        innerPlugin '/xx/xx/xx/xx.apk'
    }

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

其他

  1. 使用指南
  2. 原理简介
  3. 使用Public.xml的坑和填坑.
  4. 更新记录

联系作者:

Q:15871365851,添加时请注明插件开发

Q群:116993004,重要:添加前请务必仔细阅读此ReadMe!请务必仔细阅读Demo!