OpenGL ES iOS Device Compatibility

Device Compatibility

The information property list (Info.plist) file contains critical information about your app’s configuration and must be included in your app bundle. Every new project you create in Xcode has a default Info.plist file configured with some basic information about your project. You can modify this file to specify additional configuration details for your app.

The UIRequiredDeviceCapabilities key lets you declare the hardware or specific capabilities that your app needs in order to run. All apps are required to have this key in their Info.plist file. The App Store uses the contents of this key to prevent users from downloading your app onto a device that cannot possibly run it. The tables in this chapter show all iOS devices and their capabilities.

Important: All device requirement changes must be made when you submit an update to your binary. You are permitted only to expand your device requirements. Submitting an update to your binary to restrict your device requirements is not permitted. You are unable to restrict device requirements because this action will keep customers who have previously downloaded your app from running new updates.

Important: If you require a capability listed in bold, you must build your app as a fat binary (armv6 and armv7) or require a minimum iOS version of 4.3 or later. See the individual device tables for a specific key requirement.

Declaring the Required Device Capabilities

The value of the UIRequiredDeviceCapabilities key is either an array or a dictionary that contains additional keys identifying features your app requires (or specifically prohibits). If you specify the value of the key using an array, the presence of a key indicates that the feature is required; the absence of a key indicates that the feature is not required and that the app can run without it. If you specify a dictionary instead, each key in the dictionary must have a Boolean value that indicates whether the feature is required or prohibited. A value of true indicates the feature is required and a value offalse indicates that the feature must not be present on the device. If a given capability is optional for your app, do not include the corresponding key in the dictionary.

Table 1-1 lists the keys that you can include in the array or dictionary for the UIRequiredDeviceCapabilities key. You should include keys only for the features that your app absolutely requires. If your app can run without a specific feature, do not include the corresponding key.

Table 1-1  Dictionary keys for the UIRequiredDeviceCapabilities key

Key

Description

Minimum iOS Required

accelerometer

Include this key if your app requires (or specifically prohibits) the presence of accelerometers on the device. Apps use the Core Motion framework to receive accelerometer events. You do not need to include this key if your app detects only device orientation changes.

iOS 3.0

armv6

Include this key if your app is compiled only for the armv6 instruction set.

iOS 2.0

armv7

Include this key if your app is compiled only for the armv7 instruction set.

iOS 3.1

auto-focus-camera

Include this key if your app requires (or specifically prohibits) autofocus capabilities in the device’s still camera. Although most developers should not need to include this key, you might include it if your app supports macro photography or requires sharper images in order to perform some sort of image processing.

iOS 3.0

bluetooth-le

Include this key if your app requires (or specifically prohibits) the presence of Bluetooth low-energy hardware on the device.

iOS 5.0

camera-flash

Include this key if your app requires (or specifically prohibits) the presence of a camera flash for taking pictures or shooting video. Apps use the UIImagePickerController interface to control the enabling of this feature.

iOS 3.0

front-facing-camera

Include this key if your app requires (or specifically prohibits) the presence of a forward-facing camera. Apps use theUIImagePickerController interface to capture video from the device’s camera.

iOS 3.0

gamekit

Include this key if your app requires (or specifically prohibits) Game Center.

iOS 4.1

gps

Include this key if your app requires (or specifically prohibits) the presence of GPS (or AGPS) hardware when tracking locations. (You should include this key only if you need the higher accuracy offered by GPS hardware.) If you include this key, you should also include the location-services key. You should require GPS only if your app needs location data more accurate than the cellular or Wi-fi radios might otherwise provide.

iOS 3.0

gyroscope

Include this key if your app requires (or specifically prohibits) the presence of a gyroscope on the device. Apps use the Core Motion framework to retrieve information from gyroscope hardware.

iOS 3.0

healthkit

Include this key if your app requires (or specifically prohibits) HealthKit.

iOS 8.0

location-services

Include this key if your app requires (or specifically prohibits) the ability to retrieve the device’s current location using the Core Location framework. (This key refers to the general location services feature. If you specifically need GPS-level accuracy, you should also include the gps key.)

iOS 3.0

magnetometer

Include this key if your app requires (or specifically prohibits) the presence of magnetometer hardware. Apps use this hardware to receive heading-related events through the Core Location framework.

iOS 3.0

metal

Include this key if your app requires (or specifically prohibits) Metal.

iOS 8.0

microphone

