Página inicial do Docs → Desenvolver aplicações → Atlas Device SDKs
Instale o SDK para iOS, macOS, tvOS e watchOS
Nesta página
Visão geral
O Atlas Device SDK para Swift permite que você crie aplicações para iOS, macOS, tvOS e watchOS usando linguagens de programação Swift ou Objective-C. Esta página detalha como instalar o SDK no seu projeto e como começar.
Pré-requisitos
Antes de começar, certifique-se de que seu ambiente de desenvolvimento atenda aos seguintes pré-requisitos:
Xcode 14.1-14.3.1 com um alvo de iOS 11.0 ou superior, macOS 10.13 ou superior, tvOS 11.0 ou superior ou watchOS 4.0 ou superior.
A reflexão está habilitada no seu projeto. O Swift SDK usa reflexão para determinar as propriedades do modelo. Seu projeto não pode definir
SWIFT_REFLECTION_METADATA_LEVEL = none, ou o SDK não pode visualizar propriedades em seu modelo. O reflexo será habilitado por padrão se o projeto não definir especificamente um nível para essa configuração.
Alterado na versão 10.40.0.
A versão 10.40.0 do Swift SDK não apresenta mais suporte para o Xcode 13. Para a versão 10.39.01 e anteriores, aplicam-se os seguintes requisitos do Xcode 13:
Xcode versão 13.1 ou superior.
Ao usar o Xcode 13, um alvo de iOS 9.0 ou superior, macOS 10.9 ou superior, tvOS 9.0 ou superior ou watchOS 2.0 ou superior.
Se estiver usando o Swift Package Manager com o Xcode 13, o destino do iOS 11+ ou macOS 10.10+ será necessário.
Observação
Há considerações especiais ao usar o SDK com tvOS. Consulte Construir para tvOS para obter mais informações.
Instalação
Você pode usar SwiftPM, CocoaPods ou Carthage para adicionar o Swift SDK ao seu projeto.
Dica
Atlas Device SDK e Realm
O SDK usa o banco de dados do Realm Core para persistência de dados do dispositivo. Quando você instala o Swift SDK, os nomes dos pacotes refletem o nome do Realm.
Importar o SDK
Dica
Atlas Device SDK e Realm
O SDK usa o banco de dados do Realm Core para persistência de dados do dispositivo. Ao importar o Swift SDK, os nomes dos pacotes refletem o nome do Realm.
Adicione a seguinte linha na parte superior dos seus arquivos de origem para usar o SDK:
Tamanho do arquivo de download do aplicativo
O SDK deve adicionar apenas cerca de 5 a 8 MB ao tamanho de download do seu aplicativo. Os lançamentos que distribuímos são significativamente maiores porque incluem suporte para os simuladores iOS, watchOS e tvOS, alguns símbolos de depuração e bitcode, todos os quais são removidos pela App Store automaticamente quando os aplicativos são baixados.
Solução de problemas
Se você tiver problemas de construção após usar um desses métodos para instalar o SDK, consulte nossas diretrizes de solução de problemas para saber mais sobre como resolver esses problemas.
Suporte ao sistema operacional
Importante
Há considerações especiais ao usar o SDK com tvOS. Consulte Construir para tvOS para obter mais informações.
Xcode 14
Sistema operacional compatível | Realm | Serviços Atlas App |
|---|---|---|
iOS 11,0+ | X | X |
macOS 10.13 | X | X |
tvOS 11.0+ | X | X |
watchOS 4,0+ | X |
Xcode 15
Novo na versão 10.40.1.
Sistema operacional compatível | Realm | Serviços Atlas App |
|---|---|---|
iOS 12.0+ | X | X |
macOS 10.13 | X | X |
tvOS 11.0+ | X | X |
watchOS 4,0+ | X | |
visionOS 1.0+ | X | X |
Suporte à simultaneidade do Swift
O Swift SDK oferece suporte às funcionalidades de linguagem relacionadas à simultaneidade do Swift. Para obter as melhores práticas sobre o uso das funcionalidades de simultaneidade do Swift SDK, consulte a documentação abaixo.
Suporte a Async/Await
A partir das versões 10.15.0 e 10.16.0 do SDK do Realm Swift, muitas das APIs do Realm suportam a sintaxe async/await do Swift. Os projetos devem atender a estes requisitos:
Versão do Swift SDK | Requisito de versão do Swift | Sistema operacional compatível |
|---|---|---|
10.25.0 | Swift 5.6 | iOS 13.x |
10.15.0 ou 10.16.0 | Swift 5.5 | iOS 15.x |
Se a sua aplicação acessar Realm em um contexto do async/await, marque o código com @MainActor para evitar falhas relacionadas a threading.
Para obter mais informações sobre o suporte do async/await no Swift SDK, consulte Suift Concurrency: Async/Await APIs.
Apoio ao ator
O Swift SDK oferece suporte a instâncias de domínio isoladas por ator. Para obter mais informações, consulte Usar Realm com atores - Swift SDK.
Manifesto de privacidade da Apple
A partir da primavera 2024, a Apple exigirá que as aplicações que utilizam RealmSwift o forneçam detalhes sobre collection de dados e práticas de uso do SDK ao enviar novas aplicações ou atualizações de aplicações para a App Store. Para obter mais detalhes sobre os requisitos da Apple, consulte Próximos requisitos de SDK de terceiros no site da Apple Developer.
A partir da versão 10 do Swift SDK.46.0, o SDK é fornecido com manifestos de privacidade para Realm e RealmSwift. Cada pacote contém seu próprio manifesto de privacidade com as declarações de API exigidas pela Apple e os motivos para usar essas APIs.
Você pode visualizar os manifestos de privacidade em cada pacote ou no Github realm-swift:
Realm: https://github.com/realm/realm-swift/blob/master/Realm/PrivacyInfo.xcprivacyRealmSwift: https://github.com/realm/realm-swift/blob/master/RealmSwift/PrivacyInfo.xcprivacy
O Swift SDK não inclui código analítico em compilações para a App Store. O SDK não faz login no Atlas em seu próprio nome.
Se você escrever uma aplicação que usa qualquer funcionalidade dos App Services, como inicializar um cliente de aplicação para:
Talvez seja necessário adicionar divulgações adicionais ao manifesto de privacidade da aplicação, detalhando sua collection de dados e práticas de uso ao usar essas APIs.
Para obter mais informações, consulte a Documentação dos arquivos de manifesto de privacidade da Apple.