Settings profiles offer ways to customize how SDK-built apps look. These profiles also manage app logs and analytics for troubleshooting and analysis.

Navigation

Find settings in Groups & Settings > All Settings > Apps > Settings and Policies > Settings.

The default SDK policies for Settings control branding, logging, analytics, and custom settings.

Branding

Change the look and feel of applications to reflect the unique brand of your company with Branding settings when you configure the app to use the default SDK settings.
Setting Description
Colors Reflect your company colors by choosing colors for the Workspace ONE UEM console from the color palette beside the color options.

Choose primary and secondary colors listed options including tool bars and text.
Organization Name Enter the name that represents your organization to display in the Workspace ONE UEM system.
Device Backgrounds Upload images that the system displays as the background and as the logo for the organization on the listed device types.
  • Apple iOS options
    • Background Image iPhone
    • Background Image iPhone (Retina)
    • Background Image iPhone 5 (Retina)
    • Background Image iPad

    • Background Image iPad (Retina)

  • Android options
    • Background Image Small
    • Background Image Medium
    • Background Image Large
    • Background Image Extra Large
  • Platform neutral options
    • Company Logo Phone
    • Company Logo Phone High Res
    • Company Logo Tablet
    • Company Logo Tablet High Resolution

Branding - Splash Screens

It is difficult to find a single image that displays perfectly on every mobile device. However, certain dimensions for images displayed on iOS and Android devices can work for most displays. Use these specifications for application splash screens.

  • Mobile - iOS
    • Icon, centered - 160 x 160 pixels
    • Branded text distance from icon – centered at a distance of 24 pixels
    • Branded text – 27 point
    • Margins - 72 pixels
    Figure 1. Example Splash Screen Specifications
    Use the specified splash screen attributes when creating images to use in the branding feature for your Workspace ONE SDK built apps for the mobile iOS platform.
  • Tablet, Portrait - iOS
    • Icon - 160 x 160 pixels
    • Branded text distance from icon – centered at a distance of 24 pixels
    • Branded text – 27 point
    • Margins - 264 pixels
  • Tablet, Landscape - iOS
    • Icon - 160 x 160 pixels
    • Branded text distance from icon – centered at a distance of 24 pixels
    • Branded text – 27 point
    • Margins - 56 pixels
  • Mobile - Android
    • Icon - 160 x 160 pixels
    • Branded text distance from icon – centered at a distance of 24 pixels
    • Branded text – 27 point
    • Margins - 56 pixels
  • Tablet, Portrait - Android
    • Icon - 160 x 160 pixels
    • Branded text distance from icon – centered at a distance of 24 pixels
    • Branded text – 27 point
    • Margins - 260 pixels
  • Tablet, Landscape - Android
    • Icon - 160 x 160 pixels
    • Branded text distance from icon – centered at a distance of 24 pixels
    • Branded text – 27 point
    • Margins - 388 pixels

Logging

The Workspace ONE UEM system collects logs until the log file size reaches 200 MB for SaaS environments. If the log size exceeds 200 MB, the system stops collecting logs. The Workspace ONE UEM console notifies you when your application log size reaches 75% of 200 MB. To act on the application log size, contact your Workspace ONE UEM Representative.
  • Ask for an increase in your application log size.
  • Ask for a purge of your application log. The system can purge logs older than two weeks.

The Workspace ONE UEM console reports the messages that match the configured logging level plus any logs with a higher critical status. For example, if you set the logging level to Warning, messages with a Warning and Error level display in the Workspace ONE UEM console.

The SDK-built application collects logs over time and stores them locally on the device until another API or command is invoked to transmit the logs.
Note: When an enterprise wipe occurs, the console does not purge the log files. You can retrieve logs after a device re-enrolls to determine what issues occurred in the last enrollment session to cause the enterprise wipe.
Table 1. SDK Logging Level APIs and Level Descriptions
Level Logging API Description
Error AWLogError("{log message}") Records only errors. An error displays failures in processes such as a failure to look up UIDs or an unsupported URL.
Warning AWLogWarning("{log message}") Records errors and warnings. A warning displays a possible issue with processes such as bad response codes and invalid token authentications.
Information AWLogInfo("{log message}") Records a significant amount of data for informational purposes. An information logging level displays general processes, warning, and error messages.
Debug or Verbose AWLogVerbose("{log message}") Records all data to help with troubleshooting. This option is not available for all functions.

Analytics

Use SDK analytics to view how many times a file or an application has been opened and how long the file or application remained open. These statistics offer a quick view of which end users have downloaded and viewed high-priority content.

Display events for applications that use SDK functionality. Workspace ONE UEM reports event analytics by the application ID and event name. These events are custom created and developers can code any process or behavior they want to track. Find them in Apps & Books > Applications > Logging > SDK Analytics.

Custom Settings

Use Custom Settings to enter XML code. This XML code allows you to activate or deactivate certain settings, manually. You can add custom features to your environment to support the unique needs of your mobile network. For the most current list of the supported lookup values for custom settings, select the Insert Lookup icon, the plus sign (+), next to the text box.