952      阿里云

iOS SDK手册__SDK手册_HTTPDNS-阿里云

1. 前言

本文档介绍了HTTPDNS iOS SDK的使用方式。

HTTPDNS是阿里云面向移动开发者提供的移动端DNS解析服务。通过该SDK，开发者可以在自己的iOS APP中获得可靠、实时、精准的DNS解析服务，彻底解决传统DNS面临的域名劫持、解析时延长、调度不精准等问题。

您可以通过获取alicloud-ios-demo工程源码获得HTTPDNS服务的使用例程。

您有两种获取SDK的方式：

• 您可以通过上述github demo获取HTTPDNS SDK
• 您可以通过访问移动服务APP列表页(https://ams.console.aliyun.com/#/appList 若您第一次访问，请创建APP)，点击下图红框中的下载OneSDK，进入OneSDK下载页并勾选HTTPDNS组件获取SDK

2. 应用程序配置与初始化

HTTPDNS iOS SDK，自v1.1.0版本已全面支持苹果ATS要求，无需在Info.plist中配置ATS。

2.1 依赖

系统公共库：

• libresolv.tbd
• CoreTelephony.framework
• SystemConfiguration.framework

AMS组件包

• UTDID.framework
• AlicloudUtils.framework

2.2 获取服务实例

HTTPDNS iOS SDK以全局service实例的方式提供域名解析服务，您可以通过以下方式获取实例：

HttpDnsService *httpdns = [HttpDnsService sharedInstance];
// 设置AccoutID，当您开通HTTPDNS服务时，您可以在控制台获取到您对应的Accout ID信息
[httpdns setAccountID:*****];

2.3 设置预解析域名

在您初始化程序时，可以选择性地预先向HTTPDNS SDK中注册您后续可能会使用到的域名，以便SDK提前解析，减少后续解析域名时请求的时延。您只需调用以下接口：

NSArray * hosts = [[NSArray alloc] initWithObjects:@"www.taobao.com", @"www.aliyun.com", nil];
[httpdns setPreResolveHosts:hosts];

3. 服务API与使用示例

3.1 服务API

/**
 * 获取HTTPDNS服务实例
 */
+ (instancetype)sharedInstance;
/**
 * 设置HTTPDNS服务Account ID，您可以从控制台获取您的Account ID信息
 *
 * @param accountId 您的HTTPDNS租户ID
 */
- (void)setAccountID:(int)accountId;
/**
 * 设置HTTPDNS域名解析请求类型(HTTP/HTTPS)，若不调用该接口，默认为HTTP请求。
 * HTTP请求基于底层CFNetwork实现，不受ATS限制；
 *
 * @param enable  YES: HTTPS请求, NO: HTTP请求
 */
- (void)setHTTPSRequestEnabled:(BOOL)enable;
/**
 * 将app使用到的域名预设进来，以便于HTTPDNS 进行预解析
 *
 * @param hosts 预解析列表
 */
- (void)setPreResolveHosts:(NSArray *)hosts;
/**
 * 同步解析接口，首先查询缓存，若存在则返回结果，若不存在则进行同步域名解析请求，解析完成返回最新解析结果，若解析失败返回nil
 *
 * @param host 域名(如www.aliyun.com)
 * @return 域名对应的解析结果
 */
- (NSString *)getIpByHost:(NSString *)host;
/**
 * 同步解析接口，首先查询缓存，若存在则返回结果，若不存在则进行同步域名解析请求，解析完成返回最新解析结果列表，若解析失败返回nil
 *
 * @param host 域名(如www.aliyun.com)
 * @return 域名对应的解析结果列表
 */
- (NSArray *)getIpsByHost:(NSString *)host;
/**
 * 同步解析接口，首先查询缓存，若存在则返回结果，若不存在则进行同步域名解析请求，解析完成返回最新解析结果，若解析失败返回空对象。返回的结果是URL使用场景下的格式化结果
 *
 * @param host 域名(如www.aliyun.com)
 * @return 域名对应的解析结果
 */
- (NSString *)getIpByHostInURLFormat:(NSString *)host;
/**
 * 异步解析接口，首先查询缓存，若存在则返回结果，若不存在返回nil并且进行异步域名解析更新缓存
 *
 * @param host 域名(如www.aliyun.com)
 * @return 域名对应的解析结果
 */
 - (NSString *)getIpByHostAsync:(NSString *)host;
 /**
 * 异步解析接口，首先查询缓存，若存在则返回结果列表，若不存在返回nil并且进行异步域名解析更新缓存
 *
 * @param host 域名(如www.aliyun.com)
 * @return 域名对应的解析结果列表
 */
 - (NSArray *)getIpsByHostAsync:(NSString *)host;
/**
 * 异步解析接口，首先查询缓存，若存在则返回结果，若不存在返回空对象并且进行异步域名解析更新缓存。返回的结果是URL使用场景下的格式化结果
 *
 * @param host 域名(如www.aliyun.com)
 * @return 域名对应的解析结果
 */
 - (NSString *)getIpByHostAsyncInURLFormat:(NSString *)host;
/**
 * 设置降级策略，用户可定制规则降级为原生DNS解析方式；
 *
 * @param delegate 降级代理
 */
 - (void)setDelegateForDegradationFilter:(id<HttpDNSDegradationDelegate>)delegate;
@protocol HttpDNSDegradationDelegate <NSObject>
/**
 * 降级过滤器
 *
 * @param hostName 当前的目标域名(如www.aliyun.com)，您可以针对域名进行降级过滤
 * @return 是否降级走原生DNS逻辑
 */
- (BOOL)shouldDegradeHTTPDNS:(NSString *)hostName;
@end
/**
 * 是否允许HTTPDNS返回TTL过期的域名
 * 当您允许返回TTL过期的IP时，SDK在实时返回过期IP的同时依然会进行异步更新以获取最新的IP信息
 *
 * @param enable 是否返回TTL过期域名
 */
- (void)setExpiredIPEnabled:(BOOL)enable;
/**
 * 设置网络切换时是否自动刷新所有域名解析结果，如果打开此开关，在网络切换时，会自动刷新所有域名的解析结果，但会产生一定流量消耗
 *
 * @param enable
 */
- (void)setPreResolveAfterNetworkChanged:(BOOL)enable;

HTTPDNS场景下兼容IPv6-only网络环境需要注意的细节：

NSString *originalUrl = @"https://www.aliyun.com/";
NSURL* url = [NSURL URLWithString:originalUrl];
NSMutableURLRequest* request = [[NSMutableURLRequest alloc] initWithURL:url];
// 同步接口获取IP
NSString* ip = [httpdns getIpByHost:url.host];
if (ip) {
    // 通过HTTPDNS获取IP成功，进行URL替换和HOST头设置
    NSRange hostFirstRange = [originalUrl rangeOfString: url.host];
    if (NSNotFound != hostFirstRange.location) {
        NSString* newUrl = [originalUrl stringByReplacingCharactersInRange:hostFirstRange withString:ip];
        request = [[NSMutableURLRequest alloc] initWithURL:[NSURL URLWithString:newUrl]];
        // 设置请求HOST字段
        [request setValue:url.host forHTTPHeaderField:@"host"];
    }
}

目标URL：https://www.aliyun.com/product/oss/
代理：10.0.0.172:80
您的HTTP请求头应设置为：
GET https://10.0.0.172:80/product/oss/ HTTP/1.1
Host: 10.0.0.172
X-Online-Host: www.aliyun.com

[request setValue:url.host forHTTPHeaderField:@"X-Online-Host"];