AppGallery Manager

Note: To display only the features present on a particular device, select one or more filters from the SmartDocs bar below.

StageNow - 4.0

Overview

NOTICE: The AppGallery client app is discontinued. Devices running Android 8.x Oreo no longer include the client app. Attempts to use the AppGallery Manager CSP on a device without the app result in failure.

AppGalleryMgr enables administrators to remotely configure the AppGallery client app on a device using Zebra StageNow or a third-party Mobile Device Management (MDM) solution with Zebra MDM Toolkit. AppGallery is an enterprise infrastructure provided by Zebra to organizations allowing them to deploy, distribute and maintain applications for internal use or for sale to the general public.

Main Functionality

  • Enable/disable the AppGallery client app on a device
  • Enable/disable client-app notifications
  • Limit client access to apps authorized by an organization
  • Enter a user name and password
  • Set client app to use default credentials
  • Persist settings following an enterprise device reset

AppGallery Enable/Disable

This is the on/off switch for the AppGallery client app on the device. Disabling AppGallery removes its icon from the Android Launcher but does not remove the app itself; it can be switched on and off as desired and will retain all prior settings, including user credentials. Note: Client settings persist following an enterprise reset.

Parm Name: State

Option Name Description Note Requires
0 Do Not Change This value (or the absence of this parm from the XML) will cause no changes; any previously selected setting will be retained.

MX: 6.0+

1 Turn On Enables the AppGallery client app on the device.

MX: 6.0+

2 Turn Off Disables the AppGallery client app on the device.

MX: 6.0+

Use Default Credentials

Used to enable/disable the default log-in credentials built into the AppGallery client app. This allows access only to apps in the public marketplace. To configure a device for access to private apps and collections, see Set Credentials and Organization Key.

Shown if: AppGallery Client State is set to "Turn On"

Parm Name: UseDefaultCreds

Option Name Description Note Requires
0 Do Not Change This value (or the absence of this parm from the XML) will cause no changes; any previously selected setting will be retained.

MX: 6.0+

1 Turn On Enables the AppGallery client app to accept default log-in credentials.

MX: 6.0+

2 Turn Off Prevents the AppGallery client app from accepting default log-in credentials.

MX: 6.0+

Set Credentials

Used to enable/disable the setting of log-in credentials for a device. Enable this parameter to provision a device with a new User Name and Password corresponding to an account on the AppGallery server. Such credentials are required for access to private app collections. User credentials persist following an enterprise reset.

Shown if: AppGallery Client State is set to "Turn On" and Use Default Credentials is set to "Disable"

Parm Name: SetCredentials

Option Name Description Note Requires
0 Do Not Change This value (or the absence of this parm from the XML) will cause no changes; any previously selected setting will be retained.

MX: 6.0+

1 Turn On Enables an administrator to set log-in credentials for the device.

MX: 6.0+

2 Turn Off Disables the setting of log-in credentials for the device.

MX: 6.0+

User Name

Used to enter a User Name, which must correspond with a user account configured on the AppGallery server. The User Name (with corresponding Password and Organization Key) enables AppGallery on the device to access private apps and collections made available by the organization. AppGallery can otherwise access only public-facing marketplace apps.

Parm value input rules:

  • String containing the User Name as it appears in the Admin screen
  • The minimum length is 1 character

Shown if: Set Credentials is set to "Enable" and Use Default Credentials is set to "Disable"

Parm Name: Username

Requires:

  • MX: 6.0+

Password

Used to enter a user Password, which must correspond with a user account configured on the AppGallery server. The Password (with corresponding User Name and Organization Key) enables AppGallery on the device to access private apps and collections made available by the organization.

Parm value input rules:

  • String containing the Password as it appears in the Admin screen (hidden on the client)
  • The minimum length is 8 characters

Shown if: Set Credentials is set to "Enable" and Use Default Credentials is set to "Disable"

Parm Name: Password

Requires:

  • MX: 6.0+

Organization Key

Used to enter the Organization Key, which is found on the administrator's Profile page of the AppGallery server. Copy this value and paste it into the field; the value will remain hidden on the client. Use of this key will prevent the AppGallery client from viewing any apps or collections other than those designated by the administrator.

Parm value input rules:

  • String containing the Organization Key copied from the AppGallery administrator Profile page

Shown if: Set Credentials is set to "Enable" and Use Default Credentials is set to "Disable"

Parm Name: OrganizationKey

Requires:

  • MX: 6.0+

Notifications Enable/Disable

Used to enable/disable AppGallery client Notifications on the device. Notifications are user-configurable beeps, vibrations and/or pop-ups that alert the user of updates and other events relating to AppGallery apps currently in use or that they have been invited to use.

Shown if: AppGallery Client State is set to "Turn On"

Parm Name: Notifications

Option Name Description Note Requires
0 Do Not Change This value (or the absence of this parm from the XML) will cause no changes; any previously selected setting will be retained.

MX: 6.0+

1 Turn On Enables AppGallery client Notifications on the device.

MX: 6.0+

2 Turn Off Disables AppGallery client Notifications on the device.

MX: 6.0+