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"];