DebugSettingsDeepLinkObserver class

Internal WidgetsBindingObserver that consumes the SDK's own debug-settings deeplink (…/_digia/debug-settings) so a warm-app link — e.g. digia-engage://_digia/debug-settings relayed by the Android trampoline Activity — opens the screen with zero host-side Dart code.

Registered by DigiaInstance.initialize, which is documented to run before runApp. WidgetsBinding dispatches didPushRouteInformation to observers in registration order and stops at the first one that returns true, so this observer wins over the one WidgetsApp adds when it builds. A host that wired its own handler per earlier integration docs keeps working — its handler simply never fires for this link anymore, which is harmless.

The route may arrive as a bare path (/_digia/debug-settings) or as a full URI depending on what the platform embedding forwards; Digia.isDebugSettingsDeepLink suffix-matches both.

A matching link is consumed (returns true) even when the build is not debug-eligible or nothing can present yet: swallowing our own link is strictly better than letting it fall through to MaterialApp, whose route handling would throw an unknown-route error in the host app.

Mixed-in types

Constructors

DebugSettingsDeepLinkObserver({required bool isEligible(), required Future<void> openDebugSettings()})

Properties

hashCode → int
The hash code for this object.
no setterinherited
isEligible → bool Function()
Whether debug tools may be presented — isDigiaDebugBuild in production wiring.
final
openDebugSettings → Future<void> Function()
Presents the debug settings screen without a host BuildContext — DigiaInstance.openDebugSettingsFromOverlay in production wiring, which itself degrades silently when no navigator is attached yet.
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

didChangeAccessibilityFeatures() → void
Called when the system changes the set of currently active accessibility features.
inherited
didChangeAppLifecycleState(AppLifecycleState state) → void
Called when the system puts the app in the background or returns the app to the foreground.
inherited
didChangeLocales(List<Locale>? locales) → void
Called when the system tells the app that the user's locale has changed. For example, if the user changes the system language settings.
inherited
didChangeMetrics() → void
Called when the application's dimensions change. For example, when a phone is rotated.
inherited
didChangePlatformBrightness() → void
Called when the platform brightness changes.
inherited
didChangeTextScaleFactor() → void
Called when the platform's text scale factor changes.
inherited
didChangeViewFocus(ViewFocusEvent event) → void
Called whenever the PlatformDispatcher receives a notification that the focus state on a view has changed.
inherited
didHaveMemoryPressure() → void
Called when the system is running low on memory.
inherited
didPopRoute() → Future<bool>
Called when the system tells the app to pop the current route, such as after a system back button press or back gesture.
inherited
didPushRoute(String route) → Future<bool>
Called when the host tells the application to push a new route onto the navigator.
inherited
didPushRouteInformation(RouteInformation routeInformation) → Future<bool>
Called when the host tells the application to push a new RouteInformation and a restoration state onto the router.
override
didRequestAppExit() → Future<AppExitResponse>
Called when a request is received from the system to exit the application.
inherited
handleCancelBackGesture() → void
Called when a predictive back gesture is canceled, indicating that no navigation should occur.
inherited
handleCommitBackGesture() → void
Called when a predictive back gesture is finished successfully, indicating that the current route should be popped.
inherited
handleStartBackGesture(PredictiveBackEvent backEvent) → bool
Called at the start of a predictive back gesture.
inherited
handleStatusBarTap() → void
Called when the user taps the status bar on iOS, to scroll a scroll view to the top.
inherited
handleUpdateBackGestureProgress(PredictiveBackEvent backEvent) → void
Called when a predictive back gesture moves.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited