macOS 10.15 Beta Release Notes

本文首发于 2019-06-18

翻译自： macOS Catalina 10.15 Beta Release Notes
https://developer.apple.com/documentation/macos_release_notes/macos_catalina_10_15_beta_release_notes?language=objc

很多内容个人开发中没有涉及，难免错漏，欢迎指正。

后记：

macOS beta 1 发布于 19 年 6 月 4 日

beta 2 发布于 6 月 18 日，解决了 beta 1 的一些问题，也新增了一些特性，翻译见：
https://blog.csdn.net/lovechris00/article/details/93973835

General

New Features

Installing third party kernel extensions now requires that you restart your Mac before they’re permitted to load. (50340461)

安装第三方内核插件需要重启电脑

Known Issues

Migration Assistant is currently unable to correctly migrate data from a Mac running macOS 10.15 to another Mac running macOS 10.15. (50894629)

迁移助理 Migration Assistant 无法正确在 10.15 的Mac 之间迁移
WarningYour Secure Token might be lost if FileVault is enabled on a non-APFS formatted volume while upgrading to macOS 10.15. You might be able to work around this by disabling FileVault before upgrading to macOS 10.15, then reenabling FileVault once the upgrade has completed. (51091312)
During installation of macOS 10.15 you might be prompted to enter your administrator password multiple times to allow installation to proceed. (51206649)

安装 10.15 可能需要多次输入管理员密码
macOS 10.15 cannot be installed onto an encrypted volume unless it is already in the APFS format. (51127640)

macOS 10.15 无法安装进加密的卷宗，除非它已经是 APFS 格式。
During upgrades to macOS 10.15, files and folders stored at the root-level of a volume are moved aside to /Library/SystemMigration/History/Migration-UUID/QuarantineRoot/. (45378791)

在升级到 macOS 10.15 过程中，以 root 级别储存的文件和文件夹被移动到 /Library/SystemMigration/History/Migration-UUID/QuarantineRoot/。
If your Mac currently has macOS 10.10 or earlier installed, you must first upgrade to macOS Mojave 10.14 before upgrading to macOS 10.15. (50181382)

如果你的电脑版本是 10.10 及以前，需要升级到 10.14，才能升级到 10.15；
如果当前系统版本是 10.9，升级到 10.15 的过程中，可能会多次中断退出。
The Install macOS 10.15 app might quit unexpectedly when run on macOS 10.9. (50868081)

在运行 10.9 系统的 macOS 上安装 10.15 可能会意外退出。
On Macs with the Apple T2 Security Chip, if you’ve used Startup Security Utility to lower Secure Boot to Medium Security or No Security, you’re currently unable to modify Secure Boot settings after upgrading to macOS 10.15. (51043128)

Workaround: Set Secure Boot to Full Security before upgrading to macOS 10.15. Alternatively, disabling and reenabling FileVault might resolve the issue.

在带有苹果 T2安全芯片的 Mac 上，如果你使用启动加密工具来降低加密引导到中级加密状态或不加密状态，在升级到 10.15 后可能无法调整加密引导。
建议在升级到 10.15后，将加密引导调整到全加密 Full Security。否则，取消或重启 FileVault 可以解决这个问题。
Some apps might not automatically relaunch after installation or updating and must be manually relaunched. (51228752)

Deprecations

macOS frameworks are now thinned for the x86-64 architecture. Apps that execute i386 code now fail with the EBADARCH error code. The remaining stub frameworks are nonfunctional and exist only for compatibility purposes. (51236070)

macOS 框架精简为只支持 x86-64 。使用 i386 的应用，会报错 EBADARCH。
剩下的相关框架，将无效，或者只做兼容性的目的。

Accessibility

Known Issues

On Macs with the Apple T2 Security Chip, VoiceOver is currently unavailable while in macOS Recovery. (49870874)

在使用 T2 Security Chip 的电脑上，macOS 恢复时，VoiceOver 无法使用。

Apple CryptoKit

Known Issues

当使用SecureEnclave API 来获取钥匙的访问权限，用户可能不会授权。这将导致一些列的获取权限的操作失败。

When using the SecureEnclave API with access control set on keys, users might not be prompted to authenticate. This might cause subsequent operations requiring authentication to fail. (51279188)

Apple File System (APFS)

Known Issues

Important

融合卷宗不能有卷复制操作，无论是作为源还是目标。

Volume replication shouldn’t be used with Fusion volumes, either as a source or destination. (51114645)

Apple TV

Known Issues

Support for signing in with an account from a different country is currently unavailable. (51240948)

不支持在不同国家登陆账户。
Navigating using the back button might produce unexpected results. (51207403)

使用返回按钮导航，可能会产生意想不到的结果。
Support for Dolby Atmos content and downloads is currently unavailable. (51050344)

目前不支持杜比全景声（Dolby Atmos ）内容的下载。
The option to show only offline downloads is currently unavailable. (50997542)

目前没有只展示离线下载的功能。
Apple TV might not remember the previously selected tab when it’s relaunched. (50922604)

Apple TV 重启后，可能不记得上次选中的 tab。

Audio

New Features

You can now enable voice processing mode on AVAudioEngine. (50906329)

你可以通过 AVAudioEngine 使用音频处理模式。
You can use new AVAudioNode types to wrap a user-defined block for sending or receiving data in real-time.

你可以使用 AVAudioNode类型来包装一个用户定义的 block 来实时接收或发送数据。
A new method is available for an AVAudioEngine based app to retrieve a list of all nodes attached to an AVAudioEngine instance.

对于基于 AVAudioEngine 的应用，有一个新的方法来获取 AVAudioEngine 单例的所有节点。
A new rendering mode in AVAudioEnvironmentNode selects the best spatial audio rendering algorithm automatically based on the output device.

