加入CODE CHINA

· 不限速    · 不限空间    · 不限人数    · 私仓免费

免费加入
    README.md

    Android 9.0 supported! Please use the lastest release.

    VirtualAPK

    license Release Version PRs Welcome

    VirtualAPK is a powerful yet lightweight plugin framework for Android. It can dynamically load and run an APK file (we call it LoadedPlugin) seamlessly as an installed application. Developers can use any Class, Resources, Activity, Service, Receiver and Provider in LoadedPlugin as if they are registered in app's manifest file.

    VirtualAPK

    Supported Features

    Feature Detail
    Supported components Activity, Service, Receiver and Provider
    Manually register components in AndroidManifest.xml No need
    Access host app classes and resources Supported
    PendingIntent Supported
    Supported Android features Almost all features
    Compatibility Almost all devices
    Building system Gradle plugin
    Supported Android versions API Level 15+

    Getting started

    Host Project

    Add a dependency in build.gradle in root of host project as following.

    dependencies {
        classpath 'com.didi.virtualapk:gradle:0.9.8.6'
    }

    Apply plugin in application module of build.gradle.

    apply plugin: 'com.didi.virtualapk.host'

    Compile VirtualAPK in application module of build.gradle.

    compile 'com.didi.virtualapk:core:0.9.8'

    Initialize PluginManager in YourApplication::attachBaseContext().

    @Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(base);
        PluginManager.getInstance(base).init();
    }

    Modify proguard rules to keep VirtualAPK related files.

    -keep class com.didi.virtualapk.internal.VAInstrumentation { *; }
    -keep class com.didi.virtualapk.internal.PluginContentResolver { *; }
    
    -dontwarn com.didi.virtualapk.**
    -dontwarn android.**
    -keep class android.** { *; }

    Finally, load an APK and have fun!

    String pluginPath = Environment.getExternalStorageDirectory().getAbsolutePath().concat("/Test.apk");
    File plugin = new File(pluginPath);
    PluginManager.getInstance(base).loadPlugin(plugin);
    
    // Given "com.didi.virtualapk.demo" is the package name of plugin APK, 
    // and there is an activity called `MainActivity`.
    Intent intent = new Intent();
    intent.setClassName("com.didi.virtualapk.demo", "com.didi.virtualapk.demo.MainActivity");
    startActivity(intent);

    Plugin Project

    Add a dependency in build.gradle in root of plugin project as following.

    dependencies {
        classpath 'com.didi.virtualapk:gradle:0.9.8.6'
    }

    Apply plugin in application module of build.gradle.

    apply plugin: 'com.didi.virtualapk.plugin'

    Config VirtualAPK. Remember to put following lines at the end of build.gradle.

    virtualApk {
        packageId = 0x6f             // The package id of Resources.
        targetHost='source/host/app' // The path of application module in host project.
        applyHostMapping = true      // [Optional] Default value is true. 
    }

    Developer guide

    Known issues

    • Notifications with custom layout are not supported in plugin.
    • Transition animations with animation resources are not supported in plugin.

    Contributing

    Welcome to contribute by creating issues or sending pull requests. See Contributing Guide for guidelines.

    Who is using VirtualAPK?

    滴滴出行 Uber中国

    License

    VirtualAPK is licensed under the Apache License 2.0. See the LICENSE file.

    项目简介

    A powerful and lightweight plugin framework for Android

    发行版本

    当前项目没有发行版本

    贡献者 10

    开发语言

    • Java 64.6 %
    • Groovy 35.4 %
    • Shell 0.0 %