iOS 13 正式发布，来看看有哪些 API 变动

ios 13 已正式发布，网上对其用户体验上的新特性的描述也很多。对于开发来说，需要关注的另一方面是新系统在 api 层面做了哪些改动，从而会对我们现有的代码产生什么影响。

在这里，我们基于 ios 13 release notes 做了一些整理，主要是列表出 apple 提供的一些新的 api 和弃用了哪些 api，一起来看看

general
• ios 13 不再支持 uiapplicationexitsonsuspend。需要更新应用以处理现代多任务处理。

uikit
• 当单元格突出显示或选中时，uitableviewcell 类不再更改 contentview 及其任何子视图的 backgroundcolor 或 opaque 属性。如果要在 contentview 内部（包括）内容的任何子视图上设置不透明的 backgroundcolor，则单元格突出显示或选中时的外观可能会受到影响。解决子视图任何问题的最简单方法是确保将 backgroundcolor 设置为 nil 或 clearcolor，并且设置它们的 opaque 属性为 false。但是，如果需要，您可以重写 sethighlighted:animated: 和 setselected:animated: 方法，以便在移动到突出显示的状态和选定状态时手动更改子视图上的这些属性。

• 从ios 8开始，将 uisearchcontroller 与 uinavigationcontroller 一起使用需要将顶视图控制器的 definespresentationcontext 属性设置为 true。如果不这样做会导致难以检测和调试的细微错误。从 ios & ipados 13 beta 开始，如果视图控制器的 navigationitem 具有 non-nil 搜索控件，当视图控制器显示在导航控制器中时，uinavigationcontroller 会自动将该视图控制器的 definespresentationcontext 属性设置为 true。如果您要定位早期版本的 ios，请在搜索控制器变为活动状态之前设置此属性。

• uirefreshcontrol 类不再直接修改其滚动视图的 contentinset。 相反，它对内容插入的调整将合并到滚动视图的 adjustcontentinset 中。 唯一的例外是当滚动视图的 contentinsetadjustmentbehavior 设置为 uiscrollviewcontentinsetadjustmentnever 时，在这种情况下，uirefreshcontrol 实例将像以前的版本一样直接修改 contentinset。

• 如果通过覆盖 sizethatfits 在 uitableview 中实现自调整单元格而不使用自动布局，则返回的高度将被解释为单元格的 contentview 所需的高度，uitableviewcell 会自动添加为单元格留出空间所需的任何其他高度 分隔器。如果以这种方式实现手动自调整大小，则在 uitableviewcell 上调用 sizethatfits: 时，单元格的 contentview 宽度可以保证准确，以便在手动布局计算中使用。

• trait环境（例如视图和视图控制器）现在在初始化期间使用 traits 填充 traitcollection 属性。这些初始特征表示特征环境在添加到层次结构时将接收的最终特征的预测。因为在初始化期间填充的特征只是一个预测，它们可能与实际在层次结构中接收的特征不同。因此，在可能的情况下，您应该等待执行使用 traitcollection 的工作，直到视图或视图控制器的视图移动到层次结构中 - 意味着窗口返回非零值 - 这样您就不必丢弃任何工作，如果实际特征不同，则使用预测的特征完成。使用 traitcollection 的最佳时间是在布局期间，例如 layoutsubviews，viewwilllayoutsubviews 或 viewdidlayoutsubviews 内部。

• 只有当特征值发生变化时，才会调用 traitcollectiondidchange: 方法。重要的是，由于特征集合现在初始化为目标层次结构中最终特征的预测，当初始预测特征与层次结构中的最终特征匹配时，特征环境添加到层次结构时将不会调用 traitcollectiondidchange:。因为 traitcollectiondidchange: 旨在作为无效回调来通知您一个或多个特征已更改，请审核此方法的现有实现，以及 uicontentcontainer 方法willtransitiontotraitcollection:withtransitioncoordinator:，用于您可能依赖它的地方触发初始设置。懒惰地执行使用 traitcollection 的工作的最佳位置是在上面讨论的 layoutsubviews 方法之一，但请记住，这些布局方法在任何时候布局都会被调用，所以一定要避免在不需要时重复工作。

• 您现在可以启用调试日志记录，以便在您自己的类上调用 traitcollectiondidchange: 或willtransitiontotraitcollection:withtransitioncoordinator: 时。使用以下启动参数打开日志记录：-uitraitcollectionchangeloggingenabled yes。您可能希望在使用此启动参数并从 xcode 运行应用程序时暂时禁用主线程检查程序，以避免为不相关的类添加额外的日志消息。

