WorkManager Kotlin: métodos, exemplos, instalação |…

Introdução ao WorkManager para Kotlin

\n\n

WorkManager é uma biblioteca do Google para Android, projetada para executar tarefas em segundo plano que devem ser garantidamente concluídas mesmo após a reinicialização do dispositivo ou fechamento do aplicativo. Ela faz parte do Android Jetpack e fornece uma API simples e confiável para agendar tarefas adiadas, periódicas e únicas.

\n\n

O principal objetivo do WorkManager é substituir mecanismos obsoletos de trabalho em segundo plano, como Service ou AsyncTask, e garantir compatibilidade com diferentes versões do Android (a partir da API 14+). A biblioteca escolhe automaticamente a melhor forma de executar a tarefa: JobScheduler (API 23+), AlarmManager + BroadcastReceiver (versões mais antigas) ou Firebase JobDispatcher (se conectado).

\n\n

WorkManager é ideal para cenários como: sincronização de dados com o servidor, envio de análises, download de arquivos, processamento de imagens, backup, envio de notificações push e qualquer outra tarefa que não exija execução imediata, mas que deva ser concluída em breve.

\n\n

Instalação do WorkManager

\n\n

WorkManager não é instalado via pip ou npm, pois é uma biblioteca para Android (Kotlin/Java). Para adicioná-la ao seu projeto, é necessário modificar o arquivo build.gradle (nível do módulo).

\n\n

Passo 1: Abra o arquivo build.gradle do seu módulo (app/build.gradle).

\n\n

Passo 2: Adicione a dependência no bloco dependencies:

\n\n

dependencies {\n    implementation "androidx.work:work-runtime-ktx:2.9.0"\n}

\n\n

Passo 3: Sincronize o projeto (Sync Now).

\n\n

Se você estiver usando Kotlin DSL, a dependência será assim:

\n\n

dependencies {\n    implementation("androidx.work:work-runtime-ktx:2.9.0")\n}

\n\n

Importante: A versão 2.9.0 é a atual no momento da escrita deste artigo. Recomenda-se verificar a versão mais recente no site oficial do Android Developers.

\n\n

Início rápido com exemplo de código

\n\n

Vamos considerar um exemplo simples: criar uma tarefa em segundo plano que exibe um log no Logcat.

\n\n

Passo 1: Crie a classe Worker

\n\n

import android.content.Context\nimport android.util.Log\nimport androidx.work.Worker\nimport androidx.work.WorkerParameters\n\nclass SimpleWorker(context: Context, params: WorkerParameters) : Worker(context, params) {\n\n    override fun doWork(): Result {\n        Log.d("SimpleWorker", "Tarefa em segundo plano concluída!")\n        // Aqui você pode executar qualquer operação longa\n        return Result.success()\n    }\n}

\n\n

Passo 2: Agende a execução da tarefa

\n\n

import androidx.work.OneTimeWorkRequestBuilder\nimport androidx.work.WorkManager\n\nval workRequest = OneTimeWorkRequestBuilder<SimpleWorker>()\n    .build()\n\nWorkManager.getInstance(context).enqueue(workRequest)

\n\n

Após chamar enqueue(), a tarefa será executada em breve (geralmente em alguns segundos, se não houver restrições).

\n\n

Principais métodos e funções do WorkManager

\n\n

1. `OneTimeWorkRequestBuilder`

O que faz: Cria uma solicitação única para executar uma tarefa. A tarefa é executada uma vez e depois removida da fila.

Parâmetros:

workerClass (obrigatório) — classe que herda de Worker ou CoroutineWorker.
setInitialDelay() — atraso antes da execução (em milissegundos).
setConstraints() — restrições (por exemplo, conexão com a internet).
addTag() — tag para agrupar tarefas.
setInputData() — dados de entrada para o Worker.