Secure App Switcher

https://pub.dev/documentation/secure_app_switcher/latest/
Admin
Secure App Switcher is a Flutter package that applies a safe masking effect to app screens on the...
Tokens:6,345
Snippets:78
Trust Score:9.9
Update:5 months ago
Show doc for...
Tokens:
Raw
### StatefulWidget Build Method Example

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPageState/build.html

This example demonstrates how closures created within the build method of a State object correctly capture the widget's properties, ensuring that updated values are used across rebuilds.

```dart
class MyButton extends StatefulWidget {
  const MyButton({super.key, this.color = Colors.teal});

  final Color color;
  // ...
}

class MyButtonState extends State<MyButton> {
  // ...
  @override
  Widget build(BuildContext context) {
    return SpecialWidget(
      handler: () { print('color: ${widget.color}'); },
    );
  }
}
```

--------------------------------

### Flutter StatefulWidget createState Example

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPage/createState.html

Subclasses should override this method to return a newly created instance of their associated State subclass. The framework may call this method multiple times.

```dart
@override
State<SomeWidget> createState() => _SomeWidgetState();

```

--------------------------------

### SecureAppSwitcherPageState Constructors

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPageState-class.html

Provides information on how to instantiate the SecureAppSwitcherPageState.

```APIDOC
## Constructors 

SecureAppSwitcherPageState()
    
```

--------------------------------

### SecureAppSwitcher Constructor

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcher/SecureAppSwitcher.html

Initializes a new instance of the SecureAppSwitcher class.

```APIDOC
## SecureAppSwitcher()

### Description
Initializes a new instance of the SecureAppSwitcher class.

### Method
constructor

### Endpoint
N/A

### Parameters
This constructor does not accept any parameters.

### Request Example
```dart
var secureAppSwitcher = SecureAppSwitcher();
```

### Response
#### Success Response (Instance)
- **SecureAppSwitcher** (object) - An instance of the SecureAppSwitcher class.
```

--------------------------------

### Initialize SecureAppSwitcher Route Observer

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/secureAppSwitcherRouteObserver.html

Instantiate the RouteObserver for screen widget transition detection. This is a top-level property.

```dart
final RouteObserver secureAppSwitcherRouteObserver = RouteObserver();
```

--------------------------------

### SecureAppSwitcherPageState()

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPageState/SecureAppSwitcherPageState.html

Initializes a new instance of the SecureAppSwitcherPageState class. This is the primary way to create a state object for the secure app switcher.

```APIDOC
## SecureAppSwitcherPageState()

### Description
Initializes a new instance of the SecureAppSwitcherPageState class.

### Method
constructor

### Endpoint
N/A (Constructor)

### Parameters
None

### Request Body
None

### Response
- **SecureAppSwitcherPageState**: An instance of the SecureAppSwitcherPageState class.
```

--------------------------------

### Instantiate SecureAppSwitcherPage

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPage-class.html

Use this to wrap your screen widget with the SecureAppSwitcherPage. Ensure `secureAppSwitcherRouteObserver` is added to your `navigatorObservers`. A mask style can be specified.

```dart
MaterialPageRoute(builder: (context) {
  return const SecureAppSwitcherPage(
    style: SecureMaskStyle.blurLight,
    child: ScreenA(),
  );
)

```

--------------------------------

### SecureAppSwitcherPageState Methods

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPageState-class.html

Details the methods available for managing the state and lifecycle of the SecureAppSwitcherPage.

```APIDOC
## Methods 

activate() → void 
     Called when this object is reinserted into the tree after having been removed via deactivate. 
inherited 

build(BuildContext context) → Widget 
     Describes the part of the user interface represented by this widget. 
override 

deactivate() → void 
     Called when this object is removed from the tree. 
inherited 

debugFillProperties(DiagnosticPropertiesBuilder properties) → void 
     Add additional properties associated with the node. 
inherited 

didChangeDependencies() → void 
     Called when a dependency of this State object changes. 
override 

didPop() → void 
     Called when the current route has been popped off. 
override 

didPopNext() → void 
     Called when the top route has been popped off, and the current route shows up. 
override 

didPush() → void 
     Called when the current route has been pushed. 
override 

didPushNext() → void 
     Called when a new route has been pushed, and the current route is no longer visible. 
override 

didUpdateWidget(covariant SecureAppSwitcherPage oldWidget) → void 
     Called whenever the widget configuration changes. 
inherited 

dispose() → void 
     Called when this object is removed from the tree permanently. 
override 

initState() → void 
     Called when this object is inserted into the tree. 
inherited 

noSuchMethod(Invocation invocation) → dynamic 
     Invoked when a nonexistent method or property is accessed. 
inherited 

reassemble() → void 
     Called whenever the application is reassembled during debugging, for example during hot reload. 
inherited 

setState(VoidCallback fn) → void 
     Notify the framework that the internal state of this object has changed. 
inherited 

toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode 
     Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep. 
inherited 

toString({DiagnosticLevel minLevel = DiagnosticLevel.info}) → String 
     A string representation of this object. 
inherited 

toStringShort() → String 
     A brief description of this object, usually just the runtimeType and the hashCode. 
inherited
```

