Deliver (Fastlane) — o que é, upload para App Store e configuração no desenvolvimento iOS e Android

O que é Deliver (Fastlane)?

Deliver (Fastlane) é um componente do ecossistema Fastlane que automatiza o processo de publicação de aplicativos móveis na App Store. Ele gerencia uploads de arquivos binários, atualizações de metadados (nome, descrição, palavras-chave), upload de capturas de tela e configuração de preços para todos os idiomas de localização.

Sem o Deliver, cada lançamento requer atualização manual das informações através da interface web do App Store Connect: preencher descrições em vários idiomas, enviar capturas de tela para cada tamanho de tela, atualizar palavras-chave e configurar preços. A publicação na App Store é a etapa final do ciclo de vida de um aplicativo iOS, que inclui verificação do arquivo binário, moderação de conteúdo e disponibilização do aplicativo em produção.

De acordo com a Documentação do App Store Connect (2025), aplicativos com atualizações regulares recebem 30% mais reinstalações e têm melhor classificação nos resultados de busca. O Deliver permite que as equipes publiquem atualizações semanalmente, automatizando etapas rotineiras de publicação e reduzindo o risco de erro humano ao preencher metadados em dezenas de idiomas.

Use o Deliver para qualquer aplicativo publicado na App Store — é especialmente valioso para projetos com localização multilíngue onde a atualização manual de 32 idiomas leva várias horas.

Como o Deliver funciona com o App Store Connect

O mecanismo de funcionamento do Deliver é baseado em um processo de duas etapas. Na primeira etapa, a ferramenta prepara os metadados — valida a estrutura do Deliverfile, carrega as capturas de tela e gera um manifesto de alterações. Na segunda etapa, o Deliver envia os dados para a API do App Store Connect, envia o arquivo binário e inicia o processo de verificação da compilação no lado da Apple.

O Deliver usa a API do App Store Connect para todas as operações, garantindo compatibilidade com os requisitos mais recentes da Apple e eliminando o uso de interfaces privadas. A API do App Store Connect é a API REST oficial da Apple para automatizar operações de aplicativos, incluindo upload de compilações, gerenciamento de metadados e acompanhamento do status da revisão.

Upload de arquivos binários

O Deliver integra-se diretamente com o Gym através do Fastlane: após a compilação do IPA, o Deliver o envia para o App Store Connect e inicia o processamento. O parâmetro --ipa especifica o caminho para o arquivo binário. Se não for especificado, o Deliver encontra automaticamente o IPA mais recente no diretório de compilação indicado no Gymfile ou passado através de etapas anteriores do Fastlane.

Após o upload, o Deliver aguarda a conclusão do processamento do arquivo binário pela Apple — similar ao Pilot, o status é acompanhado através de uma barra de progresso. Status disponíveis: Processing, Waiting For Review, In Review, Ready For Sale ou Rejected. O Deliver notifica a equipe sobre cada mudança de status através de callbacks no Fastfile.

Gerenciamento de metadados do aplicativo

O Deliver gerencia o conjunto completo de metadados do aplicativo: nome, descrição (curta e completa), palavras-chave, URLs de suporte e marketing, categoria e classificação etária. Os metadados do aplicativo são as informações textuais sobre o aplicativo exibidas na página da App Store e usadas para indexação de busca e otimização ASO.

O parâmetro --submit_for_review envia o aplicativo para moderação imediatamente após o upload dos metadados. Este é um parâmetro chave para lançamentos totalmente automatizados. Sem ele, o Deliver apenas envia os dados, mas não submete o aplicativo para revisão — útil para verificar previamente todos os campos antes do envio real.

Trabalho com capturas de tela

O Deliver envia automaticamente capturas de tela para todas as combinações de dispositivos e idiomas a partir do diretório especificado. Os nomes dos arquivos devem seguir o padrão: iPhone_6.5_01.png para um iPhone de 6,5 polegadas no primeiro slot. O Deliver determina o tamanho da captura e o combina com os requisitos da Apple para cada tipo de dispositivo.

As capturas de tela são enviadas na ordem correta e separadamente para cada idioma de localização. Se não forem encontradas capturas para um idioma, o Deliver usa as versões em inglês como alternativa. A localização de capturas de tela é um requisito obrigatório para aplicativos que desejam ter uma boa classificação na App Store de diferentes países, pois a Apple considera o conteúdo local nos resultados de busca.

# Comando básico de upload para App Store
fastlane deliver

# Upload com metadados e capturas especificados
fastlane deliver --ipa "build/MyApp.ipa" \
      --force --submit_for_review

# Visualização prévia sem upload
fastlane deliver --preview

Configuração do Deliver via Deliverfile

Deliverfile é um arquivo de configuração do Fastlane para armazenar metadados do aplicativo em um formato Ruby estruturado. Ao contrário do preenchimento manual de formulários no App Store Connect, o Deliverfile permite versionar metadados no Git e verificar alterações através de revisão de código antes da publicação.

# Deliverfile — metadados do aplicativo
app_identifier("com.company.app")
title("MyApp")
description("Descrição do aplicativo para a loja")
keywords("móvel, aplicativo, ios, swift")
support_url("https://company.com/support")
marketing_url("https://company.com")
privacy_url("https://company.com/privacy")

# Idiomas de localização de metadados
languages(["en-US", "ru", "de"])

