Purpose Strings properties group

This group of properties is available for Main Smart Device objects and is located under the Apple/Permissions properties group.

As of iOS 10, Apple forces developers to indicate the usage reason of device features (e.g. GPS, microphone, calendar, etc.).
This decision bets in favor of the user's privacy, allowing them to choose when some feature is allowed for use or not.

The effect for the end user is a message displayed on the screen saying that the app is trying to use some feature for the reasons described by the developer.

Properties

By default, any of these properties are empty. Their values are strings indicating the purpose of usage for each feature used by the developer (it must be set).

Column value "N/A" means there is not built-in GeneXus, but can be applied if the developer implements a custom User Controls or External Objects that requires that permission.

Notes

• A warning message like this will be displayed if the developer uses location services but this property is not set.
  warning: In iOS 10.0 or later, a value for one of these properties is required when you use location services. ('% Usage Description' of <Menu|Panel> for Smart Devices instance '%')
  The iOS version may vary depending on which XCode version is used. Most of them are required as of iOS 10.0.
• As of Genexus 15 Upgrade 7 the message is similar to:
  warning: In iOS 11.0 or later, 'Location When In Use usage description' property value is required when you use location services. See descriptions of these properties: ‘Location When In Use’, 'Location Always' and 'Location Always and When In Use'.

Troubleshooting

If the appropriate Usage Description is not set, the behavior when the application is executed changes by GeneXus version because the iOS project is different:

Scope

Availability

This group of properties is available as of GeneXus X Evolution 3 upgrade 11 / GeneXus 15 upgrade 1.