Menu Docs
Página inicial do Docs
/ /
Atlas Device SDKs

Instalar o SDK Kotlin

Nesta página

  • Pré-requisitos
  • Instalação
  • Adicionar o SDK ao projeto
  • Sincronizar arquivos Gradle
  • Ambientes de destino compatíveis
  • Ambientes compatíveis
  • Ambientes não compatíveis

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:

  • Android

  • Kotlin Multiplatform (KMP)

Antes de começar, certifique-se de que seu ambiente de desenvolvimento atenda aos seguintes pré-requisitos:

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:

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.

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.

1

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:

build.gradle global
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.

Módulo build.gradle
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'
}
  1. 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.gradle
    plugins {
    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")
    }
    }
    }
    }
  2. 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.gradle
    dependencies {
    compileOnly("io.realm.kotlin:library-base:1.16.0")
    }
    // If using Device Sync
    dependencies {
    compileOnly("io.realm.kotlin:library-sync:1.16.0")
    }
2

Após atualizar a configuração Gradle, resolva as dependências clicando em File > Sync Project with Gradle Files na barra de menu do Android Studio. Agora você pode usar o Kotlin SDK em seu aplicativo.

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.

O Kotlin SDK é compatível com os seguintes ambientes:

  • android

  • iosArm64

  • iosSimulatorArm64

  • iosX64

  • jvm

  • macosArm64

  • macosX64

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

Próximo

Bem-vindo aos Docs do Atlas Device SDK