全部产品
Search
文档中心

Object Storage Service:Instalasi (iOS SDK)

更新时间:Nov 30, 2025

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 citra. Topik ini menjelaskan cara menginstal OSS SDK untuk iOS.

Prasyarat

  • iOS: Versi 8.0 atau yang lebih baru diperlukan.

  • macOS: Versi 10.10 atau yang lebih baru diperlukan.

Impor langsung kerangka kerja

Untuk informasi lebih lanjut tentang cara menghasilkan kerangka kerja untuk OSS SDK untuk iOS, kunjungi GitHub.

Di Xcode, seret kerangka kerja ke bagian Target yang diperlukan. Di 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 kerangka kerja OSS SDK untuk iOS.

pod 'AliyunOSSiOS'           
Catatan

Anda dapat menambahkan kerangka kerja atau menambahkan dependensi pod.

Impor file header ke proyek Anda

#import <AliyunOSSiOS/OSSService.h>            
Penting

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

Menggunakan SDK di proyek Swift.

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

Kompatibel dengan jaringan IPv6-only

Resolusi nama domain dalam 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. Dalam jaringan IPv6-only, masalah kompatibilitas mungkin terjadi. Apple telah memperbarui Pedoman Tinjauan App Store-nya untuk mengharuskan aplikasi menyediakan kompatibilitas IPv6. OSS SDK untuk iOS mulai menyediakan dukungan IPv6 dari V2.5.0. Dalam OSS SDK untuk iOS V2.5.0 dan yang lebih baru, selain pengaturan Objective-C, pustaka 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, aplikasi baru tidak boleh menggunakan NSAllowsArbitraryLoads untuk melewati pembatasan 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 persyaratan ini mulai versi 2.6.0 dan yang lebih baru. SDK tidak mengirim permintaan non-HTTPS apa pun dan 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 diinisiasi saat Anda mengimplementasikan panggilan balik seperti menghasilkan tanda tangan dan mendapatkan token dari Security Token Service (STS).