Include this key if your app uses the built-in microphone or supports accessories that provide a microphone.

iOS 3.0

opengles-1

Include this key if your app requires (or specifically prohibits) the presence of the OpenGL ES 1.1 interfaces.

iOS 3.0

opengles-2

Include this key if your app requires (or specifically prohibits) the presence of the OpenGL ES 2.0 interfaces.

iOS 3.0

opengles-3

Include this key if your app requires (or specifically prohibits) the presence of the OpenGL ES 3.0 interfaces.

iOS 7.0

peer-peer

Include this key if your app requires (or specifically prohibits) peer-to-peer connectivity over a Bluetooth network.

iOS 3.1

sms

Include this key if your app requires (or specifically prohibits) the presence of the Messages app. You might require this feature if your app opens URLs with the sms scheme.

iOS 3.0

still-camera

Include this key if your app requires (or specifically prohibits) the presence of a camera on the device. Apps use theUIImagePickerController interface to capture images from the device’s still camera.

iOS 3.0

telephony

Include this key if your app requires (or specifically prohibits) the presence of the Phone app. You might require this feature if your app opens URLs with the tel scheme.

iOS 3.0

video-camera

Include this key if your app requires (or specifically prohibits) the presence of a camera with video capabilities on the device. Apps use the UIImagePickerController interface to capture video from the device’s camera.

iOS 3.0

wifi

Include this key if your app requires (or specifically prohibits) access to the networking features of the device.

iOS 3.0

For detailed information on how to create and edit property lists, see Information Property List Key Reference.

iPhone Devices

Table 1-2 and Table 1-3 list the capabilities for iPhone devices.

Table 1-2  iPhone 4, iPhone 5, and iPhone 6 device compatibility

Compatibility

iPhone 4

iPhone 4s

iPhone 5

iPhone 5c

iPhone 5s

iPhone 6

iPhone 6 Plus

accelerometer

X

X

X

X

X

X

X

armv6

X

X

X

X

X

X

X

armv7

X

X

X

X

X

X

X

auto-focus-camera

X

X

X

X

X

X

X

bluetooth-le

 

X

X

X

X

X

X

camera-flash

X

X

X

X

X

X

X

front-facing-camera

X

X

X

X

X

X

X

gamekit

X

X

X

X

X

X

X

gps

X

X

X

X

X

X

X

gyroscope

X

X

X

X

X

X

X

healthkit

X

X

X

X

X

X

location-services

X

X

X

X

X

X

X

magnetometer

X

X

X

X

X

X

X

metal

X

X

X

microphone

X

X

X

X

X

X

X

opengles-1

X

X

X

X

X

X

X

opengles-2

X

X

X

X

X

X

X

opengles-3

X

X

X

peer-peer

X

X

X

X

X

X

X

sms

X

X

X

X

X

X

X

still-camera

X

X

X

X

X

X

X

telephony

X

X

X

X

X

X

X

video-camera

X

X

X

X

X

X

X

wifi

X

X

X

X

X

X

X

Table 1-3  iPhone and iPhone 3G device compatibility

Compatibility

iPhone

iPhone 3G

iPhone 3GS

iPhone 3GS (China)

accelerometer

X

X

X

X

armv6

X

X

X

X

armv7

X

X

auto-focus-camera

 

 

X

X

bluetooth-le

 

 

 

 

camera-flash

 

 

 

 

front-facing-camera

 

 

 

 

gamekit

X

X

gps

 

X

X

X

gyroscope

 

 

 

 

healthkit

location-services

X

X

X

X

magnetometer

X

X

metal

microphone

X

X

X

X

opengles-1

X

X

X

X

opengles-2

X

X

opengles-3

peer-peer

X

X

X

sms

X

X

X

X

still-camera

X

X

X

X

telephony

X

X

X

X

video-camera

 

 

X

X

wifi

X

X

X

iPad Devices

Table 1-4 and Table 1-5, and Table 1-6 list the capabilities for iPad devices.

Table 1-4  iPad (4th generation), and iPad Air device compatibility

Compatibility

iPad

Wi-Fi

(4th gen)

iPad

Wi-Fi + Cellular

(4th gen)

iPad Air

Wi-Fi

iPad Air

Wi-Fi + Cellular

iPad Air 2

Wi-Fi

iPad Air 2

Wi-Fi + Cellular

accelerometer

X

X

X

X

X

X

armv6

X

X

X

X

X

X

armv7

