Notas do Todorant

Como a app Android nativa do Todorant chegou ao Google Play em quatro dias e perdeu 4,5 MB pelo caminho

A app Android do Todorant chegou ao Google Play em quatro versões: login Google apagado, falha do R8 no QR e uma fonte sem licença (7,7 MB em vez de 3,3 MB).

atualizado 6 min de leitura

Nesta página
  1. O que era o Todorant no Android antes de outubro de 2026?
  2. Porque falhou o início de sessão com o Google na 2.2.1?
  3. O que estragou o R8 na 2.2.2?
  4. Como perdeu o APK 4,5 MB na 2.2.3?
  5. Porque existe uma compilação separada para o F-Droid?
  6. O que aconteceu às 28 permissões?
  7. O que encontraram os primeiros utilizadores reais?
  8. O que voltaria a fazer da mesma maneira da próxima vez

A app Android nativa do Todorant passou de uma compilação de teste para um lançamento ativo no Google Play em quatro dias, de 13 a 16 de outubro de 2026, e a versão publicada tem 3,26 MB em vez de 7,74 MB. Foram precisas quatro versões para lá chegar (2.2.0 a 2.2.3), e cada uma corrigiu algo que só apareceu quando a compilação passou a ser um lançamento real: um projeto do Google Cloud eliminado, um bloqueio causado pelo R8 e um tipo de letra de 4,5 MB que eu não tinha licença para distribuir. Fica aqui a lista, com os commits.

O que era o Todorant no Android antes de outubro de 2026?

O Todorant é um gestor de tarefas que mostra uma tarefa de cada vez e te obriga a planear novamente todas as tarefas em atraso antes de continuares. A app Android no Google Play era a antiga, feita em React Native. Em outubro substituí-a por uma app nativa em Kotlin e Jetpack Compose que sincroniza através do novo backend /v2 por um único WebSocket. O lançamento 2.0.0, a 13 de outubro, foi a primeira compilação, mas era apenas para testes: o Android recusa atualizar uma app assinada com outra chave, pelo que quem viesse da versão antiga do Play tinha de a abrir uma vez para concluir a sincronização, desinstalá-la e instalar o novo APK. Tudo voltava a aparecer a partir do servidor depois de iniciar sessão.

Porque falhou o início de sessão com o Google na 2.2.1?