AVAudioEnvironmentNode 中一个新的渲染模式，自动选择基于外设的最佳的 spatial audio 渲染算法。
A new AVAudioSession property allows system sounds and haptics to play while the session is actively using audio input.

一个新的 AVAudioSession 属性允许系统声音和触觉在会话正在音频输入时运行。
A new property, AVAudioSessionPromptStyle informs apps which style of voice prompt they should play based on other audio activity in the system.

一个新的属性：AVAudioSessionPromptStyle 他们将会根据系统中的其他音频活动通知应用程序应该播放哪种类型的语音模式。
The AVAudioSessionRouteSharingPolicy enumeration is extended to allow apps to specify route sharing policies so their audio and video is routed to the same location as AirPlay.

AVAudioSessionRouteSharingPolicy 枚举被扩充，可以让应用明确路由共享策略，这样他们的音视频可以像路由到 AirPlay 的同样位置。
Audio Unit Extensions now support user presets that are available across all host apps.

现在支持用户对所有有用的主机应用预安装音频单元扩展。

Deprecations

The OpenAL framework is deprecated and remains present for compatibility purposes. Transition to AVAudioEngine for spatial audio functionality.

OpenAL 框架过期，但为了兼容性而保留。使用 spatial audio 需要迁移到使用 AVAudioEngine。
AUGraph is deprecated in favor of AVAudioEngine.

为了支持AVAudioEngine ，AUGraph过期。
Inter-App audio is deprecated. Use Audio Units for this functionality.

应用间音频过期，使用音频单元来实现这个功能。
Carbon component-based Audio Units are deprecated and support will be removed in a future release.

基于 Carbon 组件的音频单元过期，后续将会被移除。
Legacy Core Audio HAL audio hardware plug-ins are no longer supported. Use Audio Server plug-ins for audio drivers.

遗留的 Core Audio 虚拟音频硬件将不再支持。使用音频服务插件来制作音频驱动。

AVFoundation

New Features

AVFoundation now supports encoding video with alpha channels using HEVC. Videos encoded in this manner are broadly supported in AVFoundation APIs and by Safari within web pages. Technical details of the format can be found in the Interoperability Profile specification. (8045917)

AVFoundation 支持使用 HEVC 的 alpha 通道来视频编码。使用这种方式编码的视频将被 AVFoundation 的 API 和网页中的Safari 广泛支持这种格式的技术细节可以操作规范说明中找到。

Deprecations

The previously deprecated 32-bit QuickTime framework is no longer available in macOS 10.15.

从前 32 位的 QuickTime 框架在 10.15 中不在继续有用。
The symbols for QTKit, which relied on the QuickTime framework, are still present but the classes are non-functional.

依赖 QuickTime 的 QTKit 符号将保留，但是类都会无用。

Books

Known Issues

Books and PDFs imported into the Books app might not upload to iCloud Drive. (47124224)

导入到 Books 应用的书籍和 pdf 将不会上传到 iCloud 云盘。

Camera

Known Issues

Apps using Picture Taker must specify the NSCameraUsageDescription key to access the FaceTime camera. (47916725)

应用如果需要访问 FaceTime 摄像头，必须定义 NSCameraUsageDescription 键。

Core Image

New Features

The filterWithImageURL:options: and filterWithImageData:options: initializers no longer support RAW decoder versions earlier than 6. Version 6 and later remain supported. (50911303)

filterWithImageURL:options:and filterWithImageData:options: 初始化不再支持 6 以前的原始解码版本。6 和后续的版本保持支持。
Added new APIs for instantiating and modifying the built-in Core Image filters.

添加新的 API 举例和修饰内置 Core Image 滤镜。
The CICoreMLModel filter is enhanced to support models with an input or output of type MLFeatureTypeMultiArray.

CICoreMLModel 滤镜被增强来支持 MLFeatureTypeMultiArray类型的输入输出模型。
Metal CIKernel instances now support arguments with arbitrarily structured data.

Metal 的 CIKernel实例支持任意结构数据的参数。
Metal CIKernel instances now support returning a group of two by two pixels.

Metal 的 CIKernel实例支持返回两个像素组成的组。
The integer values of CIFormat symbols, such as kCIFormatARGB8, have changed to a new set of values which are consistent across platforms. The former values remain supported for backward compatibility; however, you should avoid dependancies on specific numerical values.

如 kCIFormatARGB8 的 CIFormat 符号的整型数值，被改为一组跨平台的一致的新的数据。为了向后兼容，从前的数据保留。但是，你需要避免特殊数值的依赖。

Device Management

Known Issues

Sending a Volume Purchase Program download request to a client from a Mobile Device Management server might cause an authorization dialog to appear on the client. (49376544)

从移动设备管理服务器向客户端下发批量采购计划下载可能会在客户端展示授权弹窗。
You might be unable to log in while creating a mobile account on a server with Mobile Device Management Bootstrap Token support. (50912641)

在移动设备管理指导令牌的支持下创建移动账户时，你可能无法登陆。
After installing a Device Profile with PrintMACAddress=true, the user’s MAC address might not print as expected. (51003427)

使用 PrintMACAddress=true 安装设备描述文件后，用户的mac 地址可能不会被正确打印。

DriverKit

Known Issues

The Filter Packet network extension type and NWEthernetChannel API don’t currently work with network interface drivers implemented using DriverKit. (48709552)

Filter Packet 网络拓展类型，和 NWEthernetChannel API 目前不能与使用 DriverKit 实现的网络接口驱动程序一起工作.
If a user space driver quits unexpectedly or you restart your Mac, you might need to unplug and reattach the accessory cable to enumerate the driver. (50042397)

如果用户控件的驱动意外退出，或者你重启电脑，你可能需要卸载驱动并重新加载附属接口来列举驱动。

EndpointSecurity

Known Issues

The exec and open events are cached, however the cache entries aren’t invalidated when the file is manipulated. exec events are cached based on the executable and openevents are cached as a product of the executable and the target file being opened. (45497117)

