@Retention(CLASS) @Target({TYPE})

public @interface IosPrivacy

iOS Info.plist privacy usage descriptions. Set the one for every protected resource your app touches: the build server accepts an app without them, and the App Store rejects it.

Place this on your application’s main class – the class named by codename1.mainName. An attribute you do not set is not written at all, so the build server’s own default applies. The default clause below each attribute names a constant that says nothing – see HintUnset – and this package deliberately does not record what the server would do instead, because that is the server’s to change.

The platform is stated once on the annotation, not on every attribute. An attribute repeats it only to disagree with it.

Methods

public abstract String bluetoothAlwaysUsageDescription() default ""Why the app uses Bluetooth.
public abstract String bluetoothPeripheralUsageDescription() default ""The pre-iOS 13 spelling of the Bluetooth usage description, supplied and overridable on the same terms.
public abstract String calendarsFullAccessUsageDescription() default ""The text iOS shows when the app first asks for the calendars full access.
public abstract String calendarsUsageDescription() default ""The text iOS shows when the app first asks for the calendars.
public abstract String calendarsWriteOnlyAccessUsageDescription() default ""The text iOS shows when the app first asks for the calendars write only access.
public abstract String cameraUsageDescription() default ""The text iOS shows when the app first asks for the camera.
public abstract String healthShareUsageDescription() default ""The text iOS shows when the app first asks for the health share.
public abstract String healthUpdateUsageDescription() default ""The text iOS shows when the app first asks for the health update.
public abstract String localNetworkUsageDescription() default ""The text iOS shows when the app first asks for the local network.
public abstract String locationAlwaysAndWhenInUseUsageDescription() default ""The text iOS shows when the app first asks for the location always and when in use.
public abstract String locationAlwaysUsageDescription() default ""The text iOS shows when the app first asks for the location always.
public abstract String locationWhenInUseUsageDescription() default ""The text iOS shows when the app first asks for the location when in use.
public abstract String microphoneUsageDescription() default ""The text iOS shows when the app first asks for the microphone.
public abstract String nearbyInteractionAllowOnceUsageDescription() default ""The pre-iOS 16 spelling of the nearby-interaction usage description, supplied automatically when the app references the nearby APIs.
public abstract String nearbyInteractionUsageDescription() default ""Why the app measures distance and direction to nearby devices.
public abstract String remindersFullAccessUsageDescription() default ""The text iOS shows when the app first asks for the reminders full access.
public abstract String remindersUsageDescription() default ""The text iOS shows when the app first asks for the reminders.
public abstract String speechRecognitionUsageDescription() default ""Why the app sends speech for recognition.

Method details

bluetoothAlwaysUsageDescription

public abstract String bluetoothAlwaysUsageDescription() default ""
Why the app uses Bluetooth. Supplied automatically when the app references com.codename1.bluetooth; set it to say something more specific than the default.

bluetoothPeripheralUsageDescription

public abstract String bluetoothPeripheralUsageDescription() default ""
The pre-iOS 13 spelling of the Bluetooth usage description, supplied and overridable on the same terms.

calendarsFullAccessUsageDescription

public abstract String calendarsFullAccessUsageDescription() default ""
The text iOS shows when the app first asks for the calendars full access. It becomes the NSCalendarsFullAccessUsageDescription key in Info.plist. The App Store rejects an app that touches this resource without one.

calendarsUsageDescription

public abstract String calendarsUsageDescription() default ""
The text iOS shows when the app first asks for the calendars. It becomes the NSCalendarsUsageDescription key in Info.plist. The App Store rejects an app that touches this resource without one.

calendarsWriteOnlyAccessUsageDescription

public abstract String calendarsWriteOnlyAccessUsageDescription() default ""
The text iOS shows when the app first asks for the calendars write only access. It becomes the NSCalendarsWriteOnlyAccessUsageDescription key in Info.plist. The App Store rejects an app that touches this resource without one.

cameraUsageDescription

public abstract String cameraUsageDescription() default ""
The text iOS shows when the app first asks for the camera. It becomes the NSCameraUsageDescription key in Info.plist. The App Store rejects an app that touches this resource without one.

healthShareUsageDescription

public abstract String healthShareUsageDescription() default ""
The text iOS shows when the app first asks for the health share. It becomes the NSHealthShareUsageDescription key in Info.plist. The App Store rejects an app that touches this resource without one.

healthUpdateUsageDescription

public abstract String healthUpdateUsageDescription() default ""
The text iOS shows when the app first asks for the health update. It becomes the NSHealthUpdateUsageDescription key in Info.plist. The App Store rejects an app that touches this resource without one.

localNetworkUsageDescription

public abstract String localNetworkUsageDescription() default ""
The text iOS shows when the app first asks for the local network. It becomes the NSLocalNetworkUsageDescription key in Info.plist. The App Store rejects an app that touches this resource without one.

locationAlwaysAndWhenInUseUsageDescription

public abstract String locationAlwaysAndWhenInUseUsageDescription() default ""
The text iOS shows when the app first asks for the location always and when in use. It becomes the NSLocationAlwaysAndWhenInUseUsageDescription key in Info.plist. The App Store rejects an app that touches this resource without one.

locationAlwaysUsageDescription

public abstract String locationAlwaysUsageDescription() default ""
The text iOS shows when the app first asks for the location always. It becomes the NSLocationAlwaysUsageDescription key in Info.plist. The App Store rejects an app that touches this resource without one.

locationWhenInUseUsageDescription

public abstract String locationWhenInUseUsageDescription() default ""
The text iOS shows when the app first asks for the location when in use. It becomes the NSLocationWhenInUseUsageDescription key in Info.plist. The App Store rejects an app that touches this resource without one.

microphoneUsageDescription

public abstract String microphoneUsageDescription() default ""
The text iOS shows when the app first asks for the microphone. It becomes the NSMicrophoneUsageDescription key in Info.plist. The App Store rejects an app that touches this resource without one.

nearbyInteractionAllowOnceUsageDescription

public abstract String nearbyInteractionAllowOnceUsageDescription() default ""
The pre-iOS 16 spelling of the nearby-interaction usage description, supplied automatically when the app references the nearby APIs.

nearbyInteractionUsageDescription

public abstract String nearbyInteractionUsageDescription() default ""
Why the app measures distance and direction to nearby devices. Supplied automatically when the app references the nearby APIs; set it to say something more specific than the default.

remindersFullAccessUsageDescription

public abstract String remindersFullAccessUsageDescription() default ""
The text iOS shows when the app first asks for the reminders full access. It becomes the NSRemindersFullAccessUsageDescription key in Info.plist. The App Store rejects an app that touches this resource without one.

remindersUsageDescription

public abstract String remindersUsageDescription() default ""
The text iOS shows when the app first asks for the reminders. It becomes the NSRemindersUsageDescription key in Info.plist. The App Store rejects an app that touches this resource without one.

speechRecognitionUsageDescription

public abstract String speechRecognitionUsageDescription() default ""
Why the app sends speech for recognition. Supplied automatically when the app references the speech APIs; set it to say something more specific.