• uitableviewcell 类的 contentview 属性始终与前面和后面的相邻附件进行边对边布局。这简化了布局代码，因此想要正确的默认偏移的开发人员不再需要将其内容与内容视图边框或布局边距对齐，具体取决于尾部是否有附件。您现在应该始终在单元格内容视图的布局边距上布置代码以获取默认的系统插入。这些插入将根据单元格中可见的附件自动调整，以匹配系统的默认间距。

• 您现在可以从创建 block 调用自定义初始化程序，该创建块通过 instantiateinitialviewcontroller(creator:) 或 instantiateviewcontroller(identifier:creator:) 传递。这使您可以使用其他上下文和参数初始化视图控制器，同时利用通过 interface builder 在故事板中定义它们。自定义控制器初始化程序必须调用其 super.init(coder:) 方法并传递它通过创建块接收的编码器参数。

网络
• 为了增强安全性，当服务器发送 content-type:application/octet-stream 时，nsurlsession 不再嗅探 mime 类型。

• nsurlrequestreloadrevalidatingcachedata 和 nsurlrequestreloadignoringlocalandremotecachedata api现已可用。

• 从 ios 13 beta 4 开始，强制执行 nsmutableurlrequest 的 httpbodystream 属性的 copy 操作。如果在调用属性设置器后对 body 数据进行了修改，则 http 请求中发送的数据将不包含该更变。调用该属性的 getter 不再返回 nsmutabledata 引用，即使使用该类型的数据调用 setter 也是如此。从 ios 13 beta 5 开始，使用 ios 12 sdk 或以前的 sdk 构建的应用程序使用旧版行为。

• cncopycurrentnetworkinfo api 返回的信息已无法反映真实情况。有关更多详细信息，请参阅更新的api文档和标题。

• 包含 body 的 get http 方法的所有 nsurlsessiontask 实例现在都会抛出错误 nsurlerrordatalengthexceedsmaximum。

• 删除了对代理自动配置（pac）的 ftp 和文件url方案的支持。http 和 https 是 pac 唯一支持的 url 方案。这会影响所有 pac 配置，包括但不限于使用“设置”，“系统偏好设置”，“配置文件”和 nsurlsession api（如connectionproxydictionary 和cfnetworkexecuteproxyautoconfigurationurl）设置的配置。

• nsurlsession 和 nsurlconnection api 不再支持 spdy。服务器应使用 http 2 或 http 1.1。

音频
• 现在可以在 avaudioengine 上启用语音处理模式。

• 新的 avaudionode 类型可用于包装用户定义的 block，以实时发送或接收数据。

• 基于 avaudioengine 的应用程序可以使用一种新方法来检索附加到 avaudioengine 实例的所有节点的列表。

• avaudioenvironmentnode 中的新渲染模式基于输出设备自动选择最佳空间音频渲染算法。

• 一个新的 avaudiosession 属性允许在会话主动使用音频输入时播放系统声音和触觉。

• 新的枚举 avaudiosessionpromptstyle 根据系统中的其他音频活动通知应用程序应该播放哪种语音提示。

• avaudiosessionroutesharingpolicy 现在允许应用指定路由共享策略，以便其音频和视频路由到与 airplay 相同的位置。

• audio unit extensions 现在支持所有宿主应用程序中可用的用户预设。

• openal框架已弃用，出于兼容性目的暂时保留。过渡到 avaudioengine 以获得 3d 音频功能。

• augraph 已被弃用，转而支持 avaudioengine。

• 不推荐使用应用间音频。使用 audio units 支持此功能。

• 不推荐使用基于 carbon 的 audio units，在将来的版本中不再支持。

• 不再支持旧版 core audio hal 音频硬件插件。将音频服务器插件用于支持音频驱动程序。

音频共享
• 音频共享与 airpods（第1代或更高版本）和 powerbeats pro 兼容。需要 iphone 8 或更高版本。

avfoundation
• avfoundation 现在支持使用 hevc 和 alpha 通道编码视频。以这种方式编码的视频在 avfoundation api 和网页中的 safari 中得到广泛支持。格式的技术细节可以在互操作性配置文件规范中找到。

core image
• filterwithimageurl:options: 和 filterwithimagedata:options: 不再支持 raw 5 及更早版本。 版本 6 及更高版本仍然受支持。

• 添加了用于实例化和修改内置 core image 过滤器的新 api。

• 增强了 cicoremlmodel 过滤器以支持具有 mlfeaturetypemultiarray 类型的输入或输出的模型。

• metal cikernel 实例支持具有任意结构化数据的参数。

• metal cikernel 实例支持返回一组2×2像素。

• ciformat 符号的整数值（例如 kciformatargb8）已更改为跨平台一致性的新值集合。以前的值仍然支持向后兼容; 但是，您应该避免对特定数值的依赖性。

mail
• 现在可以在“设置”>“邮件”中启用“忽略已阻止的发件人”。被阻止的联系人列表与 messages，facetime 和 phone 共享。