exec 和 open 事件被缓存，然而文件操作时，缓存入口不可用。exec 事件基于可执行性而缓存， open事件缓存为一个可执行的或作为目标文件被打开的产品，
The cache flag for es_respond_auth_result and es_respond_flags_result is ignored. (49071387)

es_respond_auth_result and es_respond_flags_result 的缓存标志（cache）被忽略。
EndpointSecurity system extensions don’t have access to early boot events. (49487645)

终端加密系统驱动无法访问早期的引导事件。
The original_ppid field of es_process_t isn’t currently set and always returns -1. (50746916)

es_process_t 的 original_ppid 目前没有设置，并总返回 -1.

Deprecations

The kauth API will be removed in a future release. (50419013)

kauth API 未来将会被移除。

FileVault 文件保险箱

Known Issues

Password reset for FileVault volumes from macOS Recovery doesn’t function as expected. (50455695)

Workaround: While in macOS Recovery, launch Terminal from the Utilities menu, then type resetpassword and press return. In the window which appears, select My keyboard isn’t working when typing my password to log in.

FileVault 卷宗从macOS 恢复中重置密码无法如其运行。

替代方案：在 macOS 恢复时，打开终端，输入 resetpassword 命令。在显示出的窗口中，选择 My keyboard isn’t working when typing my password to log in 。

Finder

Known Issues

Files can’t be copied from or deleted on an iOS device via the Files tab in Finder. (48649759)

使用 Finder 的文件 tab 键，无法复制或删除 iOS 设备上的文件。
Finder might quit unexpectedly when trying to restore using the Time Machine interface. Instead, control-click the item and choose Restore. (49398715)

当使用 Time Machine 接口来还原时，Finder 可能会闪退。替代的方法是，选中文件后再选择还原。
You might be unable to download folders from iCloud. (50855741)

Workaround: Download files within the folder individually.

你可能无法从 iCloud 下载文件夹。

替代方法：单独下载文件夹中的文件。
When iCloud Desktop is enabled, attempting to drag a volume mounted on the desktop might unexpectedly result in the volume being copied to the Desktop. (51187890)

当 iCloud 桌面不能使用，将卷宗拖拽到桌面，可能会意外的导致卷宗被拷贝到桌面。

iCloud

Known Issues

Turning off the Siri switch in iCloud settings doesn’t stop Significant Locations from syncing. To stop syncing, turn off the Significant Locations switch. (50908297)

关闭iCloud 设置中的 Siri 切换不会停止同步的标志性坐标。关闭标志性坐标开关，停止同步。
If you’re using iCloud Drive to sync Desktop & Documents Folders, your Desktop might be empty after upgrading to macOS 10.15. (50789836)

Workaround: Enable Desktop and Documents in System Preferences under iCloud > iCloud Drive > Options, then restart your Mac.

如果你使用iCloud 云盘来同步桌面、文稿文件夹，升级 10.15 后，你的桌面可能变空。

替代方案：在 iCloud > iCloud Drive > Options 中，让桌面和文稿在系统设置中生效，然后重启Mac。
The Cloud Files section in About This Mac > Storage > Manage might inaccurately represent the current state of files on your Mac. (50362095)

在 About This Mac > Storage > Manage 中的云文件分区可能不能准确地表示 Mac 上当前的文件状态。
Even when Optimize Storage is switched off, iCloud Drive might fail to automatically download all files. (50667204)

Workaround: Download files individually.

即使优化存储被关闭，iCloud 云也可能无法自动下载所有文件。
Pages, Numbers, and Keynote documents in shared folders can only be opened on macOS and iOS. iWork documents in shared folders are currently inaccessible from iCloud.com. (50738067)

共享文件夹中的 Pages, Numbers, 和 Keynote 文件只能被 macOS 和 iOS 打开。共享文件夹中的 iWork 文件目前无法从 iCloud.com 访问。
When creating a new Pages, Numbers, or Keynote document in a shared folder, you might see the message “Couldn’t connect to iCloud”. (50827963)

Workaround: Close and reopen the document.

创建新的 Pages, Numbers 或 Keynote 文稿时，你也许会看到提示消息Couldn’t connect to iCloud。

解决方案：关闭并重启文稿。

iPad Apps on Mac

Known Issues

iPad Apps on Mac that use CloudKit might not receive push notifications. (51264475)

使用 CloudKit 的在 Mac 上运行的 iPad 应用可能无法接收推送。
In order to show a share sheet from a toolbar item using the UIActivityViewController, create the NSToolbarItem using the initWithItemIdentifier:initializer and pass it a UIBarButtonItem configured as a UIBarButtonSystemItemAction. There is no need to set the barButtonItem property. (47292316)

从 toolbar item 上展示共享的 sheet，使用UIActivityViewController。使用 initWithItemIdentifier 初始化，并传递UIBarButtonItem 作为 UIBarButtonSystemItemAction , 来创建 NSToolbarItem。
Currently, you’re unable to import AppKit and UIKit modules in the same compilation unit. If you want to import AppKit headers into an iPad App on Mac, you can import the individual AppKit header in Objective-C, or you can create a bridging header to import the individual AppKit header for Swift. (48094910)

目前，你无法在同一个编译单元引入 AppKit 和 UIKit 模块。如果你需要引入 AppKit 到 ipad app，你可以引入单独的 AppKit OC 头文件；或者你可以创建桥接头来引入单独的 AppKit Swift 头文件。
The UIScreen class’s captured API isn’t currently supported. (48360589)

UIScreen 类的 captured 目前不支持。
When donating interactions using the INInteraction class on macOS, the completion handler is invoked with an error which can be safely ignored. (48371526)

当在 macOS 上使用 INInteraction 类交互时，完成的处理将被可以被安全忽略的错误唤醒。
You can’t open the Services Preferences pane from the Services > Services Preferences menu item in the app menu. (49780697)

