← Nesim Apps

Como um app de calendário do advento decide qual porta abre hoje

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

#Notas de desenvolvimento#Android

Um calendário do advento parece simples: uma porta por dia. Fazer com que ele se comporte bem com todo tipo de jogador não é. Alguém instala no dia 17 de dezembro. Alguém viaja entre fusos horários. Alguém esquece por uma semana. É assim que o calendário de quebra-cabeças de inverno do nosso app Snowlings resolve tudo isso, com uma peça pequena e pura de lógica de datas e sem servidor.

O ano é cortado em quatro fases

A tela do calendário depende apenas da data de hoje, e a data corresponde a uma de quatro fases. Novembro é uma prévia, com uma única porta de treino, para que o app não fique vazio antes da temporada. Dezembro é o advento propriamente dito: uma porta nova a cada dia. Janeiro e fevereiro são o modo inverno, em que todas as portas ficam abertas e podem ser jogadas de novo. De março a outubro o app fica tranquilo.

Um detalhe pequeno com grande efeito é o ano da temporada. De janeiro a outubro pertencem à temporada do dezembro anterior, então a árvore decorada continua lá na primavera, e só novembro inicia uma temporada nova. O progresso é guardado por ano de temporada e por porta, de modo que um novo dezembro começa com as portas vazias sem mexer nas estrelas do ano passado.

Qual porta está aberta

Durante o advento a regra é uma única comparação: uma porta está aberta quando o seu número não é maior que o dia do mês de hoje. No inverno e nos meses tranquilos todas as portas estão abertas. Na prévia de novembro só a porta de treino está aberta. Como a função recebe uma data e devolve uma resposta, é trivial testá-la com qualquer data, inclusive as incômodas.

Portas perdidas sem punição

Uma porta de um dia anterior de dezembro que nunca foi resolvida conta como perdida. Para abri-la, o jogador assiste a um anúncio curto ou gasta flocos de neve ganhos no jogo livre, e a escolha é guardada como uma marca de desbloqueio para aquela temporada e aquele dia, de modo que a porta não pergunta duas vezes.

Há uma regra que importa pela justiça. Se o jogador instala em dezembro, todas as portas anteriores ao dia da instalação ficam simplesmente abertas. Quem chega no dia 17 de dezembro não deveria encontrar um muro de anúncios em dezesseis portas. O app registra a data de instalação uma vez e a verificação de porta perdida é comparada com ela.

Fusos horários e o temporizador da meia-noite

Hoje é calculado a partir do relógio e do fuso horário do telefone, convertidos em uma data de calendário local. A contagem regressiva até a próxima porta pede os milissegundos que faltam para a próxima meia-noite local, que é o início do próximo dia local no fuso atual. A contagem regressiva do Ano Novo funciona do mesmo jeito, apontando para 1º de janeiro à meia-noite local.

A mesma ideia dá uma tela divertida à meia-noite: uma lista de cidades que já entraram no ano novo, montada com deslocamentos fixos de horário padrão em minutos para cada cidade. Os deslocamentos são os de dezembro, então a lista não depende de nenhum serviço online.

Uma curva de dificuldade que se lê em uma função

Cada porta é associada a um jogo e uma dificuldade por uma única função. Os seis jogos se revezam pelos dias, de modo que o mesmo jogo volta a cada seis portas. Os dias um a três começam no nível um, os dias quatro a sete no nível dois, os dias oito a vinte e um sobem de três a cinco, e o último trecho antes do fim chega a sete e oito. Os dias vinte e quatro e vinte e cinco são quebra-cabeças de imagem grande, e o dia trinta e um é o final que coloca a estrela na árvore.

Manter isso em uma função pura faz com que mudar o equilíbrio seja editar uma linha e que todos os jogadores vejam a mesma porta no mesmo dia.

Limites honestos

Não há servidor, então o app confia no relógio do telefone. Um telefone com a data errada mostra a porta errada. Para um calendário de quebra-cabeças gratuito aceitamos isso: um app local, que funciona sem conexão e dentro de um avião, vale mais para nós do que um relógio rígido. Se o seu calendário tem prêmios, você precisa de outro desenho.

Perguntas frequentes

O calendário precisa de conexão com a internet?

Não. A lógica de datas roda no dispositivo, então as portas funcionam sem conexão.

O que acontece com as portas que o jogador perdeu?

Podem ser abertas depois com um anúncio curto ou com flocos de neve ganhos no jogo livre, e o desbloqueio é lembrado.

E se alguém instala no meio de dezembro?

Todas as portas anteriores ao dia da instalação ficam abertas, então quem começa tarde não encontra um muro de anúncios.

Mudar a data do telefone abre portas antes da hora?

Sim. O app lê o relógio do telefone e não há servidor para conferi-lo, algo que aceitamos para um calendário de quebra-cabeças casual.

Mais do blog