Notes and Known Issues

The following issues relate to using iOS SDK 8.1.1 to develop code.

AVCapture

Known Issue

Use of the new constant, AVCaptureISOCurrent, will result in inconsistent ISO values (as observed on the ISO property) if setExposureModeCustomWithDuration:ISO:completionHandler: is called repeatedly.

CloudKit

Note

A single CKAsset instance can no longer be set as a value on multiple CKRecords.

Contacts

Note

The Address Book UI people picker has been changed for iOS 8. A new mode with new API has been added where the app does not need access to the user’s contacts and the user will not be prompted for access. A temporary copy of the selected person is returned to the app. See ABPeoplePickerNavigationController.h for more details.

See the new PeoplePicker: Picking a Person or Property sample project demonstrating usage of the new mode.

Document Providers

Notes

• Your app needs the iCloud entitlement to be able to be used as a document provider.

• The com.apple.developer.icloud-container-identifiers entitlement is required.

Known Issues

• After rotating document picker to landscape, the status bar is hidden.

• Upon bringing up document picker in landscape, the containing view may be shifted beneath the navigation bar.

Extensions

Notes

• Extensions need an arm64 slice to run on 64-bit devices. If you try to run the armv7 slice on a 64-bit device it won’t work.

• Apps need to have an arm64 slice if the bundle contains a framework that both the app and the app extension link against.

File System

Note

The file system layout of app containers has changed on disk. Rather than relying on hard-coded directory structure, use the NSSearchPathForDirectoriesInDomains function or theURLForDirectory:inDomain:appropriateForURL:create:error: method of the NSFileManager class. See Accessing Files and Directories in File System Programming Guide.

Fonts

Note

The Thai system font has increased in size to improve readability. This will cause clipping in many places in your UI if you don’t take appropriate action:

1. Use UILabel as much as possible. If you use Interface Builder, make sure that Clip Subviews is not checked. UIKit will grow the clipping region as necessary to not clip text.

2. Use Dynamic Type. This will ensure that you do not have overlapping glyphs in multiline labels or text fields.

If you can’t do 1 and 2 because you implement your own views, you must implement measures not to clip. You can use CoreText to figure out the appropriate clipping region for a line of text by calling:

CTLineGetBoundsWithOptions(lineRef, kCTLineBoundsIncludeLanguageExtents);

To avoid overlapping glyphs in multiline text elements, adjust the line height. An additional 30% is recommended.

This measure will also help your app perform better in other languages, including Arabic, Hindi, and Vietnamese.

HealthKit

Note

Code that attempts to read workout information in HealthKit may be unable to make subsequent queries to HealthKit.

If you are using HKWorkouts you should avoid reading workouts when running on iOS versions prior to 8.1 with:

NSOperatingSystemVersion ios8_1_0 = (NSOperatingSystemVersion){8, 1, 0};

if ([[NSProcessInfo processInfo] isOperatingSystemAtLeastVersion:ios8_1_0]) {

// Read and write workout information to HealthKit.

} else {

// Write workout information to HealthKit

}

Known Issue

Blood glucose data is currently not displayed in the Health app. 3rd party access and APIs are not affected. Access controls for Blood Glucose and all other Health data can still be managed in the Health app and in Settings > Privacy > Health.

For more information, see https://support.apple.com/kb/HT6533.

iCloud

Note

Mail handoff and AirDrop may stop working after changing your iCloud password at appleid.apple.com.

Workaround: Sign out and back into iCloud on the device.

iCloud Drive

Note

URLForUbiquityContainerIdentifier: might return nil when running your application in Xcode. If so, open System Preferences, navigate to iCloud > iCloud Drive, and enable Xcode.

Keyboards

Known Issue

Additional Keyboards, including 3rd party keyboards, may not appear in Safari, Maps or 3rd party apps on the Simulator.

Workaround: Keyboards should be testable in Calendar, Spotlight, Contacts, and Photos.

Notification Center

Note

The schedule and intended use of widgetPerformUpdateWithCompletionHandler: is intended as a convenient home for all data/model update logic. If implemented, the system will call at opportune times for the widget to update its state, both when Notification Center is visible, as well as in the background. An implementation is required to enable background updates. It’s expected that the widget will perform the work to update asynchronously and off the main thread as much as possible. Widgets should call the argument block when the work is complete, passing the appropriate NCUpdateResult. Widgets should NOT block returning from viewWillAppear: on the results of this operation. Instead, widgets should load cached state in viewWillAppear: in order to match the state of the view from the last viewWillDisappear:, then transition smoothly to the new data when it arrives.

NSURLSession

Note

The NSURLSessionTask class provides a new “priority” property with three associated constants: NSURLSessionTaskPriorityDefault, NSURLSessionTaskPriorityLow, and NSURLSessionTaskPriorityHigh.NSURLSessionTask priorities can be used to specify how multiple requests and responses to the same host should be prioritized. Note that the priority is a hint and not a strict guarantee of NSURLSessionTaskperformance.

For complete usage details of NSURLSessionTask priorities, refer to the NSURLSession.h header file, which is provided by the Foundation framework.

Phone

Notes

To activate Wi-Fi Calling functionality for T-Mobile (U.S. only), follow these steps:

• Go to Settings > Phone > Wi-Fi Calling.

• Toggle the Wi-Fi Calling switch to ON.

• If the carrier does not have the user’s registered emergency address, you will be asked to add it before the feature is activated.

Photos

Notes

• Maintain a backup of your photo library before enabling and while using iCloud Photo Library beta by:

  • Importing to your Mac using iPhoto

  • Importing to your Mac using Image Capture

• iCloud Photo Library beta will not download photos and videos that were synced to your device from iTunes. Any photos and videos synced to your device from iTunes will be removed when you enable iCloud Photo Library beta.

• iPhoto for iOS will not launch on iOS 8 Beta. Launching Photos.app will migrate your iPhoto edits to the iOS 8 Photo Library. Make sure your iPhoto for iOS data is included in your device backup.

• The ability to automatically optimize device space is enabled for all accounts larger than 5GB.

• When using iCloud Family Sharing, both iCloud Photo Sharing and My Photo Stream are enabled.

Provisioning Profiles

Known Issue

If you have upgraded to the 8.1.1 Beta from iOS 8 Betas you may see your apps crashing due to provisioning profile issues.

Workaround:

1. Connect the device via USB to your Mac

2. Launch Xcode

3. Choose Window -> Devices

4. Right click on the device in left column, choose “Show Provisioning Profiles”

5. Click on the provisioning profile in question

6. Press the “-” button

7. Continue to removing all affected profiles.

8. Re-install the app

UIKit

Notes

• UILabel has a default value of YES for clipsToBounds. This differs from the normal UIView default of NO.

• The leftLayoutGuide and rightLayoutGuide APIs have been removed. Please use the layoutMargins property instead.

WebKit

Notes

The Navigation Timing API has been disabled only on iOS due to performance issues.