安裝OSS iOS SDK - Object Storage Service

如果您需要管理OSS儲存空間、上傳下載檔案、進行圖片處理等，可以先安裝OSS iOS SDK。本文介紹如何安裝OSS iOS SDK。

環境要求

iOS系統版本：iOS 8.0及以上
macOS版本：10.10及以上

直接引入Framework

如何擷取OSS iOS SDK Framework，請參見GitHub。

在Xcode中，直接把Framework拖入您對應的Target下即可，在彈出框選中Copy items if needed。

Pod依賴

如果工程是通過Pod管理依賴，只需在Podfile中加入以下依賴，不需要再匯入Framework。

pod 'AliyunOSSiOS'

說明

您可以選擇直接引入Framework或者Pod依賴兩種方式中的任意一種。

工程中引入標頭檔

#import <AliyunOSSiOS/OSSService.h>

重要

引入Framework後，需要在工程Build Settings的Other Linker Flags中加入-ObjC。如果工程已設定了-force_load選項，則需要加入-force_load <framework path>/AliyunOSSiOS。

在Swift中使用SDK

OSS提供了Objective-C版本的 SDK，在Swift專案中可以使用Objective-C版本的SDK混合編碼。OSS提供了Swift如何使用SDK的Demo。更多資訊，請參見GitHub。

相容IPv6-Only網路

為瞭解決無線網路下網域名稱解析容易遭到劫持的問題，OSS移動端SDK引入了HTTPDNS進行網域名稱解析，直接使用IP請求OSS服務端。在IPv6-Only 的網路下可能會遇到相容性問題。蘋果官方近期發布了關於IPv6-only網路環境相容的App審核要求。為此，SDK從2.5.0版本開始已經做了相容性處理。在新版本中，除了-ObjC的設定，還需要引入如下兩個系統庫：

libresolv.tbd
CoreTelephony.framework
SystemConfiguration.framework

關於蘋果ATS政策

WWDC 2016開發人員大會上，蘋果宣布從2017年1月1日起，蘋果App Store中的所有App都必須啟用App Transport Security(ATS)安全功能。即所有新提交的App預設不允許使用NSAllowsArbitraryLoads繞過ATS限制。此外，還需保證App的所有網路請求都必須通過HTTPS加密，否則可能會在應用審核時遇到麻煩。

OSS iOS SDK在2.6.0以上版本中對此做出支援。SDK不會自行發出任何非HTTPS請求，同時SDK支援https://首碼的Endpoint，只需要設定正確的HTTPS Endpoint，即可保證發出的網路請求均符合要求。

重要

設定Endpoint時，需使用https://首碼的URL。
在實現加簽、擷取STS Token等回調時，需確保不會發出非HTTPS的請求。