O parâmetro languages determina para quais idiomas os metadados serão enviados. Um diretório separado deve ser criado para cada idioma na pasta fastlane/metadata com os arquivos correspondentes de descrição, palavras-chave e textos de marketing. O Deliver suporta até 32 idiomas da App Store simultaneamente.

Para upload de capturas de tela, é usado o diretório screenshots dentro da pasta do Fastlane. Estrutura de pastas: screenshots/[Language]/[DeviceType]_[ScreenSize]_[Number].png. O Deliver envia automaticamente as capturas para os idiomas e dispositivos especificados, combinando os tamanhos com os requisitos da Apple. Recomenda-se usar o Snapshot para gerar capturas de tela — seu formato de saída é compatível com o Deliver.

O grupo de preços é configurado através do parâmetro price_tier, que aceita um número de nível de preço de 0 a 87. Os níveis de preço da Apple são automaticamente convertidos para as moedas de todos os países de presença. O Deliver permite alterar o preço como parte de um lançamento, útil para promoções temporárias ou mudanças no modelo de negócios do aplicativo.

Comandos do Deliver para publicar aplicativos

A interface do Deliver inclui comandos para enviar metadados, arquivos binários, capturas de tela e lançamentos completos. O comando principal fastlane deliver sem parâmetros usa os dados do Deliverfile e do diretório de metadados para um ciclo completo de publicação.

O comando fastlane deliver --preview executa uma verificação preliminar de metadados sem realmente enviar para o App Store Connect. --force é necessário para o upload — sem ele, o Deliver opera no modo de visualização. O parâmetro --skip_binary envia apenas metadados e capturas de tela, pulando o upload do arquivo binário — conveniente para atualizar rapidamente campos ASO sem um novo lançamento.

# Lançamento completo com upload de binário
fastlane deliver --force --ipa "build/App.ipa"

# Enviar apenas metadados sem binário
fastlane deliver --force --skip_binary

# Atualizar apenas capturas de tela
fastlane deliver --force --skip_metadata

O parâmetro --skip_metadata envia apenas capturas de tela e o arquivo binário, mantendo os metadados existentes inalterados. Isso é útil para lançamentos de hotfix quando é necessário publicar uma correção rapidamente sem alterar a descrição e os campos ASO. A combinação de flags permite gerenciar flexivelmente cada etapa de publicação separadamente.

Integração do Deliver no pipeline de lançamento

O pipeline de lançamento com Deliver é um processo CI/CD completo para iOS que automatiza todas as etapas do commit à publicação na App Store. Um pipeline típico inclui: Match para certificados, Gym para compilações IPA, Snapshot para capturas de tela e Deliver para enviar todos os dados ao App Store Connect com posterior envio para moderação.

Uma característica chave do Deliver no pipeline é o suporte a metadata.json, que armazena metadados em um formato JSON estruturado. Isso permite gerar metadados programaticamente a partir de sistemas CMS externos ou criar descrições automaticamente em vários idiomas através de uma API de tradução.

# Pipeline de lançamento no Fastfile
lane :release do
    match(type: :appstore)
    capture_screenshots
    gym(scheme: "MyApp", export_method: "app-store")
    deliver(ipa: "build/MyApp.ipa", force: true, submit_for_review: true)
end

Antes de chamar o Deliver no pipeline, certifique-se de que todos os metadados estão atualizados: a descrição corresponde à nova versão, as capturas de tela estão atualizadas para as novas funcionalidades e o grupo de preços não precisa de alterações. Submit for review envia o aplicativo para moderação da Apple, que leva de 24 a 48 horas para aplicativos novos e de 2 a 12 horas para atualizações.

O Deliver suporta o mecanismo app_version, que permite especificar a versão alvo para atualizações de metadados. Se a versão não for especificada, o Deliver atualiza a versão ativa atual do aplicativo no App Store Connect. Para lançar uma nova versão, é necessário primeiro criar a versão correspondente através da interface do App Store Connect ou da API.

Erros comuns ao trabalhar com Deliver

Ao usar o Deliver, os desenvolvedores frequentemente encontram erros de validação de metadados, estrutura incorreta de arquivos de capturas de tela e problemas de autenticação. O diagnóstico de erros no Deliver começa com a análise dos logs do comando — o Deliver fornece informações detalhadas sobre cada etapa do upload e os motivos da rejeição.

O erro “Invalid screenshot path” ocorre quando a estrutura de pastas das capturas de tela não corresponde ao formato esperado. Solução: verifique se os nomes dos arquivos de captura seguem o padrão DeviceType_ScreenSize_Number.png (por exemplo AppleiPhone15ProMax_6.7_01.png). O Deliver diferencia maiúsculas de minúsculas e é sensível a separadores nos nomes de arquivos.

O erro “Metadata validation failed” indica que os metadados não atendem aos requisitos da App Store. Solução: verifique o comprimento da descrição (até 4000 caracteres), das palavras-chave (até 100 caracteres) e do nome (até 30 caracteres). As diretrizes de revisão da App Store contêm requisitos completos para cada campo de metadados — é recomendável verificá-los antes de cada lançamento.

Com o erro “Apple ID not found”, o aplicativo não existe no App Store Connect com o apple_identifier especificado. Solução: crie a entrada do aplicativo no App Store Connect através da interface web antes da primeira chamada do Deliver, especificando o Bundle Identifier e o nome. O Deliver não cria novos aplicativos — ele apenas atualiza entradas existentes na loja.