Workaround: Use System Preferences to navigate directly to the Services Preferences pane.

你无法从 Services > Services Preferences 打开服务偏好设置面板。

替代方法：从系统偏好设置中直接导航出服务偏好设置的面板。
The currentDevice property on UIDevice and the OS Product Name is currently returned as iOS rather than macOS, which can affect diagnostic logs generated by your system. (49792004, 51304085)

UIDevice 的 currentDevice 属性和 OS Product Name 目前返回为 iOS，而非 macOS。将会影响系统产生的分析日志。
UILabel, UITextField, and UITextView instances with alignment set to center or right in Interface Builder have the wrong alignment when designing for or running iPad Apps on Mac. (50062524)

Workaround: Reapply the desired alignment in awakeFromNib.

UILabel，UITextField 和 UITextView实例将在 IB 中居中或者居右，设计在 Mac 上运行的 iPad 应用时，有错误的对齐方式。
Event handling in extension contexts may produce unexpected results, including failure to deliver trackpad pinch and zoom gestures. (50145462)

拓展环境下的时间处理会产生意外的结果，包含触控板捏合失败。
When sending Mail attachments via MessageUI, each attachment might appear as two icons when viewed by the recipient. (50369995)

当使用 MessageUI 发送邮件附件时，收件人预览时，每个附件会展示两个图标。
If you use UIDocumentBrowserViewController to create a new document, then cancel, the helper process presenting the document browser might quit unexpectedly. (50558637)

使用 UIDocumentBrowserViewController 创建新文档，然后取消，辅助程序将展示文件浏览器可能会意外退出。
Controls drawn with accent color incorrectly maintain their active color when the window is inactive. There is no need to work around this in your app. (50563638)

窗口非激活状态下，被绘制了特殊色彩的控件可能会保留他们原来的激活颜色。这个在你的应用中不需要特别处理。
The UIKit module currently doesn’t import the newly added NSToolbar and NSTouchBar headers, NSToolbar+UIKitAdditions.h and NSTouchBar+UIKitAdditions.h. You can import these headers directly in Objective-C, or you can create a bridging header to import them for Swift. Be sure to import Foundation before importing these headers. (50704322)

UIKit 模块目前没有引入新添加的 NSToolbar 和 NSTouchBar 头文件：NSToolbar+UIKitAdditions.h and NSTouchBar+UIKitAdditions.h。你可以在 OC 下直接引入，或者在 swift 下使用桥接头。在引入这些头文件之前，需要引入 Foundation 框架。
The new required NSURLCache initializer initWithMemoryCapacity:diskCapacity:diskPath: is currently unimplemented. (50739637)

新需要的 NSURLCache 初始化方法 initWithMemoryCapacity:diskCapacity:diskPath: 目前没有实施。
When your iPad App on Mac is launched directly into the background, it experiences all the state transitions of a regular app launch — such as application:didFinishLaunchingWithOptions: and applicationDidBecomeActive: — followed by state transitions to return to background state from there — applicationWillResignActive: and applicationDidEnterBackground:. This will soon be updated to match iOS, where your app will receive only applicationDidFinishLaunching:, and only if it wasn’t already running. (50742219)

当你的在 Mac 上运行的 iPad 应用被直接加载到后台，它将经历一个正常应用启动的状态变化，比如 application:didFinishLaunchingWithOptions: 和 applicationDidBecomeActive:，状态变化后，从以下方法返回后台状态 applicationWillResignActive: ， applicationDidEnterBackground。这些将被更新来适应 iOS。你的应用将只接收 applicationDidFinishLaunching，而且只在它已经运行的情况下。
iPad Apps on Mac don’t currently use the same default keychain access group as iPad apps. (50779224)

Mac 上的 iPad 应用目前不使用与 iPad 应用相同的默认的钥匙串访问组。
For iPad Apps on Mac to save to Photos Library, explicitly linking the Photos framework is required. (50781430)

Mac 上的 iPad 引用保存照片，明确需要使用 Photos 框架。
It isn’t currently possible to pass shared items from a Sharing extension back to the host through its completion handler. (50835062)

现在无法通过完成处理从共享拓展传递共享项目到主机。
Opening a CloudKit share URL might not launch an iPad App on Mac that’s present on the system. Additionally, the system might not take the user to the appropriate App Store page to download an app which isn’t present on the system. (50877241)

打开 CloudKit 分享 URL 可能不会打开系统上一个Mac 上运行的 ipad 应用。另外，系统可能不会引导用户到适合的 App Store 界面来下载系统上没有出现的应用。
Ad-hoc app signing doesn’t allow access to the Keychain. Adding Keychain Sharing should trigger mandatory signing using a profile, in turn allowing access to the Keychain. (50898387)

Ad-hoc 应用签名不允许访问钥匙串。添加钥匙串分享需要触发使用说明文件强制签名，来有权使用钥匙串。
A tooltip added to an NSToolbarItem will be presented as a blank window. (50957416)

NSToolbarItem上添加的 tooltip 展示出来将是空窗口。
Password AutoFill might not appear in iPad Apps on Mac. (50992371)

Workaround: Toggle the following setting off and on in Safari Preferences > AutoFill > User names and passwords

Mac 上的 iPad 应用将不会显示密码自动填充功能。

解决方案：关闭下面的开关：Safari Preferences > AutoFill > User names and passwords
Action and share extensions might exhibit visual anomalies. (51005363)

动作和分享拓展可能会显示异常。
The productsRequest:didReceiveResponse: method from StoreKit currently returns with didFailWithError and products aren’t loaded. (51028870)

StoreKit 的 productsRequest:didReceiveResponse: 方法目前将返回 didFailWithError，且 product 无法加载。
Localization for ASAuthorizationAppleIDButton isn’t currently available. (51032803)

