RePlugin主程序接入

官方GitHub Wiki《主程序接入指南》

只需三步,就能让您的“主程序”接入RePlugin:

第 1 步:添加 RePlugin Host Gradle 依赖

在项目根目录的 build.gradle(注意:不是 app/build.gradle) 中添加 replugin-host-gradle 依赖:

buildscript {
    dependencies {
        classpath 'com.qihoo360.replugin:replugin-host-gradle:2.1.0'
        ...
    }
}

第 2 步:添加 RePlugin Host Library 依赖

在 app/build.gradle 中应用 replugin-host-gradle 插件,并添加 replugin-host-lib 依赖:

apply plugin: 'replugin-host-gradle'

dependencies {
    compile 'com.qihoo360.replugin:replugin-host-lib:2.1.0'
    ...
}

第 3 步:配置 Application 类

让工程的 Application 直接继承自 RePluginApplication。

如果您的工程已有Application类,则可以将基类切换到RePluginApplication即可。或者您也可以用“非继承式”接入。

public class MainApplication extends RePluginApplication {
}

既然声明了Application,自然还需要在AndroidManifest中配置这个Application。

    ".MainApplication"
        ... />

备选:“非继承式”配置Application

若您的应用对Application类继承关系的修改有限制,或想自定义RePlugin加载过程(慎用!),则可以直接调用相关方法来使用RePlugin。

public class MainApplication extends Application {

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

        RePlugin.App.attachBaseContext(this);
        ....
    }

    @Override
    public void onCreate() {
        super.onCreate();

        RePlugin.App.onCreate();
        ....
    }

    @Override
    public void onLowMemory() {
        super.onLowMemory();

        /* Not need to be called if your application's minSdkVersion > = 14 */
        RePlugin.App.onLowMemory();
        ....
    }

    @Override
    public void onTrimMemory(int level) {
        super.onTrimMemory(level);

        /* Not need to be called if your application's minSdkVersion > = 14 */
        RePlugin.App.onTrimMemory(level);
        ....
    }

    @Override
    public void onConfigurationChanged(Configuration config) {
        super.onConfigurationChanged(config);

        /* Not need to be called if your application's minSdkVersion > = 14 */
        RePlugin.App.onConfigurationChanged(config);
        ....
    }
}

针对“非继承式”的注意点

  • 所有方法必须在UI线程来“同步”调用。切勿放到工作线程,或者通过post方法来执行
  • 所有方法必须一一对应,例如 RePlugin.App.attachBaseContext 方法只在Application.attachBaseContext中调用
  • 请将RePlugin.App的调用方法,放在“仅次于super.xxx()”方法的后面

实际接入过程中碰到的问题

1.下载RePlugin依赖包出错:

D:\jeff_workspace\TestRePlugin\app\build.gradle
Error:(33, 13) Failed to resolve: com.qihoo360.replugin:replugin-host-lib:2.1.0

解决过程:查看官方Sample源码中的build.gradle发现问题所在,需要在project下的build.gradle文件中添加以下代码:

//buildscript repositories以及allprojects repositories中添加RePlugin Repository
maven {
    url  "https://dl.bintray.com/qihoo360/replugin"
}
  1. Gradle构建出现以下错误:
Execution failed for task ':app:processDebugResources'.
> D:\jeff_workspace\TestRePlugin\app\src\main\assets\plugins

解决过程:在Github Issues中发现#48也提到了这个问题,解决办法在里面已经给出:

在 assets 下新建文件夹 plugins

你可能感兴趣的:(RePlugin)