Criar seu primeiro programa em Kotlin

Neste codelab, você vai criar seu primeiro programa na linguagem Kotlin usando um editor interativo que pode ser executado no navegador.

Pense em um programa[LINK] como uma série de instruções para que o sistema execute alguma ação. Por exemplo, você pode criar um programa que gera um cartão de aniversário. Nesse programa, você poderia escrever uma instrução para gerar um texto de parabéns ou calcular a idade de alguém pela data de nascimento.

Assim como você usa a linguagem humana para se comunicar com outra pessoa, a linguagem de programação é usada para se comunicar com o sistema operacional do computador. Felizmente, as linguagens de programação são menos complexas do que as humanas e são bastante lógicas.

Os apps Android são escritos na linguagem de programação Kotlin. Essa é uma linguagem moderna criada para ajudar os desenvolvedores a escrever código de forma eficiente e com o mínimo de erros possível.

Aprender a criar um app e aprender as noções básicas de programação ao mesmo tempo vai ser um desafio. Por isso, começaremos com um pouco de programação antes de dar início à criação de apps. É preciso se familiarizar com os princípios básicos de programação. Além de ser uma etapa importante na criação de apps, vai facilitar a criação do seu primeiro app, mais adiante neste curso.

Os editores de código são ferramentas que ajudam você a escrever código, da mesma forma que um processador de texto (como o Documentos Google) ajuda na criação de documentos de texto. Neste codelab, você vai usar um editor de Kotlin interativo no seu navegador. Isso significa que não é necessário instalar softwares para dar o primeiro passo no desenvolvimento de apps.

Prerequisites

  • Usar sites interativos no navegador da Web.

O que você vai aprender

  • Como criar, mudar, entender e executar um programa Kotlin minimalista que exibe uma mensagem.

O que você vai criar

  • Um programa na linguagem de programação Kotlin que exibe uma mensagem quando você o executa.

O que é necessário

  • Um computador com um navegador da Web moderno, como a versão mais recente do Chrome.
  • Acesso à Internet no computador.

Nesta tarefa, você vai usar um editor em um site para iniciar a programação na linguagem Kotlin imediatamente.

Usar um editor de código interativo

Em vez de instalar um software no seu computador, você pode usar uma ferramenta baseada na Web para criar seu primeiro programa.

  1. No navegador, abra https://try.kotlinlang.org/. Isso abre uma ferramenta de programação baseada em navegador.
  2. Você verá uma página semelhante à captura de tela abaixo, com uma lista de arquivos à esquerda e um editor à direita. Você também pode ver uma caixa preta no canto inferior direito com informações sobre a política de cookies.

Aviso:se você não concordar com a política de cookies deste site, não continue.

  1. Clique no X no canto superior esquerdo da caixa pop-up preta para fechá-la.
  1. Siga a captura de tela com comentários abaixo como referência para usar esse editor.

  • (1) Guias Aprender, Comunidade e Testar on-line na parte superior. Clique na guia Testar on-line caso ela ainda não esteja selecionada.
  • (2) Explorador de arquivos no painel mais à esquerda. Cada pasta desta lista contém um pequeno exemplo independente para aprender Kotlin.
  • (3) No editor, no painel à direita, você fará a maior parte do trabalho escrevendo código.

Esse editor de código baseado na Web tem muitos outros recursos, mas esses são os que você precisa saber para começar.

Abrir o exemplo de código

  1. Se ainda não tiver feito isso, selecione Exemplos > Hello, world! > Simples version > SimplestVersion.kt (1 na captura de tela abaixo).
  2. No nome do arquivo SimplestVersion.kt, observe a extensão de arquivo .kt (veja uma na captura de tela abaixo). Assim como as imagens têm uma extensão .jpg ou .png, e os PDFs têm uma extensão .pdf, todos os arquivos Kotlin precisam ter a extensão .kt.
  3. Observe o código no editor (dois na captura de tela abaixo). Parte do código está destacada. Esse é o código com que você trabalhará.

Este é o código do programa destacado no editor:

fun main(args: Array<String>) {
    println("Hello, world!")
}

Executar o código do programa

Executar um programa criado por você não é muito diferente de executar qualquer outro programa no seu computador, como um processador de texto. A diferença é que, ao executar um programa para realizar uma tarefa ou jogar, você se preocupa principalmente com o que o programa pode fazer por você, e não com o código que faz ele funcionar. Ao programar, você vê e trabalha com o código que faz a mágica acontecer.

