HappyDNS-ObjectiveC 使用指南

项目介绍

HappyDNS-ObjectiveC 是一个面向Objective-C的DNS库，它允许开发者调用系统底层的DNS解析库，并支持集成多种DNS解析方案，包括但不限于使用114等传统第三方DNS服务，DoH（DNS over HTTPS）协议的解析，以及HTTPDNS如Dnspod的服务。此外，该库提供了灵活的hosts配置选项，增强了应用在网络层面上的控制能力与适应性。

项目快速启动

安装

通过CocoaPods安装

在你的Podfile中添加以下行：

pod 'HappyDNS'

然后运行 pod install。

使用Swift Package Manager

如果你的项目是Xcode 11+，你可以通过以下步骤添加依赖：

1. 文件 > Swift Packages > 添加包依赖。
2. 输入仓库URL: https://github.com/qiniu/happy-dns-objc。
3. 选择你想使用的版本或使用最新的稳定版。

快速示例

在Objective-C中使用HappyDNS进行DNS查询：

NSMutableArray *resolvers = [[NSMutableArray alloc] init];
[array addObject:[QNResolver systemResolver]];
[array addObject:[[QNResolver alloc] initWithAddress:@"119.29.29.29"]];
QNDnsManager *dnsManager = [[QNDnsManager alloc] init:resolvers networkInfo:[QNNetworkInfo normal]];
NSArray<QNRecord *> *queryResults = [dnsManager queryRecords:@"www.example.com"];

应用案例和最佳实践

• 智能DNS切换: 根据网络状况，自动选择最优的DNS服务来提高解析速度。
• 解析IP黑名单过滤: 实现定制化规则，避免连接到特定IP地址。
• HTTPDNS兼容: 在海外部署的应用可以通过HTTPDNS绕过某些网络限制，提升解析稳定性。

示例：动态DNS切换

if ([QNDnsManager needHttpDns]) {
    NSMutableArray *array = [NSMutableArray array];
    [array addObject:[[QNResolver alloc] initWithAddress:@"119.29.29.29"]]; // 或使用HttpDNS服务器
    [array addObject:[QNResolver systemResolver]];
    dnsManager = [[QNDnsManager alloc] init:array networkInfo:[QNNetworkInfo normal]];
} else {
    NSMutableArray *array = [NSMutableArray array];
    [array addObject:[QNResolver systemResolver]];
    [array addObject:[[QNResolver alloc] initWithAddress:@"114.114.114.114"]]; // 或其他稳定的DNS服务器
    dnsManager = [[QNDnsManager alloc] init:array networkInfo:[QNNetworkInfo normal]];
}

典型生态项目

HappyDNS不仅适用于单一应用，还可以被更大的生态系统所采纳，例如：

• 框架整合：可以将HappyDNS集成进网络请求库中，为所有的网络请求提供统一的DNS解决方案。
• 企业级应用：大型企业可能会利用HappyDNS的灵活性，结合自有的DNS服务器或监控系统，实现更精细的流量管理和故障切换策略。

由于本项目专注于Objective-C领域，直接的“典型生态项目”可能不如跨语言库那样丰富。但它的设计使得它可以轻松融入iOS和macOS应用程序的开发流程中，成为构建高性能、高可用网络服务的基石之一。

---

以上就是基于HappyDNS-ObjectiveC的简明使用指南，通过这些步骤，您可以快速地在其基础上构建或改进您的网络逻辑，享受更灵活的DNS解析管理。