iqiyi
Neptune
Java

A flexible, powerful and lightweight plugin framework for Android

Last updated May 31, 2026
762
Stars
113
Forks
11
Issues
0
Stars/day
Attention Score
54
Language breakdown
Java 81.7%
Groovy 18.3%
β–Έ Files click to expand
README

Neptune

license Release Version PRs Welcome

Neptune is a flexible, powerful and lightweight plugin framework for Android.

It now runs plugins dynamically on billions of devices every day and carries many separated business modules of IQIYI such as Reader, Movie Tickets and etc..

Especially, Neptune is greatly compatible with Android P . It can run on Android P devices seamlessly and stably. Only few APIs in light greylist are used.

δΈ­ζ–‡ζ–‡ζ‘£

Supported Features

| Feature | Detail | | :------ | :-----: | | Supported Components | Activity/Service/Receiver | | Component registration in Host Manifest.xml | No Need | | Share Host App Class | Supported | | Share Host App Resources | Supported | | Resources Isolation | Supported | | Run individual App | Supported | | Android Features | Almost all features | | Compatibility | Almost all roms | | Process Isolation | Supported | | Plugin Dependency | Supported | | Plugin Development | like normal app | | Supported Android versions | API Level 14+ |

Architecture

plugin</em>arch

Getting Started

Host Project

compile Neptune in application module of build.gradle.

implementation 'org.qiyi.video:neptune:2.7.0'

Initialize sdk in your Application#onCreate().

public class XXXApplication extends Application {
    
    @Override
    public void onCreate() {
        NeptuneConfig config = new NeptuneConfig.NeptuneConfigBuilder()
                    .configSdkMode(NeptuneConfig.INSTRUMENTATION_MODE)
                    .enableDebug(BuildConfig.DEBUG)
                    .build();
        Neptune.init(this, config);
    }
}

more details and developer guide see wiki

Plugin Project

If plugin app wants to share resources with host app, you need add dependency in the buildscript block of build.gradle in root of plugin project as following.

dependencies {
    classpath  'com.iqiyi.tools.build:neptune-gradle:1.4.0'
}

Apply gradle plugin in application module of build.gradle and config it.

apply plugin: 'com.qiyi.neptune.plugin'

neptune { pluginMode = true // In plugin apk build mode packageId = 0x30 // The package id of Resources hostDependencies = "{group1}:{artifact1};{group2}:{artifact2}" // host app resources dependencies }

Developer Guide

Contribution

We sincerely appreciate your PR contribution of any kind , including codes, suggestions or documentation to improve our project.

License

Neptune is Apache v2.0 Licensed.

Β© 2026 GitRepoTrend Β· iqiyi/Neptune Β· Updated daily from GitHub