--------------------------------

### didPush Method

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPageState/didPush.html

This method is called when the current route has been pushed. It initializes the SecureAppSwitcher with the specified iOS style.

```APIDOC
## didPush Method

### Description
Called when the current route has been pushed.

### Method Signature
```dart
void didPush()
```

### Implementation Details
This method overrides the default behavior to call `SecureAppSwitcher.on` with the `widget.style` and then calls the superclass's `didPush` method.
```

--------------------------------

### SecureAppSwitcherPageState Constructor Implementation

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPageState/SecureAppSwitcherPageState.html

This is the default constructor for the SecureAppSwitcherPageState class. It initializes the state.

```dart
SecureAppSwitcherPageState();
```

--------------------------------

### SecureAppSwitcherPage Constructor

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPage-class.html

The constructor for SecureAppSwitcherPage allows you to specify a child widget and an optional style for the secure mask. The style defaults to `SecureMaskStyle.light`.

```APIDOC
## Constructors

SecureAppSwitcherPage({Key? key, required Widget child, SecureMaskStyle style = SecureMaskStyle.light})
```

--------------------------------

### SecureAppSwitcherPageState Build Implementation

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPageState/build.html

The core implementation of the build method for SecureAppSwitcherPageState, which returns the widget's child.

```dart
@override
Widget build(BuildContext context) {
  return widget.child;
}
```

--------------------------------

### Implement didPopNext Method

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPageState/didPopNext.html

This method is called when the top route has been popped off, and the current route shows up. It schedules a call to SecureAppSwitcher.on after a short delay.

```dart
@override
void didPopNext() {
  Future.delayed(const Duration(milliseconds: 500)).then((value) {
    SecureAppSwitcher.on(iosStyle: widget.style);
  });
  super.didPopNext();
}
```

--------------------------------

### SecureAppSwitcherPage Constructor

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPage/SecureAppSwitcherPage.html

The constructor for SecureAppSwitcherPage allows for the creation of a secure app switcher with customizable child widgets and secure mask styles.

```APIDOC
## SecureAppSwitcherPage Constructor

### Description
Initializes a new instance of the SecureAppSwitcherPage class.

### Parameters
#### Named Parameters
- **key** (Key?) - Optional - An object that identifies this widget in the widget tree.
- **child** (Widget) - Required - The widget to be displayed within the secure app switcher.
- **style** (SecureMaskStyle) - Optional - The style of the secure mask, defaults to `SecureMaskStyle.light`.
```

--------------------------------

### on

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcher/on.html

Enables screen masking to secure the application's content when it's not in the foreground. For iOS, a specific mask style can be chosen.

```APIDOC
## on

### Description
Enable screen mask. For iOS, a mask style can be specified. Default is SecureMaskStyle.light.

### Method Signature
`static void on({SecureMaskStyle iosStyle = SecureMaskStyle.light})`

### Parameters
#### Named Parameters
- **iosStyle** (SecureMaskStyle) - Optional - Specifies the mask style for iOS. Defaults to `SecureMaskStyle.light`.

### Implementation Example
```dart
static void on({SecureMaskStyle iosStyle = SecureMaskStyle.light}) {
  _methodChannel.invokeMethod('on', {
    'style': iosStyle.index,
  });
}
```
```

--------------------------------

### SecureAppSwitcherPage Methods

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPage-class.html

Methods inherited and overridden by the SecureAppSwitcherPage class, including state creation and debugging utilities.

```APIDOC
## Methods 

createState() → SecureAppSwitcherPageState 
    
    Creates the mutable state for this widget at a given location in the tree. 
    override 

toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode 
    
    Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep. 
    inherited
```

--------------------------------

### SecureAppSwitcherPageState Properties

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPageState-class.html

Lists the properties accessible from a SecureAppSwitcherPageState instance.

```APIDOC
## Properties 

context → BuildContext 
     The location in the tree where this widget builds. 
no setterinherited 

hashCode → int 
     The hash code for this object. 
no setterinherited 

mounted → bool 
     Whether this State object is currently in a tree. 
no setterinherited 

runtimeType → Type 
     A representation of the runtime type of the object. 
no setterinherited 

widget → SecureAppSwitcherPage 
     The current configuration. 
no setterinherited
```

