Displaying overridden configuration

It is useful to display the currently applied overridden configuration in your app. We suggest you display this on your app's home screen.

The provided APLConfigurationLabel for UIKit (Swift, Objective-C), .configurationView modifier for SwiftUI and APLConfigurationLabel (Dart) displays overridden configuration drawn in a vertical orientation attached to the left hand side of the screen as follows:

You can add the APLConfigurationLabel to your view controller in a viewDidLoad like this:

override func viewDidLoad() {
    let label = APLConfigurationLabel(frame: .zero)
    label.center = CGPoint(x: 7, y: self.navigationController!.view.bounds.size.height / 2)
    self.navigationController!.view.addSubview(label)
}

You can add the .configurationView modifier to your SwiftUI view like this:

NavigationStack {
  ...your content...
}
.configurationView()

This .configurationView modifier is available for both iOS and watchOS.

You can add the APLConfigurationLabel to your view controller in a viewDidLoad like this:

- (void) viewDidLoad {
    APLConfigurationLabel* label = [[APLConfigurationLabel alloc] initWithFrame: CGRectZero];
    label.center = CGPointMake(7, self.navigationController.view.bounds.size.height / 2);
    [self.navigationController.view addSubview: label];
}

Make the body of your page a APLConfiguationLabel, and set it's child to the original body:

...
  @override
  Widget build(BuildContext context) {
    var media = MediaQuery.of(context);
    var padding = media.padding.left == 0.0 ? 8.0 : media.padding.left;

    return Scaffold(
      appBar: AppBar(
        title: Text('Example'),
      ),
      body: APLConfigurationLabel(child:
        ListView(
...

Creating your own label

If APLConfigurationLabel is not sufficient for your needs, you can create your own label as follows:

Swift APLAddConfigurationUpdatedListener example

extension MyLogonController: APLConfigurationUpdated {

    override func viewDidLoad() {
        APLAddConfigurationUpdatedListener(self)
    }

    func configurationUpdated(_ notification: Notification?) {
        label.text = APLConfiguration.shared().modifications
    }
...

Objective-C APLAddConfigurationUpdatedListener example

@interface MyLogonController () <APLConfigurationUpdated>
@end

@implementation MyLogonController

- (void) viewDidLoad {
    APLAddConfigurationUpdatedListener(self);
}

- (void) configurationUpdated: (NSNotification*) notification {
    label.text = [[APLConfiguration sharedConfiguration] modifications];
}
...

Dart APLAddConfigurationUpdatedListener example

class _MyLabelState extends State<MyLabel> {

  @override
  void initState() {
    super.initState();
    APLAddConfigurationUpdatedListener(configurationUpdated);
  }

  @override
  void dispose() {
    APLRemoveConfigurationUpdatedListener(configurationUpdated);
    super.dispose();
  }

  void configurationUpdated(String? action) {
    setState(() {});
  }
  
  @override
  Widget build(BuildContext context) {
    return Text('${APLNativeConfiguration.sharedConfiguration().modifications()}');
  }
...

PreviousInfo.plist options NextSecurity

Last updated 1 month ago