macOS 10.13 High Sierra SDK Release Notes

Contents:

Introduction

macOS 10.13 SDK provides support for developing macOS apps. It’s packaged with a complete set of Xcode tools, compilers, and frameworks for creating apps for iOS, watchOS, tvOS, and macOS. These tools include the Xcode IDE and the Instruments analysis tool, among many others.

With this software you can develop apps for MacBook, MacBook Air, MacBook Pro, iMac, iMac Pro, Mac Pro, and Mac Mini running macOS High Sierra 10.13.

Tools and Developer Resources

You obtain Xcode 9 from the Mac App Store. It is a free download that installs directly into the Applications folder. By default, Xcode downloads developer documentation in the background for offline reading; it also automatically downloads documentation updates. This behavior can be changed after installation using the Downloads preferences pane.

The Apple Developer Program provides access to the App Store, Mac App Store, and Apple TV App Store, additional support and documentation, and signing resources for testing and deployment on Apple TV, Apple Watch, iPad, iPhone, and iPod touch devices. For more information, visit the Apple Developer Program website.

Apple provides the following web resources to support development in macOS:

Bug Reporting

For issues not mentioned in Notes and Known Issues, please file bugs through the Apple Developer website https://developer.apple.com/bug-reporting/.

When filing a bug, please include the full version number in the bug title and in the description. To find the version number, choose About this Mac from the Apple Menu, then click on the version number in the window that appears to show the full version number including the part in parenthesis. The full version number looks like 10.13 (17Axxx).

Additionally, you may discuss these issues and macOS 10.13 SDK in the Apple Developer Forums: https://forums.developer.apple.com/welcome. To get more information about iCloud for Developers, go to https://developer.apple.com/icloud.

Release Notes Updates

macOS Release Notes is sometimes updated after a release is distributed. You can check for the most up-to-date version of macOS Release Notes at the Apple Developer website by checking http://developer.apple.com/go/?id=macos-sdk-release-notes.

Revision: macOS1013 - MRN1

System Requirements

macOS 10.13 SDK supports the following Macs:

Notes and Known Issues

The following items relate to using macOS SDK to develop code.

Apple File System (APFS)

Known Issues

  • HDD and Fusion drives can't be converted to APFS. (32360337, 31851687)

  • Some third-party applications may not correctly recognize volumes that are formatted using APFS.

CloudKit

Known Issues

  • CloudKit doesn't support unsigned long long values with the high-order bit set. (30567424)

  • Applications that use CKModifyRecordsOperation should specify an appropriate value for CKModifyRecordsOperation.isAtomic. If your client is compiled against macOS 10.13, operations enqueued against the default CKRecordZone have new behavior because atomic is true by default. If the operation hits a "preflight" failure (most commonly, a network issue uploading a CKAsset, or a malformed CKRecord), the entire operation is canceled. (30838858)

Foundation

Known Issues

  • Clients of NSURLSessionStreamTask that use a non-secure connection fail to connect when an error occurs during PAC file evaluation and the system is configured for either Web Proxy Auto Discovery (WPAD) or Proxy Automatic Configuration (PAC). A PAC evaluation failure can occur when the PAC file contains invalid JavaScript or the HTTP host serving the PAC file is unreachable. (33609198)

    Workaround: Use startSecureConnection to establish a secure connection.

HEVC and HEIF Images

Known Issues

  • macOS 10.13 adds HEVC and HEIF decode capability. In order to display HEIF image files or HEVC videos captured on iOS 11, your Mac needs to be updated to macOS 10.13.

  • The specific hardware and software requirements for HEVC and HEIF are detailed in the WWDC 2017 presentations covering these new technologies. Depending on the capabilities of your Mac and the needs of your content, AVFoundation may use a software-based HEVC encoder which typically has longer encoding times.

Kernel Extension Loading

Known Issues

  • Some third-party apps may not fully handle instances where their kernel extension is denied user consent to load.

  • Kernel extensions blocked in early boot do not display an alert.

Localization

Known Issues

  • Some text may not be localized to the selected system language.

  • Some languages may have clipped or misaligned layout.

Touch Bar

Resolved Issues

  • An issue preventing the appearance of volume and brightness sliders on tap and immediate drag on the Control Strip buttons has been fixed. (29465989)

Vision

Known Issues

  • VNFaceLandmarkRegion2D is currently unavailable in Swift. (33191123)

  • Facial landmarks identified by the Vision framework may flicker in temporal use cases such as video. (32406440)