Integer

Swift

Int is platform dependent, 32-bit signed values on 32-bit CPUs (Apple Watch; arm64_32) and 64-bit signed values on 64-bit CPUs (iPhone, iPad; arm64).

The default value of a Int is 0. You can change the default value of the property by assigning a new value in an overridden reset method.

Objective-C

NSInteger is platform dependent, 32-bit signed values on 32-bit CPUs (Apple Watch arm64_32) and 64-bit signed values on 64-bit CPUs (iPhone, iPad arm64).

The default value of a NSInteger is 0. You can change the default value of the property by assigning a new value in an overridden reset method.

NSInteger properties should be declared in your APLConfiguration subclass header file as follows:

@import AppfigurateLibrary;

@interface Configuration : APLConfiguration

@property(nonatomic, assign) NSInteger propertyName;
...

Dart

The flutter APLNativeConfiguration class defers to the underlying platform APLConfiguration (iOS) or nz.co.electricbolt.appfiguratelibrary.Configuration (Android) subclass to read property values.

JavaScript

The React Native module AppfigurateModule class defers to the underlying platform APLConfiguration (iOS) or nz.co.electricbolt.appfiguratelibrary.Configuration (Android) subclass to read property values.

React Native always converts the underlying Integer to a JavaScript Number - you should be aware of JavaScript's 53 bit limitation.

Local properties

Slider UI

Allows an integer property to be changed in Appfigurate using a slider between minimum and maximum values.

Swift

Swift prototype

@IntPropertySlider(min, max, icon, description, restart)
var propertyName: Int

You can customize the minimum and maximum images using the icon parameter. If restart is true, then the app will be restarted if the property value changes.

Swift example

import AppfigurateLibrary

@objcMembers class Configuration: APLConfiguration {

    @IntPropertySlider(min: 50, max: 100, icon: .volume, description: "Limit volume level", restart: true)
    var volumeRange: Int
    
    override func reset() {
        volumeRange = 75
    }
    ...

Objective-C

Objective-C prototype

INT_PROPERTY_SLIDER(propertyName, minValue, maxValue, icon, description, restart)

You can customize the minimum and maximum images using the icon parameter. If restart is YES, then the app will be restarted if the property value changes.

Objective-C example

@import AppfigurateLibrary;

@interface Configuration : APLConfiguration

@property(nonatomic, assign) NSInteger volumeRange;

@end

@implementation Configuration

INT_PROPERTY_SLIDER(volumeRange, 50, 100, APLIconSliderVolume, @"Limit volume level", NO);

- (void) reset {
    self.volumeRange = 75;
}
...

Dart

Dart prototype

int get propertyName => nativeInt('propertyName');

Dart example

import 'package:appfigurateflutter/appfigurateflutter.dart';

public class Configuration extends APLNativeConfiguration {

    int get volumeRange => nativeInt('volumeRange');
    ...

JavaScript

JavaScript example

import {
  NativeModules,
} from 'react-native';

const {Appfigurate} = NativeModules;

...

let volumeRange = await Appfigurate.nativeValue("volumeRange"); // Number

Editable UI

Allows an integer property to be changed in Appfigurate using a text field between minimum and maximum values, and an optional regular expression validating input.

Swift

Swift prototype

@IntPropertyEdit(min, max, regex, description, restart)
var propertyName: Int

If restart is true, then the app will be restarted if the property value changes.

Swift example

import AppfigurateLibrary

@objcMembers class Configuration: APLConfiguration {

    @IntPropertyEdit(min: 1, max: 5, regex: "", description: "Maximum number of game levels", restart: false)
    var gameLevels: Int
    
    override func reset() {
        gameLevels = 3
    }
    ...

Objective-C

Objective-C prototype

INT_PROPERTY_EDIT(propertyName, minValue, maxValue, regex, description, restart)

If restart is YES, then the app will be restarted if the property value changes.

Objective-C example

@import AppfigurateLibrary;

@interface Configuration : APLConfiguration

@property(nonatomic, assign) NSInteger gameLevels;

@end

@implementation Configuration

INT_PROPERTY_EDIT(gameLevels, 1, 5, @"", @"Maximum number of game levels", NO);

- (void) reset {
    self.gameLevels = 3;
}
...

Dart

Dart prototype

int get propertyName => nativeInt('propertyName');

Dart example

Dimport 'package:appfigurateflutter/appfigurateflutter.dart';

public class Configuration extends APLNativeConfiguration {

    int get gameLevels => nativeInt('gameLevels');
    ...

JavaScript

JavaScript example

import {
  NativeModules,
} from 'react-native';

const {Appfigurate} = NativeModules;

...

let gameLevels = await Appfigurate.nativeValue("gameLevels"); // Number

List UI

Allows an integer property to be changed in Appfigurate by allowing the user to select from a predefined list of valid choices.

Swift

Swift prototype

@IntPropertyList(description, restart, values)
var propertyName: Int

If restart is true, then the app will be restarted if the property value changes.

Swift example

import AppfigurateLibrary

@objcMembers class Configuration: APLConfiguration {

