Instalar o SDK Kotlin
Nesta página
O Atlas Device SDK for Kotlin é compatível com as seguintes plataformas. Cada uma tem seu próprio método de instalação e requisitos:
Pré-requisitos
Antes de começar, certifique-se de que seu ambiente de desenvolvimento atenda aos seguintes pré-requisitos:
Android Studio Bumblebee 2021.1.1 ou superior.
JDK 11 ou versão mais recente.
Plugin do Kotlin para Android Studio, versão 1.6.10 ou mais recente.
Um dispositivo virtual Android (AVD) usando uma arquitetura de CPU compatível.
Para obter uma lista de ambientes de destino compatíveis, consulte a seção Ambientes de destino compatíveis nesta página.
Além disso, o Kotlin Multiplatform (KMP) para projetos móveis exige o seguinte:
Kotlin Plug-in Multiplatform Mobile (KMM) para Android Studio, versão 0.3.1 ou superior.
Foi criada uma aplicação do Kotlin Multiplatform (KMP) usando o modelo "aplicação do Kotlin Multiplatform" no Android Studio. Siga as instruções na documentação do Kotlin Multiplatform.
Para obter mais detalhes sobre como configurar seu ambiente KMP, consulte a documentação oficial do Kotlin Kotlin Multiplatform for mobile. Para verificar a configuração do seu ambiente, siga o guia do Kotlin para verificar seu ambiente.
Dica
Versão do plugin do Kotlin
O ecossistema do Kotlin Multiplatform (KMP) frequentemente muda. Se você tiver problemas ao instalar o SDK, verifique a versão do plugin do Kotlin, pois plugins desatualizados podem levar a erros difíceis de depurar. Para ver quais versões do plug-in Kotlin são compatíveis com o SDK, consulte o registro de alterações do SDK.
Instalação
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 Kotlin SDK, os nomes dos pacotes refletem a nomenclatura do Realm.
Adicionar o SDK ao projeto
Adicione io.realm.kotlin
, especificando a versão da biblioteca e apply false
, à lista de plug-ins no arquivo de construção Gradle no nível do projeto, normalmente encontrado em <project>/build.gradle
:
plugins { id 'io.realm.kotlin' version '1.16.0' apply false }
Adicione o seguinte ao arquivo de construção Gradle no nível do aplicativo, normalmente encontrado em <project>/app/build.gradle
:
Adicione
io.realm.kotlin
à lista de plug-ins.Adicione o seguinte à lista de dependências:
Adicione
io.realm.kotlin:library-base
ao bloco de dependências.Se estiver usando o Device Sync em seu aplicativo, adicione
io.realm.kotlin:library-sync
ao bloco de dependências.
Para usar coroutines com o SDK, adicione
org.jetbrains.kotlinx:kotlinx-coroutines-core
à lista de dependências.
plugins { id 'com.android.application' id 'org.jetbrains.kotlin.android' id 'io.realm.kotlin' } android { // ... build configuration settings } dependencies { implementation 'io.realm.kotlin:library-base:1.16.0' // If using Device Sync implementation 'io.realm.kotlin:library-sync:1.16.0' // If using coroutines with the SDK implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.0' }
Adicione o seguinte ao arquivo de construção Gradle no nível do aplicativo, normalmente encontrado em
<project>/app/build.gradle
:Adicione
io.realm.kotlin
à lista de plug-ins.Adicione o seguinte à lista de dependências:
Adicione
io.realm.kotlin:library-base
ao bloco de dependências.Se estiver usando o Device Sync em seu aplicativo, adicione
io.realm.kotlin:library-sync
ao bloco de dependências.
Para usar coroutines com o SDK, adicione
org.jetbrains.kotlinx:kotlinx-coroutines-core
à lista de dependências.
App build.gradleplugins { kotlin("multiplatform") kotlin("native.cocoapods") id("com.android.library") id("io.realm.kotlin") version "1.16.0" } version = "1.0" kotlin { android() iosX64() iosArm64() sourceSets { val commonMain by getting { dependencies { implementation("io.realm.kotlin:library-base:1.16.0") // If using Device Sync implementation("io.realm.kotlin:library-sync:1.16.0") // If using coroutines with the SDK implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.0") } } } } Se você usar qualquer parte do SDK dentro do módulo Android, adicione as seguintes dependências de tempo de compilação ao arquivo de construção Gradle no nível do módulo, normalmente encontrado em
<project>/module/build.gradle
:Módulo Android build.gradledependencies { compileOnly("io.realm.kotlin:library-base:1.16.0") } // If using Device Sync dependencies { compileOnly("io.realm.kotlin:library-sync:1.16.0") }
Ambientes de destino compatíveis
O Kotlin Multiplatform (KMP) oferece suporte a uma ampla variedade de ambientes de aplicativos Consulte também a referência Multiplatform Gradle DSL do Kotlin: Alvos documentação.
Ambientes compatíveis
O Kotlin SDK é compatível com os seguintes ambientes:
android
iosArm64
iosSimulatorArm64
iosX64
jvm
macosArm64
macosX64
Ambientes não compatíveis
O Kotlin SDK não suporta os seguintes ambientes:
androidNativeArm32
androidNativeArm64
androidNativeX86
androidNativeX64
iosArm32
js
linuxArm32Hfp
linuxArm64
linuxMips32
linuxMipsel32
linuxX64
mingwX64
mingwX86
tvosArm64
tvosSimulatorArm64
tvosX64
wasm32
watchosArm32
watchosArm64
watchosSimulatorArm64
watchosX86
watchosX64