Skip to content
pubscout

app_usage

4.1.0, released 8 months ago by cachet.dk

Provides Android‑only app usage statistics such as time spent per app.

$ flutter pub add app_usage
Source repository

What it does

The plugin queries the Android UsageStatsManager to return a list of apps with their usage duration, start/end dates and last foreground time. It works as a singleton accessed via AppUsage().getAppUsage(start, end).

AI-written summary of version 4.1.0, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need to display how much time the user spent in each app on Android.
  • You require daily‑level usage data for analytics or parental‑control features.

Skip it when

  • You need cross‑platform (iOS/web) usage data.
  • Precise per‑minute usage is required, as the data is only daily‑level accurate.

Strengths

  • Simple API for retrieving usage stats on Android.
  • Handles permission request flow automatically.
  • Supports last foreground timestamp.

Weaknesses

  • Android‑only; no iOS support.
  • Usage data limited to daily granularity.
  • Requires special permission (PACKAGE_USAGE_STATS) which may need user to enable manually.

Setup

Kind
Plugin (native code)
Effort
Medium
Code generation
No
Direct dependencies
0

Add minSdkVersion >=21, include xmlns:tools in AndroidManifest, and request android.permission.PACKAGE_USAGE_STATS permission. No additional Dart setup required.

void getUsage() async {
  DateTime end = DateTime.now();
  DateTime start = end.subtract(Duration(hours: 1));
  List<AppUsageInfo> info = await AppUsage().getAppUsage(start, end);
  print(info);
}

Alternatives

Packages that do the same job and could replace app_usage.