Instal OSS iOS SDK - Object Storage Service - Alibaba Cloud Documentation Center

OSS SDK untuk iOS memungkinkan Anda mengelola sumber daya di Object Storage Service (OSS) secara terprogram, seperti mengelola bucket, mengunggah objek, mengunduh objek, dan memproses gambar. Topik ini menjelaskan cara menginstal OSS SDK untuk iOS.

Prasyarat

iOS: Gunakan iOS 8.0 atau versi yang lebih baru.
macOS: Gunakan macOS 10.10 atau versi yang lebih baru.

Impor framework secara langsung

Untuk informasi selengkapnya tentang cara membuat framework untuk OSS SDK untuk iOS, kunjungi GitHub.

Di Xcode, seret framework tersebut ke Target proyek Anda. Pada kotak dialog yang muncul, pilih Copy items if needed.

Dependensi Pod

Jika proyek Anda menggunakan CocoaPods untuk mengelola dependensi, tambahkan dependensi berikut ke Podfile. Dalam hal ini, Anda tidak perlu mengimpor framework OSS SDK untuk iOS.

pod 'AliyunOSSiOS'

Catatan

Anda dapat memilih antara mengimpor framework atau menambahkan dependensi pod.

Impor file header ke proyek Anda

#import <AliyunOSSiOS/OSSService.h>

Penting

Setelah mengimpor framework, tambahkan -ObjC ke Other Linker Flags di Build Settings proyek Anda. Jika opsi -force_load telah ditetapkan untuk proyek, tambahkan -force_load <framework path>/AliyunOSSiOS.

Gunakan SDK dalam proyek Swift

OSS menyediakan versi Objective-C dari OSS SDK untuk iOS. Dalam proyek Swift, Anda dapat menggunakan versi Objective-C SDK tersebut untuk pemrograman hibrida. OSS menyediakan demo yang menunjukkan cara menggunakan SDK dalam proyek Swift. Untuk informasi selengkapnya, kunjungi GitHub.

Kompatibel dengan jaringan IPv6-only

Resolusi nama domain di jaringan nirkabel rentan terhadap pembajakan. Untuk mengatasi masalah ini, OSS SDK untuk perangkat seluler mendukung HTTPDNS untuk resolusi nama domain dan langsung menggunakan alamat IP untuk mengirim permintaan ke server OSS. Di jaringan IPv6-only, masalah kompatibilitas dapat terjadi. Apple telah memperbarui App Store Review Guidelines-nya dan mewajibkan aplikasi agar kompatibel dengan IPv6. OSS SDK untuk iOS mulai menyediakan dukungan IPv6 sejak V2.5.0. Di OSS SDK untuk iOS V2.5.0 dan versi yang lebih baru, selain pengaturan Objective-C, library sistem berikut harus diimpor:

libresolv.tbd
CoreTelephony.framework
SystemConfiguration.framework

Tentang ATS

Pada WWDC 2016, Apple mengumumkan bahwa mulai 1 Januari 2017, semua aplikasi di App Store harus mengaktifkan fitur App Transport Security (ATS). Artinya, secara default, pengiriman aplikasi baru tidak dapat menggunakan NSAllowsArbitraryLoads untuk melewati batasan ATS. Selain itu, semua permintaan jaringan dari aplikasi harus dienkripsi menggunakan HTTPS. Jika tidak, aplikasi tersebut dapat gagal dalam proses peninjauan.

OSS SDK untuk iOS mendukung hal ini pada versi 2.6.0 dan yang lebih baru. SDK tidak mengirim permintaan non-HTTPS apa pun. SDK juga mendukung Endpoint yang memiliki awalan https://. Anda harus menetapkan Endpoint HTTPS yang benar untuk memastikan semua permintaan jaringan memenuhi persyaratan.

Penting

Saat menetapkan Endpoint, gunakan URL dengan awalan https://.
Pastikan hanya permintaan HTTPS yang dikirim saat Anda mengimplementasikan callback seperti pembuatan signature dan pengambilan token dari Security Token Service (STS).