--------------------------------

### Enable Screen Mask (iOS)

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcher/on.html

Call this static method to enable the screen mask. For iOS, you can specify the mask style; otherwise, it defaults to SecureMaskStyle.light.

```dart
static void on({SecureMaskStyle iosStyle = SecureMaskStyle.light}) {
  _methodChannel.invokeMethod('on', {
    'style': iosStyle.index,
  });
}
```

--------------------------------

### SecureAppSwitcherPage Constructor

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPage/SecureAppSwitcherPage.html

Defines the constructor for SecureAppSwitcherPage, accepting a key, a child widget, and an optional SecureMaskStyle.

```dart
const SecureAppSwitcherPage({
  1. Key? key, 
  2. required Widget child, 
  3. SecureMaskStyle style = SecureMaskStyle.light,

})
```

```dart
const SecureAppSwitcherPage({
  super.key,
  required this.child,
  this.style = SecureMaskStyle.light,
});
```

--------------------------------

### Enable Screen Mask

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcher-class.html

Call this method to enable the screen mask when switching between applications. An optional style can be provided for iOS.

```APIDOC
## on()

### Description
Enable screen mask. For iOS, a mask style can be specified.

### Method
`static void on({SecureMaskStyle iosStyle = SecureMaskStyle.light})`

### Parameters
#### Named Parameters
- **iosStyle** (SecureMaskStyle) - Optional - Specifies the mask style for iOS. Defaults to `SecureMaskStyle.light`.
```

--------------------------------

### Implement didPush Method

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPageState/didPush.html

Override the didPush method to initialize SecureAppSwitcher when a route is pushed. Ensure to call the superclass method.

```dart
@override
void didPush() {
  SecureAppSwitcher.on(iosStyle: widget.style);
  super.didPush();
}
```

--------------------------------

### SecureAppSwitcherPageState createState Implementation

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPage/createState.html

This is the specific implementation of the createState method for the SecureAppSwitcherPageState. It returns a new instance of SecureAppSwitcherPageState.

```dart
@override
SecureAppSwitcherPageState createState() {
  return SecureAppSwitcherPageState();
}

```

--------------------------------

### SecureAppSwitcherPageState Operators

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPageState-class.html

Defines operators for the SecureAppSwitcherPageState class.

```APIDOC
## Operators 

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

--------------------------------

### Enable/Disable Secure App Switcher Globally

Source: https://pub.dev/documentation/secure_app_switcher/latest/index.html

These functions allow you to globally enable or disable the secure app switcher effect for your entire application.

```APIDOC
## Enable Secure App Switcher

### Description
Enables the secure app switcher effect globally.

### Method
`SecureAppSwitcher.on()`

### Parameters
#### Optional Parameters
- **iosStyle** (SecureMaskStyle) - Optional - Specifies the masking style for iOS. Available options are `SecureMaskStyle.blurLight`, `SecureMaskStyle.blurDark`, `SecureMaskStyle.light`, `SecureMaskStyle.dark`.

### Request Example
```dart
import 'package:secure_app_switcher/secure_app_switcher.dart';

// Enable with default style
SecureAppSwitcher.on();

// Enable with a specific iOS style
SecureAppSwitcher.on(iosStyle: SecureMaskStyle.blurLight);
```

## Disable Secure App Switcher

### Description
Disables the secure app switcher effect globally.

### Method
`SecureAppSwitcher.off()`

### Request Example
```dart
import 'package:secure_app_switcher/secure_app_switcher.dart';

SecureAppSwitcher.off();
```
```

--------------------------------

### SecureAppSwitcherPage Operators

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPage-class.html

Operators available for the SecureAppSwitcherPage class, such as the equality operator.

```APIDOC
## Operators 

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

--------------------------------

### Add secureAppSwitcherRouteObserver to MaterialApp

Source: https://pub.dev/documentation/secure_app_switcher/latest/index.html

To use the secure app switcher on specific screens, you must add `secureAppSwitcherRouteObserver` to your `MaterialApp`'s `navigatorObservers`. This allows the package to track screen transitions.

```dart
@override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Secure App Switcher',
      onGenerateRoute: generateRoute,
      navigatorObservers: [secureAppSwitcherRouteObserver], // add
      initialRoute: '/',
    );
  }

```

--------------------------------

### SecureAppSwitcherPage Properties

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPage-class.html

Properties available for the SecureAppSwitcherPage class, including the child widget and the secure mask style.

