Como instalar Kotlin?

Tá pronto pra botar a mão na massa? Então bora instalar o Kotlin no seu computador. Existem várias formas de fazer isso, e vou te mostrar as principais.

Opção 1: IntelliJ IDEA (Recomendada)

A forma mais simples de começar é instalando o IntelliJ IDEA Community Edition, que é gratuito e já vem com suporte completo a Kotlin embutido:

  1. Acesse jetbrains.com/idea/download
  2. Baixe a Community Edition (gratuita)
  3. Instale normalmente no seu sistema operacional
  4. Abra o IntelliJ e crie um novo projeto Kotlin

Pronto! Sem configuração extra, sem dor de cabeça. O IntelliJ cuida de tudo pra você.

O IntelliJ também oferece recursos avançados como autocompletar inteligente, refatoração automatizada, depuração integrada e suporte nativo a Gradle. Para quem está começando, a experiência de desenvolvimento é muito superior a usar apenas um editor de texto simples.

Opção 2: Android Studio (Para desenvolvimento mobile)

Se seu foco é Android, o Android Studio é o caminho:

  1. Acesse developer.android.com/studio
  2. Baixe e instale o Android Studio
  3. Ele já vem com Kotlin configurado por padrão

O Android Studio é baseado no IntelliJ IDEA, então a experiência é bem parecida, mas com ferramentas extras voltadas para mobile: emulador de dispositivos, inspetor de layout, profiler de performance e integração com o Google Play. Se quiser um passo a passo detalhado, confira nosso tutorial de Kotlin com Android Studio e o guia de desenvolvimento Android.

Opção 3: Linha de comando (SDKMAN!)

Pra quem curte o terminal, o SDKMAN! é a forma mais prática de gerenciar o Kotlin no macOS e Linux:

# Instalar o SDKMAN!
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

# Instalar o Kotlin
sdk install kotlin

# Verificar a instalação
kotlin -version

Depois de instalado, você pode compilar e rodar arquivos Kotlin direto pelo terminal:

# Criar um arquivo
echo 'fun main() { println("Kotlin instalado com sucesso!") }' > ola.kt

# Compilar e rodar
kotlinc ola.kt -include-runtime -d ola.jar
java -jar ola.jar

A grande vantagem do SDKMAN! é que ele permite ter múltiplas versões do Kotlin instaladas ao mesmo tempo e alternar entre elas facilmente com sdk use kotlin <versão>. Isso é muito útil quando você trabalha em projetos que exigem versões diferentes.

Opção 4: Homebrew (macOS)

No macOS, se você já usa Homebrew:

brew install kotlin
kotlin -version

Simples e direto. A desvantagem em relação ao SDKMAN! é que o Homebrew gerencia apenas uma versão por vez. Se você precisa alternar entre versões, o SDKMAN! é a melhor escolha.

Opção 5: Snap (Linux)

No Linux, além do SDKMAN!, você pode instalar via Snap em distribuições que suportam esse gerenciador:

sudo snap install kotlin --classic
kotlin -version

Para distribuições baseadas em Debian/Ubuntu que preferem usar o gerenciador de pacotes nativo, verifique se o Kotlin está disponível nos repositórios oficiais da sua distro.

Opção 6: Sem instalar nada

Se quiser apenas testar a linguagem antes de instalar qualquer coisa, use o Kotlin Playground direto no navegador:

// Cole isso em play.kotlinlang.org e clique em Run
fun main() {
    val linguagem = "Kotlin"
    val versao = "2.1"

    println("$linguagem $versao rodando no navegador!")
    println("Nenhuma instalacao necessaria")
}

Acesse play.kotlinlang.org e comece a codar imediatamente. O Playground suporta até importações de bibliotecas como kotlinx.coroutines, então dá pra testar bastante coisa sem instalar nada. Para aprender sobre coroutines e funções da linguagem, o Playground é um ótimo ponto de partida.

Pré-requisitos importantes

Independente da opção escolhida, você precisa do JDK (Java Development Kit) instalado, já que Kotlin roda na JVM. O IntelliJ e o Android Studio geralmente cuidam disso automaticamente, mas se for usar a linha de comando:

# Instalar JDK via SDKMAN!
sdk install java 21-tem

# Verificar
java -version

A versão recomendada do JDK é a 17 ou superior (LTS). O JDK 21 é a versão LTS mais recente e funciona muito bem com Kotlin. Evite usar versões muito antigas (abaixo do 11), pois algumas funcionalidades mais novas do Kotlin podem não funcionar corretamente.

Configurando o Gradle

Para projetos mais estruturados, você vai precisar do Gradle como ferramenta de build. A boa notícia é que o IntelliJ e o Android Studio configuram o Gradle automaticamente ao criar um novo projeto. Se quiser configurar manualmente, o arquivo build.gradle.kts básico fica assim:

plugins {
    kotlin("jvm") version "2.1.0"
    application
}

repositories {
    mavenCentral()
}

dependencies {
    testImplementation(kotlin("test"))
}

application {
    mainClass.set("MainKt")
}

Temos um tutorial completo de Gradle com Kotlin que cobre tudo isso em detalhes.

Dicas de solução de problemas

Às vezes a instalação não sai de primeira. Aqui vão alguns problemas comuns e como resolver:

“kotlin: command not found” – Isso acontece quando o Kotlin não está no PATH do sistema. Se usou SDKMAN!, execute source "$HOME/.sdkman/bin/sdkman-init.sh" ou reinicie o terminal. No macOS com Homebrew, verifique se /opt/homebrew/bin está no seu PATH.

“Error: JAVA_HOME is not set” – O Kotlin precisa do JDK pra funcionar. Instale o JDK conforme descrito acima e configure a variável de ambiente JAVA_HOME apontando para o diretório de instalação.

Versão do Kotlin incompatível com o projeto – Se ao abrir um projeto você vê erros de compatibilidade, verifique a versão do Kotlin configurada no build.gradle.kts e certifique-se de que o JDK instalado é compatível. O IntelliJ geralmente sugere a correção automaticamente.

IntelliJ lento ou travando – Aumente a memória alocada para o IDE em Help > Change Memory Settings. Para projetos Kotlin, 2 GB de heap é um bom ponto de partida.

E agora?

Com o Kotlin instalado, o próximo passo é criar seu primeiro projeto. Recomendo começar com algo simples: uma calculadora, uma lista de tarefas ou qualquer coisa que te motive a escrever código. O importante é praticar!

Se quiser um caminho estruturado, siga esta ordem:

  1. Primeiro programa em Kotlin – o famoso “Olá, mundo” e seus primeiros passos
  2. Variáveis e tipos – entenda val, var e o sistema de tipos
  3. Estruturas condicionais – if, when e expressões
  4. Funções em Kotlin – como criar e usar funções
  5. Classes e objetos – programação orientada a objetos

Aqui no Kotlin Brasil você encontra vários tutoriais e o guia completo de Kotlin pra te acompanhar nessa jornada.