O OSS SDK for iOS permite gerenciar recursos no Object Storage Service (OSS) programaticamente. Por exemplo, você pode gerenciar buckets, fazer upload e baixe de objetos e processar imagens. Este tópico descreve como instale o OSS SDK for iOS.
Pré-requisitos
iOS: versão 8,0 ou posterior.
macOS: versão 10,10 ou posterior.
Importar o framework diretamente
Para obter mais informações sobre como gerar um framework para o OSS SDK for iOS, acesse GitHub.
No Xcode, arraste o framework para o Target do seu projeto. Na caixa de diálogo exibida, selecione Copy items if needed.
Dependência via Pod
Se o seu projeto usar Cocoapods para gerenciar dependências, adicione a seguinte dependência ao Podfile. Nesse caso, não é necessário importar o framework do OSS SDK for iOS.
pod 'AliyunOSSiOS' Adicione o framework ou a dependência via pod.
Importar o arquivo de cabeçalho ao projeto
#import <AliyunOSSiOS/OSSService.h> Após importar o framework, adicione -ObjC em Other Linker Flags nas Build Settings do seu projeto. Se a opção -force_load estiver configurada para o projeto, adicione -force_load <framework path>/AliyunOSSiOS.
Usar o SDK em um projeto Swift
O OSS fornece a versão Objective-C do OSS SDK for iOS. Em projetos Swift, use essa versão do SDK para programação híbrida. O OSS disponibiliza uma demo que mostra como usar o SDK em projetos Swift. Para mais informações, acesse GitHub.
Compatibilidade com redes IPv6-only
A resolução de nomes de domínio em redes sem fio sofre frequentemente com sequestros de DNS. Para resolver esse problema, os SDKs do OSS para dispositivos móveis suportam HTTPDNS na resolução de nomes de domínio e usam endereços IP diretamente para enviar solicitações ao servidor OSS. Em redes IPv6-only, podem ocorrer problemas de compatibilidade. A Apple atualizou suas Diretrizes de Revisão da App Store para exigir que os aplicativos ofereçam compatibilidade com IPv6. O OSS SDK for iOS passou a oferecer suporte a IPv6 a partir da versão V2.5.0. Nas versões V2.5.0 e posteriores do OSS SDK for iOS, além das configurações de Objective-C, importe as seguintes bibliotecas de sistema:
libresolv.tbd
CoreTelephony.framework
SystemConfiguration.framework Sobre o ATS
Na WWDC 2016, a Apple anunciou que, a partir de 1º de janeiro de 2017, todos os aplicativos na App Store precisariam ative o recurso App Transport Security (ATS). Isso significa que, por padrão, novas submissões de aplicativos não podem usar NSAllowsArbitraryLoads para contornar as restrições do ATS. Além disso, todas as solicitações de rede do aplicativo devem ser criptografadas via HTTPS. Caso contrário, o aplicativo pode ser reprovado no processo de revisão.
O OSS SDK for iOS oferece suporte a esse requisito nas versões 2.6.0 e posteriores. O SDK não envia nenhuma solicitação que não seja HTTPS. Ele também suporta Endpoint s com o prefixo https://. Defina o Endpoint HTTPS correto para garantir que todas as solicitações de rede atendam aos requisitos.
Ao defina o
Endpoint, use uma URL com o prefixohttps://.Garanta que apenas solicitações HTTPS sejam iniciadas ao implementar callbacks, como geração de assinatura e obtenção de tokens no Security Token Service (STS).