app_limiter

Releases

1. ▸▾1.0.01 Oct 2026

   Android namespace changed from com.example.app_limiter to io.github.connectrizwan.app_limiter. Saved blocking state is kept.

   Breaking

   • Android namespace changed from com.example.app_limiter to io.github.connectrizwan.app_limiter. Saved blocking state is kept.
   • events emits typed AppLimiterEvents instead of maps (event.toMap() gives the old shape).
   • Errors are thrown as AppLimiterException (with AppLimiterErrorCode) instead of PlatformException / ArgumentError.
   • The platform interface was redesigned; custom AppLimiterPlatform implementations must be updated.

   Added

   • Typed cross-platform API: getPermissionStatus(), requestPermission(), getBlockingState(), unblockAll(), AppLimiter.isSupported.
   • Platform namespaces limiter.android and limiter.ios.
   • android.getInstalledApps() with names, categories, system flag and optional PNG icons.
   • android.blockApps() / android.unblockApps() for several packages at once.
   • android.isEnterpriseCapable().
   • Android requestPermission() completes when the user returns from the settings screen.
   • IosSchedule type for iOS schedules.
   • Android setBlockScreen(BlockScreenConfig): custom title, message, footer, colors, icon and an optional button that closes the blocked app or opens the host app.
   • Android setNotification() to change the blocking notification text.
   • Android blockAllApps(except: [...]) allowlist; BlockingState.allowedPackages.
   • AppLimiterEventType.blockedAppOpened event with the package name (Android).
   • Default texts are string resources that host apps can translate or override.
   • Android timed blocks: duration: on blockApp, blockApps and blockAllApps.
   • Android recurring schedules: setSchedule(BlockSchedule), removeSchedule, getSchedules, with overnight windows, weekdays and "all apps except".
   • BlockingState.blockedUntil, blockAllUntil and activeScheduleIds.
   • Events blockExpired, scheduleStarted and scheduleEnded (Android).

   Fixed

   • iOS permission checks right after app launch reported notDetermined (and blocking failed with permissionDenied) although access was granted.
   • Crash ForegroundServiceDidNotStartInTimeException when blocking was turned off right after it was turned on (for example a quick toggle) on Android 12+.
   • The block screen footer showed "Digital Wellbeing" (Google's product name); it now shows the host app's name.
   • A host app overriding the block_overlay layout no longer prevents the block screen from showing.

   Added (iOS)

   • App extension templates (Shield Configuration, Device Activity Monitor) and a dart run app_limiter:setup_ios command that adds them to an Xcode project.
   • ios.setShield(IosShieldConfig): custom block screen with {app} placeholder.
   • ios.blockSelectedApps(duration: ...): timed blocks that end while the app is closed.
   • ios.setSchedule(IosBlockSchedule), removeSchedule, getSchedules.
   • ios.getExtensionStatus() and AppLimiterErrorCode.extensionMissing.
   • BlockingState.iosBlockedUntil; activeScheduleIds now also covers iOS.

   Deprecated

   • All 0.x methods; they keep working and forward to the new API. See the migration table in the README.