https://github.com/droidpluginteam/droidplugin

A plugin framework on android,Run any third-party apk without installation, modification or repackage
https://github.com/droidpluginteam/droidplugin

android droid-plugin hook plugin pluginframework virtualization

Last synced: about 1 month ago
JSON representation

A plugin framework on android,Run any third-party apk without installation, modification or repackage

• Host: GitHub
• URL: https://github.com/droidpluginteam/droidplugin
• Owner: DroidPluginTeam
• License: lgpl-3.0
• Created: 2015-08-27T11:14:57.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2024-06-06T02:32:38.000Z (5 months ago)
• Last Synced: 2024-10-15T06:25:19.991Z (about 1 month ago)
• Topics: android, droid-plugin, hook, plugin, pluginframework, virtualization
• Language: Java
• Homepage: http://droidpluginteam.github.io/DroidPlugin/
• Size: 1.77 MB
• Stars: 6,901
• Watchers: 504
• Forks: 2,530
• Open Issues: 227
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Droid Plugin

======

[中文文档](readme_cn.md "中文文档")

[Fllow me at github](https://github.com/cmzy)

DroidPlugin is a new **Plugin Framework** developed and maintained by Andy Zhang( [Fllow me at github](https://github.com/cmzy) ).

It enables the host app run any third-party apk without installation, modification and repackage, which benefit a lot for collaborative development on Android.

-------

## Problems to be solved:

    

 1. Unable to send `Notification` with custom Resources，eg：

 

     a.  Notification with custom RemoteLayout, which means `Notification`'s `contentView`，`tickerView`，

     `bigContentView` and `headsUpContentView` must be null.

     b.  Notification with icon customized by R.drawable.XXX. The framework will transform it to Bitmap instead.

 2. Unable to define specified `Intent Filter` for the plugged app's `Service`、`Activity`、`BroadcastReceiver`

 and `ContentProvider`. So the plugged app is invisible for the outside system and app.

 3. Lack of `Hook` to the `Native` layer, thus apk (e.g. a majority of game apps) with `native` code cannot be loaded as plugin.

    

## Features：

  1. Compatible to Android 2.3 and later versions

  2. Given its .apk file, the plugged app could be run either independently or as plugin of the host, **NO** source code needed.

  3. Unnecessary to register the plugged app's `Service`、`Activity`、`BroadcastReceiver`、`ContentProvider` in the host.

  4. The plugged app are recognized as *Installed* by the host and other plugged apps

  5. Very low level of code invasion, in deed just one line code to integrate DroidPlugin into the host app.

  6. Complete code level separation between host and plugged apps, only system level message passing method provide by Android allowed.

  7. All system API supported

  8. Resources management are also completely separated between host and plugged apps.

  9. Process management for plugged apps, idle processed of the plugged app will be timely recycled to guarantee minimum memory usage.

  10. Static broadcast of plugged app will be treated as dynamic, thus the static broadcasting will never be trigger if

  the plugged app are not activated.

    

## Usage：

#### Integrate with the host apps

It is very simple integrate Droid Plugin to your proejct：

1. Import Droid Plugin project to your project as a lib.

2. Include following attributes in host's `AndroidManifest.xml`：

	

		

           

3. Or, if you use customized `Application`，add following code in the methods `onCreate` and `attachBaseContext`:

    

		@Override

		public void onCreate() {

			super.onCreate();

			PluginHelper.getInstance().applicationOnCreate(getBaseContext()); //must be after super.onCreate()

		}

        

		@Override

		protected void attachBaseContext(Context base) {

			PluginHelper.getInstance().applicationAttachBaseContext(base);

            super.attachBaseContext(base);

		}

4. Modify the `authorityName` value in `Libraries\DroidPlugin\build.gradle` (suggested use your package name)

#### Install、Uninstall or Upgrade the plugged app：

1. **Install/Upgrade**, use this method：

 

		int PluginManager.getInstance().installPackage(String filepath, int flags);

   

	For installation, `filepath` set to path of the .apk file, and `flags` set to 0.

	For upgrade, `filepath` set to path of the .apk file, and  `flags` set to `PackageManagerCompat.INSTALL_REPLACE_EXISTING`.

        

    

2. **Uninstall**, use this method：

		int PluginManager.getInstance().deletePackage(String packageName,int flags);

	`packageName` is package name of the plugged app，`flags = 0`。

3. **Activate**

    Just use android's API, same for communication between components.

	

## FAQ

	

 [FAQ](https://github.com/DroidPluginTeam/DroidPlugin/wiki/FAQ "FAQ")

	

## Remark：

Please feel free to [report bugs](https://github.com/Qihoo360/DroidPlugin/issues) or ask for help via email.

QQ Group:318901026

##Who is using Droid Plugin?

	

 [360 App Store](http://sj.360.cn "360 App Store")

    

### Thanks：

    

    Translated by Ming Song（[email protected]）