6.0.0 • Published 1 year ago

@jigrawesome/jigra-managed-configurations v6.0.0

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

@jigrawesome/jigra-managed-configurations

Jigra plugin to access managed configuration settings.

Installation

npm install @jigrawesome/jigra-managed-configurations
npx jig sync

Android

See Define managed configurations and follow the instructions to declare the app's managed configurations correctly.

Configuration

No configuration required for this plugin.

Usage

import { ManagedConfigurations } from '@jigrawesome/jigra-managed-configurations';

const getString = async () => {
  const result = await ManagedConfigurations.getString({ key: 'server_url' });
  return result.value;
};

const getNumber = async () => {
  const result = await ManagedConfigurations.getNumber({ key: 'server_port' });
  return result.value;
};

const getBoolean = async () => {
  const result = await ManagedConfigurations.getBoolean({
    key: 'download_on_cellular',
  });
  return result.value;
};

API

getString(...)

getString(options: GetOptions) => Promise<GetResult<string>>

Fetches the value associated with the given key, or null if no mapping exists for the given key.

Only available on Android and iOS.

ParamType
optionsGetOptions

Returns: Promise<GetResult<string>>


getNumber(...)

getNumber(options: GetOptions) => Promise<GetResult<number>>

Fetches the value associated with the given key, or null if no mapping exists for the given key.

Only available on Android and iOS.

ParamType
optionsGetOptions

Returns: Promise<GetResult<number>>


getBoolean(...)

getBoolean(options: GetOptions) => Promise<GetResult<boolean>>

Fetches the value associated with the given key, or null if no mapping exists for the given key.

Only available on Android and iOS.

ParamType
optionsGetOptions

Returns: Promise<GetResult<boolean>>


Interfaces

GetResult

PropTypeDescription
valueT | nullThe value of the configuration entry, or null if no mapping exists for the given key.

GetOptions

PropTypeDescription
keystringUnique key for the configuration entry.

Test your implementation

On Android, see Set up device owner for testing and follow the instructions to set up a device owner testing environment.

On iOS, you need to install the app as a managed app with a MDM solution.

Changelog

See CHANGELOG.md.

License

See LICENSE.