oracle / cordova-plugin-emm-app-config Goto Github PK

Cordova Plugin for EMM App Config

License: Other

Java 38.46% Objective-C 21.88% JavaScript 39.65%

cordova-plugin-emm-app-config's Introduction

cordova-plugin-emm-app-config 1.0.2

This plugin defines a global cordova.plugins.EmmAppConfig object, which provides information on EMM application configuration (or managed app configuration). Although the object is in the global scope, it is not available until after the deviceready event.

document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
    console.log(cordova.plugins.EmmAppConfig.getValue("serverURL"));
}

Installation

cordova plugin add cordova-plugin-emm-app-config

Methods

getValue
registerChangedListener

getValue

Get value from the application configuration.

Note that even though some EMM vendors may allow date and/or binary data to be specified in application configuration, date and binary data types are not supported by this plugin due to limitation on passing these types of data to Javascript. To work around this limitation, date and binary data can be encoded and specified as strings in the application configuration. The application can then decode them accordingly.

Parameter:

configKey: Key of the value to get, or null to get all the values as an object.

registerChangedListener

Information about what has changed is not available. The listener should call getValue to get the current values and decide how to handle any change. It is also possible that the same change will invoke the listener more than once.

On Android, application configuration is stored as restrictions. On iOS, application configuration is stored in standardUserDefaults. Any change to those storage areas will invoke the listener, even if the change is not within application configuration.

Parameter:

listener: The function that will be invoked when the application configuration is changed.

Supported Platforms

Android
iOS

More Info

For information on how each OS supports managed app configuration:

Android Developer Guide on Managed Configurations

iOS Developer Guide on Managed App Configuration

For information on implementing various EMM features, including managed app configuration:

AppConfig Community

Contributing

This is an open source project maintained by Oracle Corp. Pull Requests are currently not being accepted. See CONTRIBUTING for details.

License

cordova-plugin-emm-app-config's People

Contributors

Stargazers

Watchers

Forkers

mrtechgadget kashibr 37ch4 garettrogers msxi-gts derickwarshaw mi-corporation m-abozaid shanlin2dltk naikvenu hatimox classicvalues isabella232

cordova-plugin-emm-app-config's Issues

Somehow, it doesn't work for Android

I am using ionic2 with your plugin. We are using airwatch in our enterprise.

We published our code to Google Play, set as internal access only. We saw an error message "This app doesn't support app configuration", when we tried to enable "Send Application Configuration" from the airwatch console. ( the same exact code works for iOS).

Also I checked my config.xml file, the version is: ~1.0.1 Does that matter? I tried to do:
cordova plugin rmv cordova-plugin-emm-app-config and
cordova plugin add cordova-plugin-emm-app-config
but I still get version 1.0.1.. I even tried cordova plugin add [email protected]

Could anyone please help me?
We have been running out all the solutions...

Thank you
George

Does this plugin work for Mobileiron EMM besides Airwatch?

Does this plugin work for Mobileiron EMM besides Airwatch? It is not clear to me in the description.

Browser is crashing.

Hi everyone,

is use this plugin successful. But if i start my application for Browser, its crashing. i have a hybrid app for ios/android/web.

I get this error:

Error: exec proxy not found for :: EmmAPpConfig :: getConfigInfo
[ERROR] Error from EmmAppConfig.getConfigInfo: Missing Command Error

I know that is only supported for smartphones. But i use the web app for other stuff. This plugin is for me to handle smartphone stuff. Have anybody an idea?

thanks..

Ios platform ready

when i install the plugin the app is not triggering the device ready method or ionic platform ready

App does not load on android 4.4.2

I'm using your plugin in our app and it works very good, Thanks.
I do have an issue with older android versions. Our app does not startup (blank screen) and shows the 'deviceready has not fired after 5 seconds.' error (see code below) after removing this plugin it works the app works again. Is this a known issue or can you help me resolving this? Our customors can not use our app anymore. I tested this on Samsung S4 mini and Samsung Tab SM-T310.

Kind regards, Hugo

window.setTimeout(function() {
if (channel.onDeviceReady.state != 2) {
console.log('deviceready has not fired after 5 seconds.');
logUnfiredChannels(platformInitChannelsArray);
logUnfiredChannels(channel.deviceReadyChannelsArray);
}
}, 5000);

Causes Windows app not to start

From what I can tell, this line:
channel.waitForInitialization('onEmmAppConfigReady');

Will cause Windows apps never to startup. I realize the plugin doesn't support Windows, and that's fine, but bringing it into a project that's designed for cross platform creates a problem here.

Suggested fix would be to just bail on the channel creation/wait if we're running on Windows platform.