```APIDOC
## Properties 

child → Widget 
    
    final 

key → Key? 
    Controls how one widget replaces another widget in the tree. 
    finalinherited 

style → SecureMaskStyle 
    
    final
```

--------------------------------

### Wrap Screen with SecureAppSwitcherPage

Source: https://pub.dev/documentation/secure_app_switcher/latest/index.html

Wrap the target screen widget with `SecureAppSwitcherPage` and `MaterialPageRoute` to enable the secure masking effect for that specific screen. You can also specify the `style` for iOS.

```dart
// Example: Case where the function is enabled on screen A

Route<dynamic> generateRoute(RouteSettings settings) {
  switch (settings.name) {
    case "/":
      return MaterialPageRoute(builder: (context) {
        return const HomeScreen();
      });    
    case "/screenA":
      return MaterialPageRoute(builder: (context) {
        return const SecureAppSwitcherPage( // add
          style: SecureMaskStyle.dark,
          child: ScreenA(),
        );
      });
  }
}

```

--------------------------------

### didPushNext Method

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPageState/didPushNext.html

The didPushNext method is an override that is invoked when a new route is pushed, making the current route no longer visible. It calls SecureAppSwitcher.off() and then the superclass's didPushNext method.

```APIDOC
## didPushNext Method

### Description
Called when a new route has been pushed, and the current route is no longer visible.

### Method Signature
```dart
@override
void didPushNext()
```

### Implementation Details
This method first calls `SecureAppSwitcher.off()` to potentially close the secure app switcher, and then it calls `super.didPushNext()` to ensure the default behavior of the superclass is executed.
```

--------------------------------

### Secure App Switcher Per Screen

Source: https://pub.dev/documentation/secure_app_switcher/latest/index.html

This section details how to apply the secure app switcher effect to specific screens within your application by integrating with Flutter's navigation.

```APIDOC
## Integrate with Navigation

### Description
To enable the secure app switcher effect on a screen-by-screen basis, you need to add `secureAppSwitcherRouteObserver` to your `MaterialApp`'s `navigatorObservers` and wrap your target screen widget with `SecureAppSwitcherPage` within `MaterialPageRoute`.

### Setup `MaterialApp`
Add `secureAppSwitcherRouteObserver` to the `navigatorObservers` list.

```dart
import 'package:flutter/material.dart';
import 'package:secure_app_switcher/secure_app_switcher.dart';

@override
Widget build(BuildContext context) {
  return MaterialApp(
    title: 'Secure App Switcher',
    onGenerateRoute: generateRoute,
    navigatorObservers: [secureAppSwitcherRouteObserver], // Add this line
    initialRoute: '/',
  );
}
```

### Wrap Screen with `SecureAppSwitcherPage`
When defining your routes, wrap the `child` widget of `MaterialPageRoute` with `SecureAppSwitcherPage`.

```dart
import 'package:flutter/material.dart';
import 'package:secure_app_switcher/secure_app_switcher.dart';

// Assume HomeScreen and ScreenA are defined elsewhere
// class HomeScreen extends StatelessWidget { const HomeScreen({Key? key}) : super(key: key); @override Widget build(BuildContext context) => const Scaffold(body: Center(child: Text('Home Screen'))); }
// class ScreenA extends StatelessWidget { const ScreenA({Key? key}) : super(key: key); @override Widget build(BuildContext context) => const Scaffold(body: Center(child: Text('Screen A'))); }

Route<dynamic> generateRoute(RouteSettings settings) {
  switch (settings.name) {
    case "/":
      return MaterialPageRoute(builder: (context) {
        return const HomeScreen();
      });    
    case "/screenA":
      return MaterialPageRoute(builder: (context) {
        return const SecureAppSwitcherPage(
          style: SecureMaskStyle.dark, // Optional: specify style for this screen
          child: ScreenA(),
        );
      });
    default:
      return MaterialPageRoute(builder: (context) => const Text('Error: Unknown route'));
  }
}
```

### `SecureMaskStyle` for iOS
For iOS, you can specify the `style` parameter within `SecureAppSwitcherPage` to choose the mask effect.

**Available Styles:**
- `SecureMaskStyle.light`
- `SecureMaskStyle.dark`
- `SecureMaskStyle.blurLight`
- `SecureMaskStyle.blurDark`

**Note:** On Android, the `FLAG_SECURE` of `WindowManager.LayoutParams` is used, and the style cannot be specified. The effect on Android 11+ may require switching apps once due to OS specifications. Screenshots are disabled when the feature is enabled.
```

--------------------------------

### Enable/Disable Secure App Switcher Globally

Source: https://pub.dev/documentation/secure_app_switcher/latest/index.html

