Le SDK OSS pour iOS vous permet de gérer par programme les ressources dans Object Storage Service (OSS). Par exemple, vous pouvez gérer des buckets, télécharger et uploader des objets, ainsi que traiter des images. Cette rubrique décrit comment installer le SDK OSS pour iOS.
Prérequis
iOS : iOS 8.0 ou version ultérieure est utilisé.
macOS : macOS 10.10 ou version ultérieure est utilisé.
Importer directement le framework
Pour plus d'informations sur la génération d'un framework pour le SDK OSS pour iOS, consultez GitHub.
Dans Xcode, faites glisser le framework vers la cible (Target) de votre projet. Dans la boîte de dialogue qui s'affiche, sélectionnez Copy items if needed.
Dépendance Pod
Si votre projet utilise Cocoapods pour gérer les dépendances, ajoutez la dépendance suivante au fichier Podfile. Dans ce cas, vous n'avez pas besoin d'importer le framework du SDK OSS pour iOS.
pod 'AliyunOSSiOS' Vous pouvez ajouter le framework ou ajouter la dépendance pod.
Importer le fichier d'en-tête dans votre projet
#import <AliyunOSSiOS/OSSService.h> Après avoir importé le framework, ajoutez -ObjC aux Other Linker Flags dans les Build Settings de votre projet. Si l'option -force_load est définie pour le projet, ajoutez -force_load <framework path>/AliyunOSSiOS.
Utiliser le SDK dans un projet Swift
OSS fournit une version Objective-C du SDK OSS pour iOS. Dans un projet Swift, vous pouvez utiliser la version Objective-C du SDK pour la programmation hybride. OSS propose une démo illustrant l'utilisation du SDK dans un projet Swift. Pour plus d'informations, consultez GitHub.
Compatibilité avec les réseaux IPv6 uniquement
La résolution de noms de domaine dans les réseaux sans fil est sujette aux détournements. Pour résoudre ce problème, les SDK OSS pour appareils mobiles prennent en charge HTTPDNS pour la résolution de noms de domaine et utilisent directement les adresses IP pour envoyer des requêtes au serveur OSS. Dans un réseau IPv6 uniquement, des problèmes de compatibilité peuvent survenir. Apple a mis à jour ses directives de révision de l'App Store pour exiger que les applications soient compatibles avec IPv6. Le SDK OSS pour iOS prend en charge IPv6 à partir de la version 2.5.0. Dans le SDK OSS pour iOS version 2.5.0 et ultérieures, outre les paramètres Objective-C, les bibliothèques système suivantes doivent être importées :
libresolv.tbd
CoreTelephony.framework
SystemConfiguration.framework À propos de l'ATS
Lors de la WWDC 2016, Apple a annoncé qu'à compter du 1er janvier 2017, toutes les applications de l'App Store devaient activer la fonctionnalité App Transport Security (ATS). Cela signifie que, par défaut, les nouvelles soumissions d'applications ne peuvent pas utiliser NSAllowsArbitraryLoads pour contourner les restrictions ATS. De plus, toutes les requêtes réseau provenant de l'application doivent être chiffrées via HTTPS. Sinon, l'application risque d'échouer lors du processus de révision.
Le SDK OSS pour iOS prend en charge cette exigence dans les versions 2.6.0 et ultérieures. Le SDK n'envoie aucune requête non HTTPS. Il prend également en charge les Endpoint avec le préfixe https://. Vous devez définir le bon Endpoint HTTPS afin de garantir que toutes les requêtes réseau respectent les exigences.
Lorsque vous définissez l'
Endpoint, utilisez une URL avec le préfixehttps://.Assurez-vous que seules des requêtes HTTPS sont initiées lors de l'implémentation des rappels, tels que la génération de signatures et l'obtention de jetons auprès du Security Token Service (STS).