Vamos ver o que esse programa faz.

  1. No canto superior direito do editor, localize o triângulo verde e clique nele para executar o programa.

  1. Se necessário, role para baixo na página até ver a parte inferior do editor para ver o painel na parte inferior (1 na captura de tela abaixo).

  1. Clique na guia Console. O Console é um local onde os programas podem imprimir a saída de texto.

  1. Observe o elemento Hello, world! exibido no painel Console, como na captura de tela acima. Agora você sabe o que esse programa faz: ele imprime ou gera uma mensagem "Hello World" na janela do Console.
  2. Observe que, acima do Hello, world! impresso, há uma mensagem Compilation complete successfully. A compilação é um processo que traduz o código Kotlin do programa em uma forma que o sistema pode executar. Se a compilação for concluída com êxito, não existem erros no progama que impeçam a execução.

Partes de um programa

Agora que você já viu o que esse programa faz, dê uma olhada em como ele faz isso.

  1. Veja o programa no editor.
  2. Observe que esse código tem duas seções distintas.

Parte superior do programa:

/**
 * We declare a package-level function main which returns Unit and takes
 * an Array of strings as a parameter. Note that semicolons are optional.
 */

No snippet de código acima, é possível ver o texto dentro destes símbolos: /* e */..

Isso significa que é um comentário, ou seja, uma mensagem com informações para outros desenvolvedores. Quando você executa o programa, o comentário é ignorado pelo sistema. Por enquanto, você pode ignorar esse comentário também. Você aprenderá mais sobre comentários em um codelab posterior.

Parte inferior do programa:

fun main(args: Array<String>) {
    println("Hello, world!")
}

Essas três linhas de código são o programa real que executa e imprime a mensagem.

Mudar o código "Hello World"

Vamos mudar o programa para que ele faça algo um pouco diferente.

  1. Mude o texto "Hello, world!" para "Happy Birthday!".
  2. Para executar o programa, clique no botão de execução verde no canto superior direito.
  3. No Console, será possível ver Happy Birthday! impresso, como mostrado na captura de tela abaixo.

Como funciona?

Como isso é feito? Parece código demais só para exibir algo.

Por exemplo, você quer que um amigo escreva "Hello World!" em um pedaço de papel. Tem muitas outras informações implícitas nessa ação. Se você dissesse apenas "Escreva 'Hello World!' nesse pedaço de papel", ele iria supor as informações não mencionadas. Por exemplo, seu amigo presumiria que uma caneta seria necessária e que você queria que ele escrevesse usando letras. O computador não faz essas suposições. É necessário dar instruções precisas que incluam todas as etapas.

Assim como o português tem uma estrutura, o mesmo acontece com a linguagem de programação. Se você já aprendeu outro idioma, sabe o desafio de aprender a gramática, a ortografia, o vocabulário e talvez até um novo alfabeto. Aprender a programar tem desafios semelhantes, mas, felizmente, é menos complexo e muito mais lógico do que o aprendizado do português, por exemplo.

Entenda as partes do programa

Agora, examine o código. Cada parte do programa tem uma finalidade específica e todas elas são necessárias para executá-lo. Vamos começar com a primeira palavra.

fun
  • fun é uma palavra na linguagem de programação Kotlin. fun significa função. Uma função é uma seção de um programa que realiza uma tarefa específica.
fun main
  • main é o nome da função. As funções têm nomes para que seja possível diferenciar umas das outras. Essa função é chamada main, porque é a primeira, ou a principal, a ser chamada quando você executa o programa. Todo programa Kotlin precisa de uma função chamada main. 
fun main()
  • O nome da função sempre é seguido por dois parênteses ().
fun main(args: Array<String>)
  • Dentro dos parênteses, você pode colocar informações a serem usadas pela função. Essa entrada da função é chamada de "argumentos" ou args. Você vai aprender mais sobre argumentos nas próximas tarefas. Você só precisa saber que a função main sempre tem esse mesmo argumento. 
fun main(args: Array<String>) {}
  • Observe o par de chaves após os argumentos. Dentro de uma função, há um código que realiza uma tarefa. As chaves envolvem essas linhas de código.

Veja a linha de código entre as chaves: 

println("Happy Birthday!")

