Mobile Platform as a Service:Gerenciar release de iOS

O gerenciamento de release é o backend de configuração para atualizar o cliente para uma nova versão. Ele permite criar configurações de atualização multitarefa e multidimensionais.

Sobre esta tarefa

O gerenciamento de release de iOS oferece as seguintes funções:

• Adicionar recursos de atualização e exibir o QR code para baixar o app (apenas para Enterprise distribution).

• Criar e modificar a tarefa do pacote de recursos da nova versão.

• Criar vários tipos de tarefas de release para os pacotes adicionados, como release em escala de cinza por lista de permissões, release em escala de cinza por janela de tempo e release oficial. Um único pacote de atualização pode ter múltiplas tarefas de release.

• Filtrar atualizações com base em diversos critérios, como cidade, modelo, versão do sistema do dispositivo, rede e versão do pacote de release.

Adicionar pacote de release

Faça login no console mPaaS e execute as etapas a seguir:

1. No painel de navegação à esquerda, escolha Mobile Delivery Service > Release management. A lista de gerenciamento de release será exibida.

2. Clique em Add a package e preencha as configurações abaixo na janela pop-up:

   • Platform: Selecione iOS.

   • Release type: As opções incluem App Store, Enterprise distribution e TestFlight.

     • App Store: Solicita a atualização dos apps via download na App Store.

     • Enterprise distribution: Solicita a atualização de apps distribuídos internamente na empresa.

     • TestFlight: Realiza verificação em escala de cinza antes do lançamento da nova versão na App Store.

3. Clique em OK para concluir a adição. O pacote de release adicionado aparecerá no topo da página.

4. Na lista de gerenciamento de release, clique em no ícone de mais () ao lado do pacote de release para visualizar a tarefa de release do pacote de atualização:

   • Se o pacote de atualização nunca foi lançado, seu status será To be released e não haverá tarefas de release.

   • Caso o pacote já tenha sido lançado, o status refletirá a situação da tarefa mais recente e as tarefas de release estarão listadas.

App Store

Nota

Para utilizar o release via App Store, publique primeiro o seu app na App Store oficial da Apple.

Ao selecionar AppStore, forneça as informações abaixo:

• appstore address: Insira o endereço do seu app na App Store.

• Version number: Insira o número da versão deste release. O número da versão deve ser consistente com o campo Product Version no arquivo info.plist do projeto iOS.

• Release description (opcional): Descreva este release.

Enterprise distribution

Se optar por Enterprise distribution, forneça as seguintes informações:

• Upload icon (opcional): Faça upload de uma imagem nos formatos .jpg ou .png para usar como ícone.

• Release package: Selecione o pacote de release no computador local para upload. Apenas o formato .ipa é suportado.

• bundleId (opcional): bundleId do app. Se deixado em branco, o sistema usará o bundleId preenchido durante o download do arquivo de configuração na página de configuração de código.

• Version number: Insira o número da versão deste release. Este número deve corresponder ao campo Product Version no arquivo info.plist do projeto iOS.

• Release description (opcional): Descreva este release.

• Download verification: Quando ativado, após a leitura do QR code, o download do pacote só será permitido mediante verificação do código de validação.

  Nota

  Após adicionar o pacote de release do tipo Enterprise distribution, um QR code é gerado na coluna QR code da lista de gerenciamento de release para que os usuários baixem o pacote .ipa.

TestFlight

Nota

• Para usar os recursos de teste do TestFlight, crie e ative links públicos no App Store Connect.

• O TestFlight está disponível apenas em clientes com versão ≥ 10.1.32.

• Os valores de Package Expiration Time e Maximum number of testers informados devem corresponder às definições no App Store Connect.

Caso selecione TestFlight, informe os dados a seguir:

• Public link address: Insira o endereço do link público criado no App Store Connect. Certifique-se de que o link esteja ativo.

• Package expiration time: O tempo de expiração do pacote TestFlight deve ser igual ao configurado no App Store Connect.

• Maximum number of testers: O número máximo de testadores deve corresponder ao valor definido no App Store Connect.

• Version number: Insira o número da versão deste release. O número deve ser consistente com o campo Product Version no arquivo info.plist do projeto iOS.

• Release description (opcional): Descreva este release.

Criar uma tarefa de release

Ao criar uma tarefa para um pacote de release adicionado, configure múltiplas tarefas simultaneamente para a mesma versão. Um único pacote de atualização suporta até 10 tarefas de release ao mesmo tempo.

Regras para entrega de tarefas de release:

