Todos os produtos
Search
Central de documentação

Mobile Platform as a Service:Android release management

Última atualização: Jun 28, 2026

O gerenciamento de versões permite controlar como as atualizações de aplicativos Android são entregues aos usuários. Configure pacotes de implantação e tarefas de versão para direcionar usuários específicos por cidade, modelo de dispositivo, versão do sistema operacional, rede ou versão do aplicativo.

Capacidades

O gerenciamento de versões para Android oferece suporte aos seguintes recursos:

  • Faça upload de recursos de atualização e gere um QR code para baixe.

  • Crie e modifique pacotes de implantação.

  • Crie múltiplas tarefas de versão para uma única versão de pacote de implantação, incluindo versões graduais por lista de permissões, versões graduais por janela de tempo e versões completas.

  • Filtre atualizações por cidade, modelo de dispositivo, versão do sistema operacional, rede e versão do pacote de implantação.

Adicionar um pacote de implantação

  1. No console do mPaaS, acesse Real-time Release > Release Management no painel de navegação à esquerda.

  2. Clique em Add Deployment Package e configure as seguintes definições:

    • Platform: Selecione Android.

    • Deployment Package: Faça upload de um arquivo .apk da sua máquina local. Apenas o formato .apk é suportado.

    • Version Number: Insira o número da versão do pacote de implantação. O número da versão consiste em números e símbolos.

    • Release Description: Insira uma descrição para o pacote de implantação.

    • Download Verification: Ative esta opção para exigir que os usuários concluam uma verificação de Captcha após escanear o QR code, antes que o baixe comece.

  3. Clique em OK. O novo pacote de implantação aparece no topo da lista e um QR code é gerado na coluna QR Code. Escaneie o QR code para baixar e instale o arquivo .apk em um dispositivo.

  4. Na lista de gerenciamento de versões, clique em no ícone de mais (add) ao lado de um pacote de implantação para visualize suas tarefas de versão:

    • Se o pacote de implantação não tiver sido lançado, seu status será To be released e ele não terá tarefas de versão associadas.

    • Caso o pacote de implantação já tenha sido lançado, seu status refletirá a tarefa mais recente e suas tarefas de versão associadas serão listadas.

Crie uma tarefa de versão

Um pacote de implantação pode ter múltiplas tarefas de versão simultâneas — até 10 por vez. Quando as solicitações do cliente correspondem a mais de uma tarefa ativa, aplicam-se as seguintes regras de entrega:

  • Se uma solicitação do cliente corresponder a várias tarefas de versão, a tarefa referente à versão superior do pacote será entregue primeiro.

  • Quando uma solicitação do cliente corresponder a múltiplas tarefas de versão para a mesma versão do pacote de implantação, a prioridade de entrega será determinada pelo tipo de tarefa. A prioridade, da maior para a menor, é: Full > Whitelist (Phased) > Time-window (Phased).

  • Se a versão do pacote de implantação e o tipo de tarefa forem idênticos, a tarefa lançada mais recentemente será entregue. Por exemplo, suponha que você lance uma tarefa de lista de permissões A para a versão 5,0, tendo como alvo a versão 4,0 para uma atualização única. Em seguida, você lança outra tarefa de lista de permissões B, também direcionada à versão 4,0, mas para uma atualização obrigatória. Se ambas as tarefas estiverem ativas, um cliente na versão 4,0 que solicitar uma atualização receberá primeiro a tarefa B. Após a tarefa B ser interrompida ou pausada, o cliente receberá a tarefa A.

  • Caso uma tarefa gradual e uma tarefa completa sejam lançadas para a mesma versão, o status da versão será Full Release. Depois que a tarefa completa for pausada ou encerrada, o status mudará para Phased Release. Se todas as tarefas forem encerradas, o status mudará para Release Ended.

Para crie uma tarefa de versão:

  1. Localize o pacote de implantação para o qual deseja crie uma tarefa de versão.

  2. Na coluna Operations, clique em Create Release Task.

  3. Na página Create Release Task, configure as seguintes definições:

    • Release Type: Selecione Phased ou Full.

    • Upgrade Mode: Escolha uma das seguintes opções:

      • One-time: Um aviso de atualização aparece uma vez após a inicialização do aplicativo, sujeito à política de silêncio.

        Nota

        A política de silêncio controla quanto tempo o aplicativo aguarda antes de exibir o aviso de atualização novamente depois que um usuário o dispensa. O período de silêncio padrão é de 3 dias. Para personalizar esse período, consulte setIntervalTime.

      • Multiple: Um aviso de atualização aparece sempre que o aplicativo é iniciado. O usuário pode dispensar o aviso.

      • Forced Upgrade: Um aviso de atualização aparece sempre que o aplicativo é iniciado. O usuário não pode dispensar o aviso.

    • Release Model (apenas para versões graduais): Selecione Whitelist Phased Release ou Time-window Phased Release.

      • Ao selecione Whitelist Phased Release, escolha uma lista de permissões como alvo.

        Nota: Configure as listas de permissões em Whitelist Management antes de crie a tarefa. Para mais detalhes, consulte Whitelist Management.

      • Ao selecione Time-window Phased Release, defina o End Time e o Number of Users para a janela de versão.

    • Upgrade Prompt Message (opcional): A mensagem exibida aos usuários durante a atualização.

    • Release Description (opcional): Uma descrição desta versão.

    • Advanced Rules (apenas para versões graduais): Clique em Add e selecione Include ou Exclude para condições como City, Model e Network. Escolha um Resource Value correspondente ao Type selecionado.

  4. Clique em OK para iniciar a versão. Clique em no ícone de mais (add) ao lado do pacote de implantação para verifique se a tarefa foi criada.

  5. Para crie mais tarefas de versão, repita as etapas acima.

Gerencie tarefas de versão

Após crie as tarefas de versão, você pode pausá-las, retomá-las ou encerrá-las.

  1. Na lista de gerenciamento de versões, clique em no ícone de mais (add) ao lado de um pacote de implantação para visualize suas tarefas de versão.

  2. Execute qualquer uma das seguintes operações:

    • Clique em Pause para pausar a tarefa de versão. Para retomar uma tarefa pausada, clique em Resume.

    • Clique em End para interromper permanentemente a tarefa de versão. Tarefas encerradas não podem ser modifique ou reiniciadas.