← Nesim Apps

Salvamento na nuvem no Android e iOS: a regra de mesclagem que nunca perde progresso

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

#Notas de desenvolvimento#iOS#Android

Os jogadores trocam de telefone e reinstalam apps, e esperam que as estrelas vão com eles. Queríamos salvamento na nuvem no nosso jogo novo desde a primeira versão, no Android e no iPhone, sem servidor e sem diálogo de conflito. O truque é uma regra de mesclagem tão simples que cabe em uma linha e uma peça compartilhada de Kotlin que as duas plataformas chamam.

Dois armazenamentos, um formato

No Android o progresso fica nos Jogos salvos do Play Games. No iPhone fica no armazenamento chave-valor do iCloud. Tecnicamente não têm nada em comum, então o código compartilhado não toca em nenhum dos dois. Ele só sabe transformar o progresso em um pequeno bloco de texto, ler um bloco de volta e mesclar dois.

O bloco tem uma entrada por linha no formato chave, uma barra vertical e um inteiro, ordenadas pela chave. Entram as estrelas das portas, as estrelas das fases, as portas desbloqueadas e um contador total. O leitor ignora tudo o que não entende, inclusive números negativos, então um bloco danificado nunca consegue derrubar o jogo.

Por que iCloud e não Game Center

Os dois poderiam guardar um jogo salvo no iPhone. Escolhemos o armazenamento chave-valor do iCloud porque ele não pede nada ao jogador: se o iCloud está ligado no dispositivo, que é o padrão, simplesmente funciona. Os jogos salvos do Game Center exigem um login no Game Center que muitos jogadores nunca usaram, e uma tela de login é atrito justamente no momento em que queremos uma restauração tranquila. Nossos dados são apenas alguns quilobytes e o armazenamento chave-valor permite muito mais, então o tamanho nunca foi problema.

A regra: o número maior vence

Mesclar o progresso de dois telefones parece um problema de conflito até você olhar o que está sendo guardado. As estrelas só sobem. Uma porta desbloqueada é zero ou um e nunca volta a zero. O contador total de resolvidos só cresce. Com valores assim, pegar o maior dos dois sempre dá a resposta certa.

Esse tipo de mesclagem tem três propriedades úteis. A ordem não importa: mesclar A com B é igual a mesclar B com A. Mesclar os mesmos dados duas vezes não muda nada. E dá para mesclar três telefones em qualquer agrupamento. Isso significa que não precisa de carimbos de data, nem de quem escreve por último vence, nem de uma tela perguntando qual salvamento manter.

A mesma regra em dois lugares

A função de mesclagem não é o único lugar onde a regra vive. Os métodos que gravam uma quantidade de estrelas no armazenamento local só aceitam um valor maior que o guardado. Então nem um chamador com erros conseguiria diminuir o progresso. A mesclagem na nuvem e os métodos locais concordam, o que dá duas camadas independentes de proteção.

A etapa de sincronização é curta. Ler o texto remoto, mesclá-lo com uma exportação do progresso local, aplicar o resultado mesclado localmente se for diferente e devolver o texto mesclado para ser gravado de volta na nuvem. As duas plataformas chamam essa única função e só diferem na forma de buscar e guardar o texto.

O que fica no dispositivo

Nem tudo pertence à nuvem. As configurações, a quantidade de dicas, os flocos de neve, o texto de uma cápsula de desejos privada e as fotos ficam no telefone. Isso mantém simples a história de privacidade, nenhum tipo de dado adicional chega a nós, e mantém o bloco minúsculo. Filtrar as chaves por prefixo em uma função torna essa decisão fácil de auditar.

Onde a regra não funciona

Pegar o máximo só funciona para valores que não podem diminuir legitimamente. Um botão de zerar o progresso é a armadilha clássica: a nuvem ainda guarda os números altos antigos e os mescla de volta. Se o seu jogo precisa de exclusão de verdade, são necessárias marcas de exclusão ou carimbos de versão, que é um desenho diferente e maior. Nós ficamos com valores que só crescem. O botão de zerar do nosso jogo limpa apenas a cópia local, então com o salvamento na nuvem ligado a próxima sincronização pode trazer de volta as estrelas antigas; por enquanto aceitamos isso.

Testar é mais um ritual: resolva uma porta, apague o app, instale de novo, entre na conta e veja as estrelas voltarem. No iPhone espere um pequeno atraso, porque a sincronização do iCloud não é instantânea.

Perguntas frequentes

Por que pegar o máximo em vez do salvamento mais recente?

Os valores de progresso só sobem, então o número maior é sempre o correto, e não precisa de carimbos de data nem de telas de conflito.

O que é guardado na nuvem?

Estrelas das portas, estrelas das fases, portas desbloqueadas e um contador total. Configurações, flocos de neve, dicas, texto da cápsula de desejos e fotos ficam no dispositivo.

O que acontece se a nuvem estiver indisponível?

O app continua funcionando e salva localmente. A mesclagem acontece na próxima vez em que a nuvem puder ser alcançada.

Isso funciona para pontuações que podem diminuir?

Não. Para valores que podem diminuir, como um reinício ou um item removido, são necessários carimbos de versão ou marcas de exclusão.

Mais do blog