    @IntPropertyList(description: "Quality rating", restart: false, values: ["Low": 10, "Average": 50, "Excellent": 95])
    var rating: Int
    
    override func reset() {
        rating = 10
    }
    ...

Objective-C

Objective-C prototype

INT_PROPERTY_LIST(propertyName, description, restart, ...)

If restart is YES, then the app will be restarted if the property value changes.

Objective-C example

@import AppfigurateLibrary;

@interface Configuration : APLConfiguration

@property(nonatomic, assign) NSInteger rating;

@end

@implementation Configuration

INT_PROPERTY_LIST(rating, @"Quality rating", NO, @{@"Low": @10, @"Average": @50, @"Excellent": @95});

- (void) reset {
    self.rating = 10;
}
...

Dart

Dart prototype

int get propertyName => nativeInt('propertyName');

Dart example

import 'package:appfigurateflutter/appfigurateflutter.dart';

public class Configuration extends APLNativeConfiguration {

    int get rating => nativeInt('rating');
    ...

JavaScript

JavaScript example

import {
  NativeModules,
} from 'react-native';

const {Appfigurate} = NativeModules;

...

let rating = await Appfigurate.nativeValue("rating"); // Number

Editable List UI

Allows an integer property to be changed in Appfigurate by allowing the user to select from a predefined list of valid choices. The user can customize the list adding by additional values using a text field between minimum and maximum values, and an optional regular expression validating input.

Swift

Swift prototype

@IntPropertyListEdit(min, max, regex, description, restart, values)
var propertyName: Int

If restart is true, then the app will be restarted if the property value changes.

Swift example

import AppfigurateLibrary

@objcMembers class Configuration: APLConfiguration {

    @IntPropertyListEdit(min: 0, max: 365, regex: "^(0?[0-9]?[0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-5])$", description: "Duration in days emails are available", restart: false, values: ["7 days": 7, "1 month": 30, "1 Year": 365])
    var availablityDuration: Int
    
    override func reset() {
        volumeRange = 7
    }
    ...

Objective-C

Objective-C prototype

INT_PROPERTY_LIST_EDIT(propertyName, minValue, maxValue, regex, description, restart, ...)

If restart is YES, then the app will be restarted if the property value changes.

Objective-C example

@import AppfigurateLibrary;

@interface Configuration : APLConfiguration

@property(nonatomic, assign) NSInteger availabilityDuration;

@end

@implementation Configuration

INT_PROPERTY_LIST_EDIT(availablityDuration, 0, 365, @"^(0?[0-9]?[0-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-5])$", @"Duration in days emails are available", NO, @{@"7 days": @7, @"1 month": @30, @"1 Year": @365});

- (void) reset {
    self.volumeRange = 7;
}
...

Dart

Dart prototype

int get propertyName => nativeInt('propertyName');

Dart example

import 'package:appfigurateflutter/appfigurateflutter.dart';

public class Configuration extends APLNativeConfiguration {

    int get availabilityDuration => nativeInt('availabilityDuration');
    ...

JavaScript

JavaScript example

import {
  NativeModules,
} from 'react-native';

const {Appfigurate} = NativeModules;

...

let availabilityDuration = await Appfigurate.nativeValue("availabilityDuration"); // Number

Remote properties

Remote Editable UI

Allows a third party remote configuration provider's integer property to be changed locally in Appfigurate using a text field. If the override tick box is ticked off, the third party remote configuration provider's value is displayed. If the override tick box is ticked on, then you can use Appfigurate to locally override the value.

Swift

Swift prototype

@RemoteIntPropertyEdit(remoteKey, description)
var propertyName: Int

Swift example

import AppfigurateLibrary

@objcMembers class Configuration: APLConfiguration {
    
    @RemoteIntPropertyEdit(remoteKey: "bookingDuration", description: "Duration (days) for reservation bookings")
    var bookingDuration: Int
    
    override func reset() {
        bookingDuration = 180
    }
    ...

Objective-C

Objective-C prototype

REMOTE_INT_PROPERTY_EDIT(propertyName, remoteKey, description)

Objective-C example

@import AppfigurateLibrary;

@interface Configuration : APLConfiguration

@property(nonatomic, assign) NSInteger bookingDuration;

@end

@implementation Configuration

REMOTE_INT_PROPERTY_EDIT(bookingDuration, @"bookingDuration", @"Duration (days) for reservation bookings");

- (void) reset {
    self.bookingDuration = 180;
}
...

Dart

Dart prototype

int get propertyName => nativeInt('propertyName');

Dart example

Dimport 'package:appfigurateflutter/appfigurateflutter.dart';

public class Configuration extends APLNativeConfiguration {

    int get bookingDuration => nativeInt('bookingDuration');
    ...

JavaScript

JavaScript example

import {
  NativeModules,
} from 'react-native';

const {Appfigurate} = NativeModules;

...

let bookingDuration = await Appfigurate.nativeValue("bookingDuration"); // Number