X

X

X

X

X

X

auto-focus-camera

X

X

X

X

X

X

bluetooth-le

X

X

X

X

X

X

camera-flash

front-facing-camera

X

X

X

X

X

X

gamekit

X

X

X

X

X

X

gps

X

X

X

gyroscope

X

X

X

X

X

X

healthkit

location-services

X

X

X

X

X

X

magnetometer

X

X

X

X

X

X

metal

X

X

X

X

microphone

X

X

X

X

X

X

opengles-1

X

X

X

X

X

X

opengles-2

X

X

X

X

X

X

opengles-3

X

X

X

X

peer-peer

X

X

X

X

X

X

sms

still-camera

X

X

X

X

X

X

telephony

video-camera

X

X

X

X

X

X

wifi

X

X

X

X

X

X

Table 1-5  iPad mini device compatibility

Compatibility

iPad mini

Wi-Fi

iPad mini

Wi-Fi + Cellular

iPad mini 2

Wi-Fi

iPad mini 2

Wi-Fi + Cellular

iPad mini 3

Wi-Fi

iPad mini 3

Wi-Fi + Cellular

accelerometer

X

X

X

X

X

X

armv6

X

X

X

X

X

X

armv7

X

X

X

X

X

X

auto-focus-camera

X

X

X

X

X

X

bluetooth-le

X

X

X

X

X

X

camera-flash

 

 

front-facing-camera

X

X

X

X

X

X

gamekit

X

X

X

X

X

X

gps

 

X

X

X

gyroscope

X

X

X

X

X

X

healthkit

location-services

X

X

X

X

X

X

magnetometer

X

X

X

X

X

X

metal

X

X

X

X

microphone

X

X

X

X

X

X

opengles-1

X

X

X

X

X

X

opengles-2

X

X

X

X

X

X

opengles-3

X

X

X

X

peer-peer

X

X

X

X

X

X

sms

still-camera

X

X

X

X

X

X

telephony

video-camera

X

X

X

X

X

X

wifi

X

X

X

X

X

X

Table 1-6  iPad 1, iPad 2, and iPad (3rd generation) device compatibility

Compatibility

iPad

Wi-Fi

iPad

Wi-Fi + 3G

iPad 2

Wi-Fi

iPad 2

Wi-Fi + 3G

iPad

Wi-Fi

(3rd gen)

iPad

Wi-Fi + Cellular

(3rd gen)

accelerometer

X

X

X

X

X

X

armv6

X

X

X

X

X

X

armv7

X

X

X

X

X

X

auto-focus-camera

 

 

 

 

X

X

bluetooth-le

 

 

 

 

X

X

camera-flash

 

 

 

 

front-facing-camera

 

 

X

X

X

X

gamekit

X

X

X

X

X

X

gps

 

X

 

X

X

gyroscope

 

 

X

X

X

X

healthkit

location-services

X

X

X

X

X

X

magnetometer

X

X

X

X

X

X

metal

microphone

X

X

X

X

X

X

opengles-1

X

X

X

X

X

X

opengles-2

X

X

X

X

X

X

opengles-3

peer-peer

X

X

X

X

X

X

sms

still-camera

X

X

X

X

telephony

video-camera

 

 

X

X

X

X

wifi

X

X

X

X

X

X

iPod Touch Devices

Table 1-7 list the capabilities for iPod touch devices.

Table 1-7  iPod touch device compatibility

Compatibility

iPod touch

iPod touch

2nd gen

iPod touch

3rd gen

iPod touch

4th gen

iPod touch

5th gen

iPod touch

5th gen 16GB (no rear-facing camera)

accelerometer

X

X

X

X

X

X

armv6

X

X

X

X

X

X

armv7

X

X

X

X

auto-focus-camera

 

 

 

 

X

 

bluetooth-le

 

 

 

 

X

X

camera-flash

 

 

 

 

X

 

front-facing-camera

 

 

 

X

X

X

gamekit

X

X

X

X

X

gps

 

 

 

 

gyroscope

 

 

 

X

X

X

healthkit

X

X

location-services

X

X

X

X

X

X

magnetometer

metal

microphone

X

X

X

X

X

opengles-1

X

X

X

X

X

X

opengles-2

X

X

X

X

opengles-3

peer-peer

X

X

X

X

X

sms

still-camera

X

X

telephony

video-camera

 

 

 

X

X

wifi

X

X

X

X

X

X

NextPrevious