iOS SDK Release Notes for iOS 8.2 Beta 3

iOS SDK Release Notes for iOS 8.2 Beta 3

Important:

This is a preliminary document for an API or technology in development. Apple is supplying this information to help you plan for the adoption of the technologies and programming interfaces described herein for use on Apple-branded products. This information is subject to change, and software implemented according to this document should be tested with final operating system software and final documentation. Newer versions of this document may be provided with future betas of the API or technology.

Contents:

• Introduction
• Bug Reporting
• Notes and Known Issues

Introduction

iOS SDK 8.2 provides support for developing iOS apps. The SDK is packaged with a complete set of tools, compilers, and frameworks for creating apps for iOS and OS X. The tools include the Xcode IDE and the Instruments analysis tool, among many others.

With this software, you can develop apps for iPhone, iPad, or iPod touch running iOS 8. It now includes WatchKit, a framework for developing Apple Watch apps. You can test your apps using the included iOS Simulator.

iOS SDK 8.2 requires a Mac computer running OS X v10.9.3 (Mavericks) or later.

This version of iOS is intended for installation only on devices registered with the Apple Developer Program. Attempting to install this version of iOS in an unauthorized manner could put your device in an unusable state.

For more information and additional support resources, visit http://developer.apple.com/programs/ios/.

Bug Reporting

For issues not mentioned in the Notes and Known Issues section, please file bugs through the Apple Developer website (https://developer.apple.com/bug-reporting/ios/). Additionally, you may discuss these issues and iOS SDK 8.2 in the Apple Developer Forums: http://devforums.apple.com. To get more information about iCloud for Developers, go tohttp://developer.apple.com/icloud.

Notes and Known Issues

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

CloudKit

Note

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

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 the document picker to landscape, the status bar is hidden.

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

App Extensions

Notes

• App 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.

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.

Messages

Fixed in Beta 3

Your device may get into a state where tapping into Messages conversations can take a long time.

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, andNSURLSessionTaskPriorityHigh. 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 NSURLSessionTask performance.

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

Phone

Note

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.2 beta from previous 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.

WatchKit

Notes

• The WKInterfaceMap API has changed. Specifically, setMapRect: and setCoordinateRegion: have been replaced by setVisibleMapRect: and setRegion: respectively.

• The WKInterfaceController method initWithContext: has been deprecated. Please use awakeWithContext: instead. The designated initializer for WKInterfaceController is now init.

• The WKInterfaceDevice API has changed. Specifically, addCachedImage:name: and addCachedImageWithData:name: now return BOOL to indicate the success or failure of adding an image to the cache. Note that these methods return NO if the cache size has reached its limit. Delete images from the cache by calling removeCachedImageWithName: orremoveAllCachedImages.

• A page-based WatchKit app can dynamically resequence the pages at the root level using reloadRootControllersWithNames:contexts:.

• Rows in a WKInterfaceTable now have a default appearance. This appearance can be overridden by specifying the values for background color, margin, corner radius, and height for the row in Interface Builder.

Fixed in Beta 3

• In iOS Simulator, the Emoji button should now be visible, regardless of the selected input mode.

• The WKInterfaceController method openParentApplication:reply: now launches the containing app in the background when the iPhone (or iOS Simulator) is unlocked or locked.

• The WKInterfaceController method presentTextInputControllerWithSuggestions:completion: is now fully supported in iOS Simulator.

Known Issue

• Inserting, deleting, or updating rows of a WKInterfaceTable may cause the table to temporarily size incorrectly. Scrolling your interface controller should restore the table to the proper size.

Wi-Fi Calling (T-Mobile US only)

Note

The carrier name in the status bar will show “T-Mobile Wi-Fi” when the device is able to make and receive Wi-Fi calls.