Kotlin Academy · Aula

expect e actual

Implementações específicas da plataforma

Aula 2 de 413 etapas

expect e actual é uma aula grátis de Kotlin Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Kotlin Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Kotlin Academy inclui 4 aulas no total.

A Necessidade de Código da Plataforma

Algumas funcionalidades não têm uma implementação comum — obter o nome do sistema operacional, um UUID ou a plataforma atual. O KMM resolve isso com o mecanismo expect/actual.

Declarações expect

Em commonMain, você declara uma função ou classe expect — um contrato sem corpo. O código comum pode chamá-la.

// commonMain
expect fun platformName(): String

actual no Android

Cada plataforma fornece uma implementação actual correspondente à assinatura.

// androidMain
actual fun platformName(): String = "Android " + android.os.Build.VERSION.SDK_INT

actual no iOS

O conjunto de código-fonte do iOS fornece sua própria versão, usando APIs nativas.

// iosMain
import platform.UIKit.UIDevice

actual fun platformName(): String =
    UIDevice.currentDevice.systemName + " " + UIDevice.currentDevice.systemVersion

Usando no Código Comum

O código comum chama a função esperada como se ela existisse; o compilador vincula a implementação actual correta para cada destino.

// commonMain
class Platform {
    val name: String get() = platformName()
}

Classes expect

Você pode declarar uma classe inteira como expect. Cada plataforma fornece uma classe actual com membros correspondentes.

// commonMain
expect class FileReader(path: String) {
    fun read(): String
}

Implementações de Classes actual

As plataformas implementam a classe esperada usando APIs nativas de arquivos (por exemplo, Java IO no Android e Foundation no iOS).

// androidMain
actual class FileReader actual constructor(private val path: String) {
    actual fun read(): String = java.io.File(path).readText()
}

expect com typealias

Uma implementação actual pode ser um typealias para um tipo de plataforma existente, evitando um encapsulador.

// commonMain
expect class Uuid

// jvm/androidMain
actual typealias Uuid = java.util.UUID

Regras de Correspondência de Assinaturas

A implementação actual deve corresponder exatamente à declaração expect: mesmo nome, parâmetros e tipo de retorno. Uma divergência é um erro de compilação, garantindo a consistência entre as plataformas.

Quando Não Usar expect/actual

Prefira interfaces com implementações da plataforma injetadas em tempo de execução quando a abstração for mais flexível. Reserve expect/actual para primitivas de plataforma pequenas e fixas.

Uma Ilustração com Código Comum

Fora do KMM, a mesma ideia consiste apenas em chamar uma abstração. Aqui, uma função comum representa a chamada da plataforma.

fun platformName(): String = "Demo Platform"

fun main() {
    println("Running on " + platformName())
}

Verificação Rápida

Onde uma declaração expect é escrita e onde ficam suas implementações actual?

Responda na aula interativa

Recapitulação

expect/actual preenche as lacunas entre plataformas:

expect declara o contrato em commonMain
actual o implementa por plataforma (ou por meio de typealias)
As assinaturas devem corresponder exatamente
Prefira interfaces para abstrações flexíveis

Próximo tópico: compartilhamento da lógica de negócio.

Grátis para começar

Aprenda Kotlin com um tutor de IA — grátis

Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.

Cursos: 51
Aulas: 203

Começar a aprender grátis Ver o curso completo

Perguntas Frequentes

A aula “expect e actual” é grátis?

Sim — o texto completo de “expect e actual” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Kotlin Academy, atualize para CoddyKit PRO. O curso de Kotlin Academy inclui 4 aulas no total.

O que vou aprender em “expect e actual”?

Implementações específicas da plataforma Você pratica Kotlin Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Kotlin Academy?

Nenhuma experiência prévia é necessária. Kotlin Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.

Quanto tempo leva a aula “expect e actual”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Kotlin Academy?

Sim. Cada aula de Kotlin Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para Kotlin Academy