Essa linha de código exibe o texto Happy Birthday!.

  • println diz ao sistema para exibir uma linha de texto.
  • Dentro dos parênteses, você coloca o texto a ser exibido.
  • Observe que o texto a ser exibido está entre aspas. Isso informa ao sistema que tudo dentro das aspas precisa ser exibido exatamente como especificado.

Para exibir o texto, a instrução println inteira precisa estar dentro da função main.

Então é isso. O menor programa possível em Kotlin. 

fun main(args: Array<String>) {
    println("Happy Birthday!")
}

Bom trabalho! Você exibiu uma linha de texto usando println() function. No entanto, é possível colocar quantas linhas de instruções você quiser ou precisar dentro de uma função para realizar uma tarefa.

  1. Copie a linha println("Happy Birthday!") e cole-a mais duas vezes abaixo dela. Confirme se as linhas coladas estão dentro das chaves da função main.
  2. Mude um dos textos a serem exibidos para o nome de alguém.
  3. Mude o outro texto a ser exibido para "You are 25!".

Seu código deve ficar como este: 

fun main(args: Array<String>) {
    println("Happy Birthday!")
    println("Jhansi")
    println("You are 25!")
}

O que você espera que esse código faça quando for executado?

  1. Execute seu programa para ver o que ele faz.
  2. Acesse a janela Console. Você verá três linhas na janela do console, como mostrado na captura de tela abaixo.

Bom trabalho!

Como lidar com erros

Cometer erros durante a programação é normal, e a maioria das ferramentas fornecem feedback para você fazer as correções. Nesta etapa, crie um erro para ver o que acontece.

  1. No seu programa, remova as aspas em torno do texto Jhansi para que a linha fique como exibido abaixo. 
println(Jhansi)
  1. Execute o programa. Você verá Jhansi em vermelho e um ponto de exclamação ao lado da linha 8 do código, para mostrar onde há um erro.

  1. Role para baixo para ver o console.
  2. Selecione a guia Visualização de problemas se ela não estiver selecionada.
  3. Consulte a guia Visualização de problemas. Ele mostra uma mensagem com o mesmo ícone de ponto de exclamação e a palavra Error. A seguir, há uma descrição do erro no seu código.

  1. Procure números (8, 12).. Esses números indicam a linha no código em que o erro ocorre, a linha 8 e a posição da letra na linha em que o erro começa, que é 12.
  2. Você verá uma mensagem Unresolved reference: Jhansi. Essa mensagem informa o que o sistema acha que é o erro no código. Mesmo se você não souber o que significa a mensagem de erro, talvez consiga descobrir o que está errado. Neste caso, você sabe que a instrução println() exibe o texto. Você aprendeu anteriormente que o texto precisa estar entre aspas. Se não estiver, isso é um erro.
  3. Adicione as aspas novamente.
  4. Execute seu programa para confirmar se ele voltou a funcionar.

Parabéns! Você executou e modificou seu primeiro programa Kotlin.

Este é o código completo do programa em que você trabalhou neste codelab.

  • O https://try.kotlinlang.org/ (link em inglês) é um editor de código interativo na Web onde é possível praticar a programação em Kotlin.
  • Precisa haver uma função main() em todos os programas: fun main(args: Array<String>) {}
  • Use a função println() para exibir uma linha de texto.
  • Escreva o texto que você quer exibir entre aspas duplas. Por exemplo: "Hello"
  • Repita a instrução println() para exibir várias linhas de texto.
  • Os erros são marcados em vermelho no programa. Há uma mensagem de erro na guia Visualização de problemas para ajudar você a descobrir onde o erro está e qual pode ser a causa dele.

Este codelab faz parte do curso Noções básicas do Android no Kotlin.

Faça o seguinte:

  1. Mude as instruções println() para print().
  2. Execute seu programa. O que acontece?

Dica: a instrução print() só exibe o texto, sem adicionar uma quebra de linha no final de cada string.

  1. Corrija o texto para que cada parte da mensagem fique na própria linha.

Dica: use \n no texto para adicionar uma quebra de linha. Por exemplo: "line \n break". A adição de uma quebra de linha muda a saída conforme mostrado abaixo.

Dica: você pode exibir uma linha vazia se não incluir o texto: println("").

Código: 

fun main(args: Array<String>) {
    println("no line break")
    println("")
    println("with line \n break")
}

Saída:

Confira seu trabalho:

Veja uma possível solução:

fun main(args: Array<String>) {
    print("Happy Birthday!\n")
    print("Jhansi\n")
    print("You are 25!")
}