ASAuthorizationAppleIDButton 无法本地化。
All assets at 3x scale factor are currently ignored when compiling the asset catalog for iPad Apps on Mac. Because the search begins with the universal asset, assets for a specific memory or graphics class won’t be found. For example, if you provide an image and only give a 6GB and Metal 5v1 asset, it won’t be found at runtime. It’s recommended that you provide all images as vectors to allow generation of the correct scale factors, or at minimum provide 2x versions of the assets. If you’re classifying resources based on memory and graphics families then you should provide “Any Memory” and "Any Graphics”. (51033745)

Mac 上的 iPad 应用在编译时，将忽略 3x 的资源。从全部资源开始搜索，特定的资源不会被发现。比如，你提供一个图片，并只给 6GB 的 5V1 资源，在运行时它不会被发现。

建议你按照指引正确的提供所有的资源，或者至少提供 2x。如果你使用内存和图形家族给资源分类，你需要提供任意内存或者任意图形。
When the user quits an iPad App on Mac, the app transitions to UIKit background state and the app’s audio will be stopped; however, no AVAudioSession interruption notification will be posted. In an upcoming beta, AVAudioSession will issue a begin interruption notification in response to the app transitioning to UIKit background state. Additionally, if an iPad App on Mac attempts to activate an AVAudioSession, start an AudioQueue, AURemoteIO, or other high-level player object while in UIKIt background state, it might succeed. In an upcoming beta, audio input and output won’t be allowed to start and AVAudioSession won’t be allowed to activate while the app is in UIKIt background state. (51050672)

当用户退出 Mac 上的 iPad 应用，应用切换到 UIKit 后台模式，app 的音频也将会停止。然而，AVAudioSession 终端通知将会被发送。在将来的 beta 模式，AVAudioSession 响应切换到后台，将发出一个开始中断的通知。

另外，在 UIKit 后台状态下，应用将尝试去激活一个 AVAudioSession，开始 AudioQueue, AURemoteIO, 或者其他更高级的播放器对象，这个对象可以被继承。

在即将到来的 beta 版本中，UIKit 的后台模式下，音频输入输出将不被允许启动，AVAudioSession 不被允许来激活。
CallKit CXAction instances might return an error. (51074735)

CallKit 的CXAction 可能会返回错误。
MTKView objects might render incorrectly. This will be resolved in an upcoming beta. (51084042)

MTKView 对象可能会渲染错误。这个会在将来的 beta 版本中解决。
Color asset variant isn’t passed during runtime, so these colors won’t appear in your iPad App on Mac. (51113192)

颜色资源变量在运行时不会被传递，所以这些颜色在 Mac 的 iPad app 上不会显示。
If you create an NSToolbarItem with a UIBarButtonSystemItem of type compose, reply, search, or camera, your app might behave unexpectedly. (51253315)

当你使用 compose, reply, search 或 camera 类型的 UIBarButtonSystemItem 来创建 NSToolbarItem，你的应用可能会展示错误。
SFSafariViewController doesn’t open the URL from initialization time when presented; SFSafariViewController’s intended design on macOS is to open the URL from initialization when presented, then dismiss itself. (51267323)

SFSafariViewController 在展示时，无法打开初始时创建的连接。SFSafariViewController 在 macOS 上设计是为了在展示时打开 URL，然后关闭自己。
If your iPad App on Mac is launched directly into the background, a second background launch request launches the app into the foreground, making it visible to the user. If your app uses any of the supported APIs which might result in a background launch, this might cause your app to launch in the foreground without user input. (51287556)

如果你的 iPad 应用启动后直接进入后台，第二个后台启动需要将应用启动到前台，让用户可见。如果你的应用使用了可能导致后台启动的API，这些可能会导致你的应用在前台运行。
In macOS 10.15 beta, the UIGraphicsRenderer class’s defaultFormat function returns the nonextended color range renderer format by default. To use-extended color range format for rendering, create an instance using preferredFormat and pass it to initWithBounds:format:. (51303954)

UIGraphicsRenderer 类的 defaultFormat 功能默认返回非拓展的颜色返回渲染模式。使用扩展的颜色幅度，使用 preferredFormat 创建实例，并传递 initWithBounds:format:。
When creating a Mac version of your iPad app, Xcode automatically generates a unique Mac bundle identifier. If you have an existing Mac bundle identifier you’d prefer to use, you can do so by using manual signing in Xcode. (51076014)

当创建 Mac 版本的 ipad 应用时，xcode 自动生成一个独一的 Mac bundleID。如果你存在 Mac bundleid，最好使用它。你可以在 xcode 中使用手动签名。

Follow these steps to configure your project, AppID, and provisioning profile:

以下步骤可以用来配置你的工程，APPID，和配置文件。

Sign in to Apple Developer, then select Certificates, Identifiers, and Profiles.

在 Apple developer 中前面，选择 Certificates, Identifiers, and Profiles.
In the Identifiers section, select your iOS app identifier to edit.

在 Identifiers 区域，选择 iOS 应用的 identifier 来编辑。
Check the UIKit for Mac capability to enable it, then click the Configure button.

选择允许 UIKit for Mac capability，然后点击 Configure 配置按钮。
Choose Use an existing macOS AppID and select the identifier you’d like to use from the popup menu. Click the Save button to finish editing your AppID.

选择存在的 macOS AppID ，并在弹出的目录中选择这个 ID。点击保存按钮来结束编辑 AppID。
In the Profiles section, click the + button to create a new profile, select ‘macOS App Development’, and click Continue.

在说明文件区域，点击添加按钮，来添加新的 profile，选择 ‘macOS App Development,点击继续。
Select your iOS AppID from the popup, click Continue, and complete the rest of the profile creation flow. When finished, click the Download button.

在弹窗中选择 iOS AppID，点击继续，然后结束后续的 profile 创建流程。结束后，点击下载按钮。
In Xcode, select your project to view the Project Editor and select your app’s target. Then select the Build Settings tab.

