device_apps: ^2.1.1 copied to clipboard
List applications installed on an Android device (iOS is not supported). You can also monitor application changes (updates, uninstallation…)
Device Apps plugin for Flutter #
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 #
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.
Starting with version 2.1.0 of this plugin, the
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. 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:
<manifest...> <uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" /> </manifest>
However, publishing applications on the Google Play with this kind of feature may change in the future. Quoting from the documentation:
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:
List of installed applications #
To list applications installed on the device:
List<Application> 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.
// Returns a list of only those apps that have launch intent List<Application> apps = await DeviceApps.getInstalledApplications(onlyAppsWithLaunchIntent: true, includeSystemApps: true)
Get an application #
To get a specific application info, please provide its package name:
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):
bool isInstalled = await DeviceApps.isAppInstalled('com.frandroid.app');
Open an application #
To open an application (with a launch Intent)
Open an application settings screen #
To open an application settings screen
Include application icon #
getApp() methods, you can also ask for the icon.
To display the image, just call:
Listen to app changes #
To listen to applications events on the device (installation, uninstallation, update, enabled or disabled):
Stream<ApplicationEvent> apps = await DeviceApps.listenToAppsChanges();
If you only need events for a single app, just use the
Stream API, like so:
DeviceApps.listenToAppsChanges().where((ApplicationEvent event) => event.packageName == 'com.frandroid.app')