123 lines
4.8 KiB
Markdown
123 lines
4.8 KiB
Markdown
# Happy DNS for Objective-C
|
||
|
||
[](http://weibo.com/qiniutek)
|
||
[](https://github.com/qiniu/happy-dns-objc/blob/master/LICENSE)
|
||
[](https://travis-ci.org/qiniu/happy-dns-objc)
|
||
[](https://github.com/qiniu/happy-dns-objc/releases)
|
||
[](https://codecov.io/gh/qiniu/happy-dns-objc)
|
||
|
||
|
||
## 用途
|
||
|
||
调用系统底层Dns解析库，可以使用 114 等第三方 dns 解析，可以使用 Doh 协议的 Dns 解析方案，也可以集成 dnspod 等 httpdns。另外也有丰富的 hosts 域名配置。
|
||
|
||
## 安装
|
||
|
||
通过 CocoaPods
|
||
```ruby
|
||
pod "HappyDNS"
|
||
```
|
||
|
||
通过 Swift Package Manager (Xcode 11+)
|
||
```
|
||
App 对接:
|
||
File -> Swift Packages -> Add Package Dependency，输入 HappyDNS 库链接，选择相应版本即可
|
||
库链接: https://github.com/qiniu/happy-dns-objc
|
||
|
||
库对接:
|
||
let package = Package(
|
||
dependencies: [
|
||
.package(url: "https://github.com/qiniu/happy-dns-objc", from: "1.0.4")
|
||
],
|
||
// ...
|
||
)
|
||
|
||
```
|
||
|
||
## 运行环境
|
||
|
||
|
||
## 使用方法
|
||
＊ 返回 IP 列表
|
||
```
|
||
NSMutableArray *array = [[NSMutableArray alloc] init];
|
||
[array addObject:[QNResolver systemResolver]];
|
||
[array addObject:[[QNResolver alloc] initWithAddress:@"119.29.29.29"]];
|
||
[array addObject:[QNDohResolver resolverWithServer:@"https://dns.alidns.com/dns-query"]];
|
||
QNDnsManager *dns = [[QNDnsManager alloc] init:array networkInfo:[QNNetworkInfo normal]];
|
||
NSArray <QNRecord *> *records = [dns queryRecords:@"www.qiniu.com"];
|
||
```
|
||
＊ url 请求，返回一个IP 替换URL 里的domain
|
||
```
|
||
NSMutableArray *array = [[NSMutableArray alloc] init];
|
||
[array addObject:[QNResolver systemResolver]];
|
||
[array addObject:[[QNResolver alloc] initWithAddress:@"119.29.29.29"]];
|
||
QNDnsManager *dns = [[QNDnsManager alloc] init:array networkInfo:[QNNetworkInfo normal]];
|
||
NSURL *u = [[NSURL alloc] initWithString:@"rtmp://www.qiniu.com/abc?q=1"];
|
||
NSURL *u2 = [dns queryAndReplaceWithIP:u];
|
||
```
|
||
* 兼容 getaddrinfo, 方便底层 C 代码接入
|
||
```
|
||
static QNDnsManager *dns = nil;
|
||
dns = [[QNDnsManager alloc] init:@[ [QNResolver systemResolver] ] networkInfo:nil];
|
||
[QNDnsManager setGetAddrInfoBlock:^NSArray *(NSString *host) {
|
||
return [dns query:host];
|
||
}];
|
||
struct addrinfo hints = {0};
|
||
struct addrinfo *ai = NULL;
|
||
int x = qn_getaddrinfo(host, "http", &hints, &ai);
|
||
qn_freeaddrinfo(ai); // 也可以用系统的freeaddrinfo, 代码一致，不过最好用这个
|
||
```
|
||
### 运行测试
|
||
|
||
``` bash
|
||
$ xctool -workspace HappyDNS.xcworkspace -scheme "HappyDNS_Mac" -sdk macosx -configuration Release test -test-sdk macosx
|
||
```
|
||
|
||
### 指定测试
|
||
|
||
可以在单元测试上修改，熟悉使用
|
||
|
||
``` bash
|
||
```
|
||
|
||
## 常见问题
|
||
|
||
- 如果碰到其他编译错误，请参考 CocoaPods 的 [troubleshooting](http://guides.cocoapods.org/using/troubleshooting.html)
|
||
- httpdns 在**ios8** 时不支持 nat64 模式下 IP 直接访问url，原因是 NSUrlConnection 不支持。无论是用http://119.29.29.29/d 还是http://[64:ff9b::771d:1d1d]/d 都不行，此时可以使用localdns方式。
|
||
- 如果软件有国外的使用情况时，建议初始化程序采取这样的方式
|
||
```Objective-C
|
||
QNDnsManager *dns;
|
||
if([QNDnsManager needHttpDns]){
|
||
NSMutableArray *array = [[NSMutableArray alloc] init];
|
||
[array addObject:[[QNResolver alloc] initWithAddress:@"119.29.29.29"]];
|
||
[array addObject:[QNResolver systemResolver]];
|
||
dns = [[QNDnsManager alloc] init:array networkInfo:[QNNetworkInfo normal]];
|
||
}else{
|
||
NSMutableArray *array = [[NSMutableArray alloc] init];
|
||
[array addObject:[QNResolver systemResolver]];
|
||
[array addObject:[[QNResolver alloc] initWithAddress:@"114.114.114.114"]];
|
||
dns = [[QNDnsManager alloc] init:array networkInfo:[QNNetworkInfo normal]];
|
||
}
|
||
```
|
||
|
||
## 代码贡献
|
||
|
||
详情参考[代码提交指南](https://github.com/qiniu/happy-dns-objc/blob/master/CONTRIBUTING.md)。
|
||
|
||
## 贡献记录
|
||
|
||
- [所有贡献者](https://github.com/qiniu/happy-dns-objc/contributors)
|
||
|
||
## 联系我们
|
||
|
||
- 如果有什么问题，可以到问答社区提问，[问答社区](http://qiniu.segmentfault.com/)
|
||
- 如果发现了bug， 欢迎提交 [issue](https://github.com/qiniu/happy-dns-objc/issues)
|
||
- 如果有功能需求，欢迎提交 [issue](https://github.com/qiniu/happy-dns-objc/issues)
|
||
- 如果要提交代码，欢迎提交 pull request
|
||
- 欢迎关注我们的[微信](http://www.qiniu.com/#weixin) [微博](http://weibo.com/qiniutek)，及时获取动态信息。
|
||
|
||
## 代码许可
|
||
|
||
The MIT License (MIT).详情见 [License文件](https://github.com/qiniu/happy-dns-objc/blob/master/LICENSE).
|