Use these functions to globally turn the secure app switcher effect on or off. This is useful for applying the effect to all screens or disabling it entirely.

```dart
import 'package:secure_app_switcher/secure_app_switcher.dart';

// ON
SecureAppSwitcher.on();

// OFF
SecureAppSwitcher.off();

```

--------------------------------

### off static method

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcher/off.html

Disables the screen mask. This method is invoked via the platform channel.

```APIDOC
## off static method

### Description
Disable screen mask.

### Method Signature
`static void off()`

### Implementation
```dart
static void off() {
  _methodChannel.invokeMethod('off');
}
```
```

--------------------------------

### Implement didPushNext Method

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPageState/didPushNext.html

Overrides the didPushNext method to call SecureAppSwitcher.off() and then the superclass's didPushNext method. This is typically used to manage app switching state when navigation occurs.

```dart
@override
void didPushNext() {
  SecureAppSwitcher.off();
  super.didPushNext();
}
```

--------------------------------

### didPop Method

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPageState/didPop.html

This method is invoked when the current route is removed from the navigation stack. It ensures that the SecureAppSwitcher is properly closed.

```APIDOC
## didPop Method

### Description
Called when the current route has been popped off.

### Method Signature
```dart
void didPop()
```

### Implementation
```dart
@override
void didPop() {
  SecureAppSwitcher.off();
  super.didPop();
}
```
```

--------------------------------

### Disable Screen Mask (Dart)

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcher/off.html

Call this static method to disable the screen mask. Ensure the SecureAppSwitcher plugin is initialized.

```dart
static void off() {
  _methodChannel.invokeMethod('off');
}
```

--------------------------------

### SecureAppSwitcher didPop Implementation

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPageState/didPop.html

Overrides the didPop method to call SecureAppSwitcher.off() for cleanup before calling the superclass method.

```dart
@override
void didPop() {
  SecureAppSwitcher.off();
  super.didPop();
}
```

--------------------------------

### SecureMaskStyle Enum Values

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureMaskStyle.html

This enum provides several predefined styles for masking the application screen. Each value corresponds to a specific visual effect.

```APIDOC
## Enum: SecureMaskStyle

Select a screen mask style. Applies to iOS only.

### Values

*   **light** → const SecureMaskStyle
    *   Description: `UIColor.white` is applied.
*   **dark** → const SecureMaskStyle
    *   Description: `UIColor.black` is applied.
*   **blurLight** → const SecureMaskStyle
    *   Description: `UIBlurEffect(style: .light)` is applied.
*   **blurDark** → const SecureMaskStyle
    *   Description: `UIBlurEffect(style: .dark)` is applied.
```

--------------------------------

### Disable Screen Mask

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcher-class.html

Call this method to disable the screen mask when switching between applications.

```APIDOC
## off()

### Description
Disable screen mask.

### Method
`static void off()`
```

--------------------------------

### Dispose Method Implementation

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPageState/dispose.html

Override the dispose method to unsubscribe from route observers and perform other cleanup tasks before the object is permanently removed. Ensure to call super.dispose() to complete the disposal process.

```dart
@override
void dispose() {
  secureAppSwitcherRouteObserver.unsubscribe(this);
  super.dispose();
}
```

--------------------------------

### Specify iOS Masking Style

Source: https://pub.dev/documentation/secure_app_switcher/latest/index.html

For iOS, you can specify the type of mask effect to be applied. This allows for customization of the visual appearance of the secure masking.

```dart
SecureAppSwitcher.on(iosStyle: SecureMaskStyle.blurLight);

```

--------------------------------

### Declare SecureMaskStyle Style

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPage/style.html

Declares the style property for SecureMaskStyle. This is a final variable.

```dart
final SecureMaskStyle style;
```

--------------------------------

### Override didChangeDependencies in SecureAppSwitcherPageState

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPageState/didChangeDependencies.html

This method is called when a dependency of this State object changes. It subscribes the current state to the ModalRoute's PageRoute. It is safe to call BuildContext.dependOnInheritedWidgetOfExactType from this method.

```dart
@override
void didChangeDependencies() {
  super.didChangeDependencies();
  secureAppSwitcherRouteObserver.subscribe(
      this, ModalRoute.of(context) as PageRoute);
}
```

--------------------------------

### Declare Widget Child Property

Source: https://pub.dev/documentation/secure_app_switcher/latest/secure_app_switcher/SecureAppSwitcherPage/child.html

This snippet shows the declaration of a final 'child' property of type Widget. This is a common pattern for widgets that require a child widget to be passed during initialization.

```dart
final Widget child;
```
Tokens:
Raw