在 xcode 中，选择你的功能来查看 Project Editor ，选择你的 app target。然后点击 Build Settings 这个 tab。
Set the Derive UIKit for Mac Product Bundle Identifier setting to No.

设置 Derive UIKit for Mac Product Bundle Identifier 标识为 NO。
Expand the Product Bundle Identifier build setting to view its configurations. Next to the Debug configuration, click the + button to add a conditional value.

展开 Product Bundle Identifier 编译设置，来查看他的配置。在 Debug 配置旁边，点击添加按钮来添加额外的数值。
For the build setting condition, select Any macOS from the popup menu. Edit the value of the conditional build setting to match the macOS bundle identifier you want to use. Repeat this step for all configurations in your project.

在 build 设置条件下，从弹出的菜单中选择任意 macOS。编辑这个值，匹配你想使用的 macOS bundleID。在你的工程中重复这个操作。
In the Signing & Capabilities tab, uncheck Automatically manage signing.

在签名设置中，取消自动管理签名。
For your macOS app, select Import Profile from the Provisioning Profile popup and then select the profile you downloaded earlier.

对于你的 macOS 应用，从配置文件弹窗中选择之前下载的需要导入的 Profile 文件。

iWork

Known Issues

Attempting to open iWork documents in Finder will unexpectedly create a .cpgz file if the corresponding iWork app isn’t installed. (40693892)

Workaround: Install the corresponding app from the App Store before opening the document.

如果没有安装 iWork 应用，尝试去打开 iWork 文稿时，将会意外创建一个 .cpgz 文件。

Game Controllers

Known Issues

HID reports from DualShock 4 game controllers using Bluetooth might be reported differently by lower level frameworks such as IOKit in comparison to macOS Mojave 10.14. This might cause existing macOS games to become unresponsive to input from these controllers in macOS 10.15 beta. (51163262)

相比 Mojave 10.14 ，DualShock 4 游戏控制器中的 HID 报告使用蓝牙将会被如 IOKit 的底层框架报告的不同。这会导致存在 macOS 游戏在这些控制器中对输入没有响应。

Localization

Known Issues

Certain languages might exhibit clipped or misaligned layout. (51068688,50983852)

某些语言可能会布局偏离。
Certain languages might display unlocalized text. (47765173,51196633)

某些语言可能会展示未国际化的文字。

Mail

Known Issues

If your Mac contains both macOS Mojave 10.14 and macOS 10.15 volumes, you might experience issues searching in Mail. (46611310)

Workaround: While running macOS Mojave 10.14, open Terminal and execute the following command:
```
sudo touch /.metadata_never_index_unless_rootfs
```
Reboot into macOS 10.15, open Terminal and execute the following command:
```
sudo touch /System/Volumes/Data/.metadata_never_index_unless_rootfs
```
Reboot into macOS Mojave 10.14, open Terminal and execute the following command:
```
sudo mdutil -E /
```
Depending on the size of your Mail database, it might many hours to reindex all content.

如果你的 Mac 同时包含 10.14 和 10.15 卷宗，你可能会在查找邮件是遇到问题。

解决方案：在运行 10.14 是，打开终端，执行以下命令：sudo touch /.metadata_never_index_unless_rootfs。

重新启动到 10.15，打开终端执行以下命令：sudo touch /System/Volumes/Data/.metadata_never_index_unless_rootfs。

重新启动到 10.14，打开终端执行以下命令：sudo mdutil -E /。

根据你的邮件数据库大小，可能会花费数小时来索引所有内容。

Music

Known Issues

Navigating using the back button might produce unexpected results. (51248128)

使用返回按钮导航可能会产生未知结果。
Music might take a long time to launch for some users. (51207753)

对于一些用户，Music 可能需要一段长的时间来启动。
You might be unable to scroll content on shelves. (51248128)

你可能无法在架子上滑动内容。
Connecting to another computer using Home Sharing might not show the remote library as expected. (50921136)

使用家庭共享来连接到另外的电脑，可能无法显示远程 library。
The visualizer might not appear as expected. (49952376)
显示可能不正常。
Artwork changes might not immediately appear; playlists will be added in an upcoming beta. (51201715)

作品的变化可能没法立即显示；播放列表将在未来的 beta 中添加。
Attempting to delete movies, TV shows, and music videos from Manage Storage settings might not work. (51001458)

从 Manage Storage 设置中可能无法删除 movies, TV shows, 和 music videos。
Music might not remember the previously selected tab when it’s relaunched. (50922604)

Music 重启后可能无法记住之前的选项。

Networking

New Features

All NSURLSessionTasks with a GET HTTP method which contain a body will now produce the error NSURLErrorDataLengthExceedsMaximum. (46025234)

所有包含请求体的 GET HTTP 的方法，NSURLSessionTasks 将会产生错误的 NSURLErrorDataLengthExceedsMaximum。

Known Issues

The driver for Ethernet Control Model (ECM) USB-C to Ethernet adapters isn’t currently enabled in Virtual Machine instances of macOS 10.15. (50968842)

以太网控制型（ECM）的 USB-C 接口驱动无法在虚拟机器实例中有效。
An active Network Extension content filter configuration might interrupt the boot process indefinitely following a kernel panic. (50965627)

Workaround: Boot into macOS Recovery, launch Terminal, and execute the following command:
```
rm /Library/Preferences/com.apple.networkextension.necp.plist
```
一个获取的网络拓展内容筛选配置可能因为内核恐慌中断引导进程。

替代方案：进入 macOS 回复，打开终端，执行以下命令：rm /Library/Preferences/com.apple.networkextension.necp.plist
NetBoot is unavailable when a Network Extension content filter configuration is enabled. (50872052)

