← Nesim Apps

Falha do Play Billing 8.0.0: “This Stopwatch Is Already Running” e a correção

Por Nesim Razon, desenvolvedor mobile independente · 2026-11-20

#Notas de desenvolvimento#Android

Se o Crashlytics mostra uma IllegalStateException com a mensagem “This stopwatch is already running” vinda da biblioteca Play Billing, você encontrou um erro conhecido da versão 8.0.0 que aparece quando a reconexão automática do serviço está ativada. O Google marcou como corrigido a partir da 8.1.0 e eu passei meu app para a 8.3.0. Aqui conto como a falha aparecia, como a liguei à biblioteca e o que verificar no seu projeto.

Como a falha aparecia

Eu confiro o Crashlytics a cada versão nova. No nosso jogo de Mahjong Tilelings o relatório era minúsculo: dois eventos de um único usuário, só na versão 1.1.0, e todo o resto do painel estava limpo. A exceção era uma IllegalStateException com o texto “This stopwatch is already running”. Os primeiros quadros da pilha estavam em classes ofuscadas da biblioteca Billing, no retorno de chamada executado quando o serviço de cobrança se desconecta.

Dois eventos de uma só pessoa são fáceis de ignorar. Eu não ignorei, porque uma falha dentro de uma biblioteca que você não controla costuma ser um erro e não azar, e pode atingir mais gente depois.

Por que suspeitei da biblioteca e não do meu código

Nada no meu código usa um cronômetro. A mensagem vem do código de medição de tempo dentro da biblioteca. Na minha classe de cobrança o cliente é criado com a reconexão automática do serviço ativada, e meu próprio retorno de chamada de desconexão está vazio de propósito, porque a biblioteca deve se reconectar sozinha. Então a única peça em movimento no ponto da falha era a lógica de reconexão da biblioteca.

O que diz o sistema de acompanhamento de problemas

Procurar a mensagem exata levou a um problema público do Google sobre essa falha no Play Billing 8.0.0 com reconexão automática. É a mesma combinação que eu uso. O tópico diz que o problema está corrigido na versão 8.1.0 e posteriores. As notas da versão não mencionam, então só se encontra procurando no sistema de acompanhamento. O problema foi marcado como corrigido, reaberto e corrigido de novo; vale ler os últimos comentários antes de confiar em um status.

A correção: uma linha no catálogo de versões

A mudança em si é pequena. No catálogo de versões do Gradle a dependência do Billing passa de 8.0.0 para 8.3.0, o código de versão do app sobe e uma nova versão é publicada. Escolhi a 8.3.0 e não uma 9.x porque uma versão maior pode mudar APIs, e eu queria corrigir uma falha, não fazer uma migração.

Enquanto escrevo, a nova versão acabou de chegar à loja, então ainda não posso mostrar um histórico limpo longo. Vou olhar o Crashlytics de novo depois de alguns dias de uso real e atualizo esta nota se a falha voltar.

Uma alternativa se você não puder atualizar

Se precisar ficar na 8.0.0, a alternativa lógica é deixar de usar a reconexão automática e reconectar você mesmo dentro do retorno de chamada de desconexão, com uma pequena pausa entre tentativas. Eu não testei, então trate como uma ideia e não como recomendação. Atualizar é mais simples e é o que o Google indica.

Como verificar seus próprios apps

O que fiz com o resto dos meus apps

Outros sete dos meus jogos e apps usam a mesma versão do Billing com a mesma configuração de reconexão. Ainda não têm relatórios, mas carregam o mesmo risco, então estou atualizando todos de uma vez. Uma falha rara em uma biblioteca de compras vale a pena corrigir antes de virar um padrão.

Perguntas frequentes

O que significa “This stopwatch is already running”?

É uma IllegalStateException lançada pelo código de medição de tempo da biblioteca Play Billing quando um cronômetro é iniciado já estando em execução. Na 8.0.0 podia acontecer durante a reconexão automática do serviço.

Quais versões do Play Billing são afetadas?

Os relatórios apontam para a 8.0.0 com a reconexão automática do serviço ativada. O sistema de acompanhamento do Google diz que está corrigido a partir da 8.1.0.

Preciso migrar para o Billing 9?

Não. Uma versão 8.x como a 8.3.0 corrige essa falha sem uma grande migração de API.

Com que frequência acontece?

Raramente. No meu caso foram dois eventos de um usuário. Ainda assim, falhas raras em uma biblioteca de cobrança valem a correção.

Mais do blog