すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:インストール (iOS SDK)

最終更新日:May 09, 2026

OSS SDK for iOS を使用すると、Object Storage Service (OSS) 内のリソースをプログラムで管理できます。たとえば、バケットの管理、オブジェクトのアップロード、オブジェクトのダウンロード、イメージの処理などが可能です。このトピックでは、OSS SDK for iOS のインストール方法について説明します。

前提条件

  • iOS:iOS 8.0 以降を使用します。

  • macOS:macOS 10.10 以降を使用します。

フレームワークを直接インポートする

OSS SDK for iOS 向けのフレームワークの生成方法については、GitHub をご参照ください。

Xcode で、フレームワークをプロジェクトの Target にドラッグします。表示されるダイアログボックスで、必要に応じて項目をコピー を選択します。

Pod 依存関係

プロジェクトで Cocoapods を使用して依存関係を管理している場合は、次の依存関係を Podfile に追加します。この場合、OSS SDK for iOS のフレームワークをインポートする必要はありません。

pod 'AliyunOSSiOS'           
説明

フレームワークを追加するか、Pod 依存関係を追加するか、いずれか一方を選択してください。

ヘッダーファイルをプロジェクトにインポートする

#import <AliyunOSSiOS/OSSService.h>            
重要

フレームワークをインポートした後、プロジェクトの Build Settings 内の Other Linker Flags-ObjC を追加します。-force_load オプションがプロジェクトに設定されている場合は、-force_load <framework path>/AliyunOSSiOS を追加します。

Swift プロジェクトでの SDK の使用

OSS は Objective-C 版の OSS SDK for iOS を提供しています。Swift プロジェクトでは、Objective-C 版の SDK を使用してハイブリッドプログラミングが可能です。OSS では、Swift プロジェクトでの SDK 使用方法を示すデモも提供しています。詳細については、GitHub をご参照ください。

IPv6 専用ネットワークとの互換性

無線ネットワークにおけるドメイン名解決は、ハイジャックされやすい傾向があります。この問題に対応するため、モバイル端末向け OSS SDK は HTTPDNS を使用した名前解決をサポートしており、OSS サーバーへのリクエストを IP アドレスを直接指定して送信できます。ただし、IPv6 専用ネットワークでは互換性の問題が発生する可能性があります。Apple は App Store Review Guidelines を更新し、アプリが IPv6 に対応することを必須としています。OSS SDK for iOS は、V2.5.0 から IPv6 サポートを提供しています。OSS SDK for iOS V2.5.0 以降では、Objective-C 設定に加えて、以下のシステムライブラリをインポートする必要があります。

libresolv.tbd
CoreTelephony.framework
SystemConfiguration.framework            

ATS について

WWDC 2016 で Apple は、2017 年 1 月 1 日以降、App Store に提出されるすべてのアプリで App Transport Security (ATS) 機能を有効にする必要があることを発表しました。これは、新規アプリ提出時にデフォルトで NSAllowsArbitraryLoads を使用して ATS 制限をバイパスできなくなることを意味します。また、アプリからのすべてのネットワークリクエストは HTTPS を使用して暗号化する必要があります。これに準拠しない場合、アプリの審査が不合格となる可能性があります。

OSS SDK for iOS は、バージョン 2.6.0 以降でこの要件をサポートしています。SDK は非 HTTPS リクエストを一切送信せず、https:// プレフィックスを持つ Endpoint もサポートしています。すべてのネットワークリクエストが要件を満たすよう、正しい HTTPS Endpoint を設定する必要があります。

重要
  • Endpoint を設定する際は、https:// プレフィックス付きの URL を使用します。

  • セキュリティトークンサービス (STS) から署名やトークンを取得するコールバックを実装する際など、HTTPS リクエストのみを送信するようにしてください。