Network Extension content filter configuration 启用时，NetBoot 不可用，
The NWEthernetChannel API doesn’t currently support VLAN interfaces. NEPacketTunnelProvider will see both tagged and untagged frames arriving on physical interfaces. Depending on the Ethernet driver, VLAN tags might be processed by hardware and thus stripped off the Ethernet frames thus NEPacketTunnelProviderwon’t see the VLAN tag. (51275655)

NWEthernetChannel API 目前不支持 VLAN 接口。NEPacketTunnelProvider 将看到标记和未标记的帧在物理接口上。在以太网驱动基础上，VLAN 标记将被硬件处理；即使剥去以太网帧，NEPacketTunnelProvider 依然无法看到 VLAN 标记。
Enabling a Network Extension content filter using NEFilterManager might not start the content filter. (50603957)

Workaround: Make another change to the configuration or change the network configuration of your Mac.

使用 NEFilterManager 来使用 Network Extension 内容过滤器可能会没有启动内容过滤器。

替代方案：做一些其他的改变，来修改网络配置。
Installing a content filter configuration when the corresponding content filter system extension is inactive will interrupt all network traffic on your Mac. (51033902)

Workaround: Remove or disable the content filter configuration in System Preferences > Network.

在一致的内容过滤器系统拓展不活跃时，安装内容过滤器配置会导致网络瘫痪。
The DNS Proxy, Packet Tunnel, and App Proxy network extension types don’t work as System Extensions. (51186839)

Workaround: Use App Extensions for these network extension types.

DNS 协议，包隧道，苹果协议网络拓展类型无法像系统拓展一样运行。

解决方案：网络拓展类型使用苹果拓展。

Deprecations

Support for FTP and File URL schemes for Proxy Automatic Configuration (PAC) is removed. HTTP and HTTPS are the only supported URL schemes for PAC. This affects all PAC configurations including but not limited to configurations set using Settings, System Preferences, profiles, URLSession APIs such as connectionProxyDictionary, and CFNetworkExecuteProxyAutoConfigurationURL. (28578280)

对 FTP 和 PAC 的 File URL 方案被移除。HTTP 和 HTTPS是唯一支持 PAC 的 URL 方案。这回影响所有的 PAC 配置，包含但不限于使用 Settings, System Preferences, profiles, URLSession 的 API。
SPDY support is removed from the NSURLSession and NSURLConnection APIs. Servers should use HTTP 2 or HTTP 1.1. (43391641)

SPDY 支持将从 NSURLSession 和 NSURLConnection 中移除。服务器将使用 HTTP 2 or HTTP 1.1.
Network Kernel Extension API will be deprecated in an upcoming beta. (49284108)

在未来的 beta 版本中，Network Kernel Extension API 将会过期。

Photos

New Features

To improve the Photos upgrade experience, Photos is testing database upgrades using a clone of the Photo Library. This clone doesn’t include the content of each photo, but does include faces metadata and a thumbnail image of each person in your library. It also contains metadata such as the asset name and the geographic location of the photo. It is created at ~/Pictures/macOS 10.15 Pre-Upgrade Backup, and you can manually remove this backup at any time. The clone will be removed automatically before the final release of macOS 10.15. (51033690)

为了提升 Photos 的升级体验，Photos 测试数据库更新后使用 Photo Library 的克隆。这份克隆不包含每个照片的内容，但包含人连元数据和每个人的预览图。它同时包含图片的元数据，如资源名、地理位置。创建在 ~/Pictures/macOS 10.15 Pre-Upgrade Backup, 你可以随时手动删除这个备份。这份克隆将在 10.15 的正式发布后，自动移除。

Podcasts 播客

Known Issues

Browse and Top Charts are currently limited to content from the United States. (47884301)

浏览和图标榜单仅限于 US 的内容。
Deleting podcasts using About This Mac > Storage > Manage doesn’t update what’s shown in the Podcasts app until it’s relaunched. (50354510)

使用这个方法删除播客 About This Mac > Storage > Manage ，可能需要重启播客后内容才会更新。

？？
Setting “Automatically Download Episodes” to “Never” might not take effect. (50960777)

设置 Automatically Download Episodes 为 Never 可能不会生效。
Writing a review isn’t currently supported. (46173722)

目前不支持编写回顾。
Manually checking for feed updates when Option-clicking the Podcasts app in the dock isn’t currently available. (50958585)

Workaround: Quit and relaunch the app.

目前不支持在 dock 栏中手动检查更新。？？

解决方法：退出并重启应用。
Certain UI elements might appear unaligned on non-Retina displays. (51138730)

一些 UI 元素在非 retina 屏幕上将无序展示。
The first time Podcasts is launched, a migration is triggered even if there is no content to migrate. (51145044)

播客加载的第一时间，迁移将会发生，即使没有内容可以迁移。
If Podcasts is placed in Full Screen mode, some UI elements might be obscured by the toolbar. (47125303)

如果播客被替换为全屏模式，一些 UI 元素将会被toolbar 遮盖。

Quartz Composer

Deprecations

Starting in macOS 10.15, the Quartz Composer framework is deprecated and remains present for compatibility purposes. Transition to frameworks such as Core Image, SceneKit, or Metal. (50911608)

从 10.15 开始，Quartz Composer 框架过期，但为了兼容而保留。建议迁移框架为： Core Image, SceneKit, or Metal。

Screen Sharing

Known Issues

If the Mac you’re screen sharing with is running macOS 10.15 beta, you can’t drag and drop onto the screen share. (50791710)

如果你正在屏幕共享的 Mac 运行 10.15 beta 版本，在共享时无法拖拽。

Screen Time 屏幕时间

Known Issues

Parental controls that predate macOS 10.15 continue to be enforced even when these restrictions are set to Off in Screen Time. (48010796)

10.15 之前的家长控制将继续被强制实施，即使关闭了屏幕时间限制。
Users can click ‘One more minute’ multiple times per day instead of only once each time they reach a limit for that app. (48773803)