A versão 2.1.0 saiu com um problema conhecido: o início de sessão com o Google não funcionava. A razão era aborrecida. O projeto do Google Cloud por trás do cliente de início de sessão tinha sido eliminado, pelo que cada tentativa terminava num erro deleted_client. A correção na 2.2.1, a 14 de outubro, passou por criar um novo projeto no Google Cloud com um cliente web (redirecionamento https://todorant.com/google_login_result) e clientes Android tanto para a chave de envio como para a chave de assinatura do Play. Essa segunda parte importa: o Play volta a assinar a tua app, por isso o início de sessão precisa de conhecer ambas as impressões digitais, ou funciona na tua compilação de teste e falha para todos os utilizadores que instalaram a partir da loja.

A mesma versão removeu a sincronização com o Google Calendar. Tinha deixado de funcionar e o ecrã Integrações onde vivia desapareceu.

O que estragou o R8 na 2.2.2?

O relatório de pré-lançamento do Google Play correu a compilação 2.2.1 em dispositivos de teste e detetou que ler um código QR fechava a app. O início de sessão com QR é a forma de entrar num novo dispositivo lendo o código mostrado na app web, por isso não era um recanto obscuro da aplicação.

A causa foi o R8 em modo completo. O leitor de códigos de barras do ML Kit encontra os seus componentes internos através de classes de registo que cria por reflexão, usando os construtores sem argumentos. O R8 não viu nenhum código a chamar esses construtores e removeu-os. O ComponentDiscovery deixou então de conseguir instanciar as classes de registo, um componente de preferências partilhadas nunca foi registado e GmsBarcodeScanning.getClient() lançou uma NullPointerException. A correção na 2.2.2, integrada a 15 de outubro, são umas poucas linhas em proguard-rules.pro que preservam esses construtores. É o tipo de erro que uma compilação de depuração nunca mostra, o que é o melhor argumento para correr o relatório de pré-lançamento antes de cada promoção, em vez de só uma vez.

Como perdeu o APK 4,5 MB na 2.2.3?

A app Android reutilizava a tipografia da app iOS, que é a SF Pro da Apple distribuída em seis ficheiros de fonte. A SF Pro está licenciada apenas para plataformas Apple, pelo que nunca deveria ter entrado numa compilação Android. Além disso, era pesada: o commit que a removeu regista 4,5 MB no pacote. Passei para o tipo de letra de sistema do Android e mantive as famílias e os pesos como estavam, pelo que nenhum ponto de chamada mudou.

Aqui estão os artefactos de lançamento no Forgejo, medidos a 2 de novembro de 2026:

VersãoDataTamanho do APK
2.2.014 out.7 739 907 bytes
2.2.216 out.7 738 839 bytes
2.2.316 out.3 256 419 bytes
2.2.4 compilação F-Droid16 out.2 754 408 bytes

A queda da 2.2.2 para a 2.2.3 é de 4 482 420 bytes. A versão 2.2.3 é a compilação que foi para o Google Play, e no mesmo dia o README deixou de mandar os utilizadores Android instalar um APK à mão.

Porque existe uma compilação separada para o F-Droid?

A versão 2.2.4 (16 de outubro) dividiu a app em duas variantes. A variante play mantém o início de sessão com o Google e o leitor de códigos da Google. A variante fdroid não tem qualquer código da Google: lê códigos QR com a biblioteca de código aberto ZXing, que precisa da permissão da câmara, e não mostra o botão de entrar com o Google. Continua a ser possível iniciar sessão com email e palavra-passe, Apple, Telegram ou código QR. O F-Droid também rejeita o bloco de informação de dependências que o Gradle acrescenta aos APK, pelo que a compilação de lançamento o omite, e a integração contínua passa agora a compilar ambas as variantes com a chave de envio quando um lançamento é publicado e a anexar ambos os ficheiros, para que o F-Droid possa verificar a sua compilação contra a nossa. O APK do F-Droid é cerca de 490 KB mais pequeno do que o do Play.

O que aconteceu às 28 permissões?

A 17 de outubro, a versão 2.2.6 removeu uma pilha de permissões que o Todorant nunca usou. Uma biblioteca para emblemas no ecrã inicial, ShortcutBadger, declara uma permissão para cada fabricante de launcher que conhece, e o Credential Manager acrescenta duas permissões biométricas para chaves de acesso. A fusão de manifestos metia-as todas na app. Ao ler o diff do commit, contei 22 linhas tools:node="remove" para as eliminar, e VIBRATE também saiu, porque o retorno tátil ao deslizar usa agora a resposta háptica do Compose, que não precisa de permissão. A mensagem do commit conta 28 permissões antes e 5 depois: internet, estado da rede, o recetor de arranque e notificações para o lembrete de planeamento (pedidas apenas quando defines uma hora para o lembrete) e, só na compilação F-Droid, a câmara. As notas da versão dizem-no sem rodeios: o Todorant agora pede apenas as permissões que usa realmente.

Não compilei a app para ler o manifesto final por mim próprio, por isso o 28 e o 5 são os números do commit, e o 22 é a minha contagem das linhas removidas.

O que encontraram os primeiros utilizadores reais?

Duas coisas, e ambas eram culpa minha. A 16 de outubro corrigi o primeiro início de sessão em contas grandes. Um início de sessão limpo descarrega a conta inteira, e quatro sítios diferentes na app iniciavam cada um a sua própria transferência completa, pelo que uma conta de teste com 40 000 tarefas era descarregada duas ou três vezes em simultâneo e ficava sem memória. A resposta de heartbeat do servidor ficava em fila atrás dessa transferência, o ping de 15 segundos do cliente fechava o socket e o tempo limite de sincronização de 30 segundos contava também o tempo da transferência. Entretanto, a app mostrava apenas o separador Definições. A correção faz com que um pedido com o mesmo cursor se junte ao que já está em curso, dá à sincronização 30 segundos para ligar e 120 segundos para responder, e sobe o ping para 60 segundos. A 23 de outubro, a 2.2.7 recuperou tarefas que algumas pessoas tinham guardado apenas no dispositivo na app antiga e que a atualização tinha escondido.

O que voltaria a fazer da mesma maneira da próxima vez

  1. Correr o relatório de pré-lançamento do Play em todas as compilações destinadas a produção. Foi lá que apareceu o único erro grave que importava.
  2. Verificar a licença de todos os recursos trazidos de outra plataforma. Um APK com o dobro do tamanho que devia ter é uma boa razão para ir olhar.
  3. Configurar desde o primeiro dia um segundo cliente de início de sessão Google para a chave de assinatura do Play.
  4. Tratar cada permissão no manifesto final como algo que tens de conseguir explicar.

O Todorant está no Google Play, na App Store, no F-Droid e em todorant.com. Se preferires gerir o teu próprio servidor, o guia de alojamento próprio precisa apenas de um ficheiro compose. O código-fonte está no GitHub.

Escrito a 2 de novembro de 2026 a partir do repositório em backmeupplz/todorant (etiquetas v2.2.12 e anteriores), dos seus artefactos de lançamento no Forgejo e dos commits citados acima.

Ler a seguir