• Quando a solicitação do cliente corresponder a várias tarefas, a tarefa com a versão mais alta terá prioridade.

• Se um pacote possuir múltiplas tarefas, a prioridade por tipo será: Release oficial > Release em escala de cinza por lista de permissões > Release em escala de cinza por janela de tempo.

• Para um pacote de versão específica com tarefas do mesmo tipo, prevalecerá a tarefa lançada mais recentemente.

  Por exemplo, se uma tarefa A de lista de permissões da versão 5,0 for lançada no console para realizar uma atualização única da versão 4,0 e, em seguida, uma tarefa B de lista de permissões for lançada para forçar a atualização da versão 4,0, ambas coexistirão. Quando um cliente na versão 4,0 solicitar uma atualização, a tarefa B será entregue primeiro. Somente após o encerramento ou pausa da tarefa B é que a tarefa A será entregue.

• Quando uma versão tiver tarefas de escala de cinza e oficiais, o status na lista será exibido como "release oficial". Se a tarefa oficial for pausada ou encerrada, o status mudará para "release em escala de cinza". Caso todas as tarefas sejam concluídas, o status será "release concluído".

Siga os passos abaixo:

1. Localize o pacote de release para o qual deseja criar uma tarefa.

2. Na coluna Operation, clique em Create release task.

3. Na página Create a release task, selecione ou insira as informações a seguir:

   • Release type: Escolha entre Grayscale release e Official release.

     • Grayscale release: Antes do lançamento oficial, disponibilize o pacote para parte dos usuários a fim de validar se as funcionalidades atendem às expectativas.

     • Official release: Disponibilize o pacote oficialmente para todos os usuários.

       Nota

       Os tipos de distribuição TestFlight e Enterprise distribution suportam apenas Grayscale release. A página de release do TestFlight não exibe a opção Release type, e o pacote do tipo Enterprise distribution é fixado como Grayscale, sem possibilidade de alteração.

   • Upgrade mode: Selecione Single, Multiple ou Forced upgrade.

     • Single: Após iniciar o app, uma mensagem de atualização é exibida com base na estratégia silenciosa.

       Nota

       A estratégia silenciosa mantém o lembrete inativo por um período e deixa de notificar sobre a atualização caso o usuário cancele o pop-up. O período silencioso padrão é de 3 dias, mas pode ser personalizado. Para personalizar esse intervalo, consulte Lançar uma nova versão.

     • Multiple: O app exibe uma mensagem de atualização sempre que é iniciado.

     • Forced upgrade: O app mostra uma mensagem de atualização a cada inicialização e impede o fechamento da janela.

       Nota

       Para pacotes de release TestFlight, apenas as opções Single e Multiple estão disponíveis.

   • Release model (apenas quando Grayscale release estiver selecionado): Escolha entre Whitelist grayscale release e Time-window grayscale release.

     • Ao optar por Whitelist grayscale release, configure uma lista de permissões abaixo.

       Nota

       Configure a lista de permissões na página Whitelist management. Para mais detalhes, veja Gerenciar lista de permissões.

     • Se escolher Time-window grayscale release, especifique o End time e a quantidade de usuários (Users count).

       Nota

       Pacotes de release do tipo Enterprise distribution aceitam somente Whitelist grayscale release.

   • Upgrade prompt message (opcional): Defina uma mensagem para ser exibida durante a atualização.

   • Release description (opcional): Descreva este release. Campo facultativo.

   • Advanced rule (somente para Grayscale release): Clique em Add. Na caixa de diálogo exibida, selecione um tipo de regra como City, Device model ou Network em Type, defina Operation type como Include ou Exclude e configure o Resource value correspondente ao tipo escolhido.

4. Após concluir a configuração, clique em OK para iniciar o release. Clique em no ícone de mais () à esquerda do pacote de release para visualizar a tarefa criada.

Outras operações

• Upload symbol table: Na lista de gerenciamento de release, faça upload de uma tabela de símbolos para um pacote já adicionado.

  • Cada pacote de release .ipa corresponde a um arquivo de tabela de símbolos.

  • Apenas tabelas de símbolos no formato dSYM são suportadas. Antes do upload, compacte a tabela em um pacote .tgz.

• Alterar a tarefa de release de um pacote de atualização: Clique em no ícone de mais () ao lado do pacote na lista de gerenciamento de release para ver a tarefa associada.

  • Clique em Pause para suspender a tarefa de release. Para retomá-la, clique em Continue.

  • Clique em End para encerrar a tarefa de release. Após o encerramento, não será mais possível operá-la.