用户可以在一天内多次点击 多一分钟，替代在每次应用达到限制后只能点一次。
When in Downtime or after reaching an App Limit, clicking Ignore Limit requires clicking in the precise location for the options to appear. (50061983)

当在停工时，或者达到应用限制时，点击忽略限制需要点击明确的位置。
Screen Time > Content & Privacy > Content > Web Content > Allowed Websites Only isn’t currently enforced in macOS 10.15 beta. (50462899)

Screen Time > Content & Privacy > Content > Web Content > Allowed Websites Only 目前没有在 10.15 beta 上强制实施。
Messages and FaceTime don’t currently enforce Screen Time’s Communication Limits. (51055350, 51055448)

Messages 和 FaceTime 目前不遵守屏幕时间联系限制。
If the Always Allowed pane is empty or isn’t allowing you to select any apps, quit and relaunch System Preferences. (51120837)

如果总是允许面板为空，或者不允许你选择任意应用，退出并重启系统偏好设置。

Script Editor

Known Issues

Script Editor might quit unexpectedly when saving or executing scripts. (50470730)

保存和执行脚本时，脚本编辑器可能会意外退出。

Scripting Language Runtimes

Deprecations

Scripting language runtimes such as Python, Ruby, and Perl are included in macOS for compatibility with legacy software. Future versions of macOS won’t include scripting language runtimes by default, and might require you to install additional packages. If your software depends on scripting languages, it’s recommended that you bundle the runtime within the app. (49764202)

如 Python, Ruby, and Perl 的运行时脚本语言被包含在 macOS 中，以便于与其他遗留的软件兼容。

未来版本的 macOS 将不会默认包含运行时脚本语言，你需要另外自己安装。如果你的应用依赖于脚本语言，建议你在 app 包中包含。
Use of Python 2.7 isn’t recommended as this version is included in macOS for compatibility with legacy software. Future versions of macOS won’t include Python 2.7. Instead, it’s recommended that you run python3 from within Terminal. (51097165)

不建议使用 Python 2.7，这个版本macOS 包含，为了与遗留软件兼容。未来 Mac 将不再包含 Python 2.7。

Sign In with Apple

Known Issues

The ASAuthorizationAppleIDButton API will be available in an upcoming beta. (50376266)

ASAuthorizationAppleIDButton API 将在接下来的 beta 中有效。

Siri

Known Issues

Siri doesn’t currently support the Music and Podcasts apps. (47202947, 50790506)

Siri 目前不支持 Music and Podcasts 应用。

SwiftUI

Known Issues

Return types for View modifier methods include complex generic types. In a future release, these methods will return simpler types. (46140669)

View 修饰方法返回的类型包含复杂的通用类型。在未来的发布版本中，这些方法将返回简单的类型。
Tabs in TabbedView instances are blank if you use them with a NavigationView. (49958869)

在 NavigationView 中使用 TabbedView ，TabbedView实例将会是空。
Image instances don’t use resizing information configured in asset catalogs. Configure the size of an image using the [resizable(capInsets:resizingMode:)](https://developer.apple.com/documentation/swiftui/image/3269730-resizable?language=objc) modifier instead. (49114577)

图片实例不使用资源目录中的信息。计算图片的尺寸使用 resizable(capInsets:resizingMode:)来替代。
The possible values that you can select from a Picker can’t be accessed from UI automation. (50679414)

Picker 中选中的值，无法从自动化界面获取。
A ScrollView doesn’t always size itself as expected for its content. (49204262)

Workaround: Size the view that’s inside the ScrollView by applying the frame(width:height:alignment:) modifier to the inner view. (49204262)

ScrollView 不会一直根据内容调整合适大小。

应对方法：使用frame(width:height:alignment:) 调整内部视图的大小，以调整 ScrollView 中视图的尺寸。

SystemExtensions

Known Issues

Upgrading system extension versions isn’t currently available. The extension can be deleted, then reinstalled which requires user reapproval. (48943883)

目前不支持升级到系统扩展。扩展将会被删除，并在用户重新批准后再次安装。
Driver extensions might not launch on-demand after installation. (51229724)

Workaround: Disable System Integrity Protection, then launch Terminal and execute the following command before approving the newly installed driver:
```
sudo touch /Library/DriverExtensions
```
驱动拓展在安装后可能不会启动。

应对方法：关闭 SIP，打开终端，在允许安装驱动前运行下述命令 sudo touch /Library/DriverExtensions。
Approving system extensions via Mobile Device Management isn’t currently available. (50553712)

目前不能使用 MDM 允许系统拓展。

Voice Memos 语音备忘录

Known Issues

Location-based naming isn’t yet available in macOS 10.15 beta. (50743045)

基于位置的命名在 10.15 beta 上不可用。

Wi-Fi

Known Issues

Your Mac may be unable to automatically join WPA3 networks. Instead, select the network manually. (50605428)

你的 Mac 可能无法自动加入 WPA3 网络；替代的，需要手动选择网络。
After turning Wi-Fi off using the menu bar, reopening the Wi-Fi menu might unexpectedly list available Wi-Fi networks. (50643127)

当使用目录栏关闭 WIFI 后，重新开启 wifi 目录可能会意外的展示一组 wifi 网络。

Xcode

Known Issues

Swift interfaces for several new URLSession APIs are unavailable. (50517967)

一些新的 URLSession API 的 Swift 接口不可用。

Deprecations

Command line tool support for Subversion — including svn, git-svn, and related commands — is no longer provided by Xcode. If you need Subversion or related command line tools, install the Command Line Tools package by running xcode-select --install. (50266910)

包括svn, git-svn 及相关的版本管理的命令行工具在 xcode 中将不再支持。如果你需要版本管理及相关的工具，运行``xcode-select --installl` 来安装命令行工具包。

_伊织_ 博客专家

发布了164 篇原创文章 · 获赞 162 · 访问量 65万+

他的留言板关注