Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/g123k/flutter_plugin_device_apps
Flutter plugin to get the list of installed applications (iOS is not supported yet).
https://github.com/g123k/flutter_plugin_device_apps
android apps dart dartlang flutter flutter-plugin icons launcher
Last synced: 15 days ago
JSON representation
Flutter plugin to get the list of installed applications (iOS is not supported yet).
- Host: GitHub
- URL: https://github.com/g123k/flutter_plugin_device_apps
- Owner: g123k
- License: apache-2.0
- Archived: true
- Created: 2018-06-06T13:57:37.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-07-11T23:55:03.000Z (7 months ago)
- Last Synced: 2025-01-01T06:06:15.299Z (about 1 month ago)
- Topics: android, apps, dart, dartlang, flutter, flutter-plugin, icons, launcher
- Language: Dart
- Homepage: https://pub.dev/packages/device_apps
- Size: 273 KB
- Stars: 107
- Watchers: 3
- Forks: 95
- Open Issues: 44
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Device Apps plugin for Flutter (UNMAINTAINED)
[](https://pub.dartlang.org/packages/device_apps)
A plugin to list installed applications on an Android device (⚠️ iOS is not supported). You can also listen to app changes (eg: installations, updates…)
## BREAKING CHANGE - 05th May 2021
[May 5 2021](https://support.google.com/googleplay/android-developer/answer/10158779) will mark a breaking change on how applications requesting [`QUERY_ALL_PACKAGES`](https://developer.android.com/reference/kotlin/android/Manifest.permission#query_all_packages) are accepted in the Google Play (and only this app store !). [Quoting from the doc](https://support.google.com/googleplay/android-developer/answer/10158779):
> Permitted use involves apps that must discover any and all installed apps on the device, for awareness or interoperability purposes may have eligibility for the permission. Permitted use includes; device search, antivirus apps, file managers, and browsers.
>
> Apps granted access to this permission must comply with the User Data policies, including the Prominent Disclosure and Consent requirements, and may not extend its use to undisclosed or invalid purposes.
More info here: https://support.google.com/googleplay/android-developer/answer/10158779
**Starting with version 2.1.0 of this plugin, the [`QUERY_ALL_PACKAGES`](https://developer.android.com/reference/kotlin/android/Manifest.permission#query_all_packages) permission won't be requested by default!**
## Change with Android 11
Starting with Android 11, Android applications targeting API level 30, willing to list "external" applications have to declare a new "normal" permission in their `AndroidManifest.xml` file called [`QUERY_ALL_PACKAGES`](https://developer.android.com/reference/kotlin/android/Manifest.permission#query_all_packages). A few notes about this:
- A normal permission doesn't require the user consent
- Before version 2.1 of this plugin, the permission was requested automatically. This is not the case anymore
If you want to use, simply add the following to your AndroidManifest.xml:
```xml
```
However, publishing applications on the Google Play with this kind of feature **may change** in the future. [Quoting from the documentation](https://developer.android.com/reference/kotlin/android/Manifest.permission#query_all_packages):
> In an upcoming policy update, look for Google Play to provide guidelines for apps that need the QUERY_ALL_PACKAGES permission.
**👍 Right now, there is no limitation, but be aware that this may change in the future.**
## Getting Started
First, you have to import the package in your dart file with:
```dart
import 'package:device_apps/device_apps.dart';
```
## List of installed applications
To list applications installed on the device:
```dart
List apps = await DeviceApps.getInstalledApplications();
```
You can filter system apps if necessary.
**Note**: The list of apps is not ordered! You have to do it yourself.
### Get apps with a launch Intent
A launch Intent means you can launch the application.
To list only the apps with launch intents, simply use the `onlyAppsWithLaunchIntent: true` attribute.
```dart
// Returns a list of only those apps that have launch intent
List apps = await DeviceApps.getInstalledApplications(onlyAppsWithLaunchIntent: true, includeSystemApps: true)
```
## Get an application
To get a specific application info, please provide its package name:
```dart
Application app = await DeviceApps.getApp('com.frandroid.app');
```
## Check if an application is installed
To check if an app is installed (via its package name):
```dart
bool isInstalled = await DeviceApps.isAppInstalled('com.frandroid.app');
```
## Open an application
To open an application (with a launch Intent)
```dart
DeviceApps.openApp('com.frandroid.app');
```
## Open an application settings screen
To open an application settings screen
```dart
DeviceApps.openAppSettings('com.frandroid.app');
```
## Uninstall an application
To open the screen to uninstall an application:
1. Add this permission to the `AndroidManifest.xml` file:
```xml
```
2. Call this method:
```dart
DeviceApps.uninstallApp('com.frandroid.app');
```
## Include application icon
When calling `getInstalledApplications()` or `getApp()` methods, you can also ask for the icon.
To display the image, just call:
```dart
Image.memory(app.icon);
```
## Listen to app changes
To listen to applications events on the device (installation, uninstallation, update, enabled or disabled):
```dart
Stream apps = await DeviceApps.listenToAppsChanges();
```
If you only need events for a single app, just use the `Stream` API, like so:
```dart
DeviceApps.listenToAppsChanges().where((ApplicationEvent event) => event.packageName == 'com.frandroid.app')
```