iOS

本文档介绍火山引擎移动解析（HTTPDNS）的客户端 iOS SDK 版本说明。

0.16.7

该版本发布于 2024 年 4 月 16 日。

兼容性变更

删除接口
该版本删除了 TTHttpMnetURLProtocol 接口。自该版本起，SDK 不再支持基于 MNet Protocol 的集成方案。

新增功能

自该版本起，SDK 可以按照您在 enableHttpDnsClearText 中的设置向 HTTPDNS 服务端发送 HTTPS 请求或 HTTP 请求。

0.13.1

该版本发布于 2023 年 8 月 29 日。
自该版本起，移动解析 HTTPDNS 支持软件定义解析 AnyMatch 功能。您可以通过 SDK 的 setHttpDnsCustomHeaderBlock 设置自定义标识，用于匹配自定义解析记录配置。参见 什么是软件定义解析 AnyMatch。

0.12.1

该版本发布于 2023 年 7 月 7 日。

改进

自该版本起，移动解析 HTTPDNS 支持动态接入地址功能。SDK 会定时获取 HTTPDNS 服务端的最佳 IP 地址，并向该 IP 地址通过 HTTP 协议发送 DNS 查询请求，从而节省了 HTTPDNS 服务端域名的 DNS 解析耗时。

0.11.3

该版本发布于 2023 年 6 月 21 日。

新增功能

支持控制台的应用管理功能
在 SDK 侧支持控制台的 应用管理 功能。如果要实现该功能，您需要在初始化 SDK 时，在 setHttpDnsAppId 属性中传入您在创建应用时设置的 应用ID。

0.11.1

该版本发布于 2023 年 3 月 23 日。

兼容性变更

删除属性
该版本删除了 TTHttpDnsAuthenticationInfo 类中与临时 Key 鉴权相关的属性：

• useTemporaryKey 属性
• keyExpiredTimeStamp 属性

火山引擎推荐您使用 鉴权密钥 进行鉴权。

新增功能

通过 MNet Protocol 解决自定义 NSURLProtocol 集成方案功能受限的问题
自该版本起，HTTPDNS iOS SDK 支持 MNet Protocol。MNet Protocol 是 HTTPDNS iOS SDK 基于 NSURLProtocol 封装的 Protocol。MNet Protocol 继承了 NSURLProtocol，可以自动拦截 NSURLSession 中的请求。MNet Protocol 解决了自定义 NSURLProtocol 使用的 CFNetwork 库功能受限，扩展性差的问题。
通过 taskInfoList 属性了解 SDK 的解析过程
TTDnsExportResult 类新增 tasksInfo 属性。该属性可以返回从 SDK 发送解析请求到 SDK 收到解析结果的过程信息，包括：

• 解析类型：使用 HTTPDNS 服务端解析或 Local DNS 解析。
• 解析时长：每次解析过程花费的时间。
• 错误码：每次解析过程中返回的错误码。

通过 App ID 区分同一火山引擎账号下的不同应用
TTDnsResolver 类新增 setHttpDnsAppId 方法。您可以使用该方法在 SDK 初始化之后向 SDK 传入 App ID。App ID 可用于区分同一火山引擎账号下的不同应用。
在仅支持 IPv6 的网络环境下降低解析延时
如果当前网络环境仅支持 IPv6，SDK 默认优先返回 Local DNS 的解析结果。您可以通过 enableHttpDnsWithIpv6Only 属性更改 SDK 的默认行为。
简化集成步骤
自该版本起，您可以直接通过 CocoaPods 安装和加载 SDK。您无需在 XCode 中手动添加静态库。

0.8.0

该版本发布于 2022 年 9 月 13 日。
该版本为 HTTPDNS SDK for iOS 的首个正式版本。该版本实现了基本的 HTTPDNS 解析功能。