Índice
1. O que é o Transporter
O Transporter é um aplicativo gratuito da Apple disponível na Mac App Store que serve exclusivamente para fazer upload de builds (.ipa ou .pkg) para o App Store Connect. É a alternativa ao fluxo de distribuição nativo do Xcode Organizer.
Antes do Xcode 11, o Transporter era chamado de "Application Loader" — a funcionalidade é a mesma, apenas o nome e a interface mudaram.
2. Quando usar o Transporter
O Transporter é útil em situações específicas:
- Pipelines de CI/CD: quando o build é gerado automaticamente (por Fastlane, Bitrise, GitHub Actions) e você precisa fazer o upload sem abrir o Xcode manualmente.
- Uploads agendados ou em lote: o Transporter CLI permite automatizar uploads via scripts.
- Quando o Xcode Organizer trava: alguns desenvolvedores usam o Transporter como alternativa quando o fluxo nativo do Organizer apresenta problemas.
- Builds gerados fora do Xcode: builds criados por ferramentas de terceiros (Unity, Godot) que geram um .ipa diretamente.
Para a maioria dos casos — publicação manual pelo desenvolvedor — o Xcode Organizer é mais conveniente. O Transporter brilha em automação.
3. Como instalar
O Transporter está disponível gratuitamente na Mac App Store. Busque por "Transporter" na Mac App Store ou acesse diretamente pelo link apps.apple.com/br/app/transporter. O app é desenvolvido pela Apple Inc. — certifique-se de instalar o oficial.
Também está disponível como ferramenta de linha de comando, incluída no pacote do Xcode em /Applications/Xcode.app/Contents/SharedFrameworks/ContentDeliveryServices.framework/Versions/A/Frameworks/AppStoreService.framework/ — mas a maioria dos usuários usa via Fastlane ou Xcode diretamente.
4. Como usar a interface gráfica
Login com Apple ID
Abra o Transporter e faça login com o Apple ID da conta Apple Developer. Se a conta usa autenticação de dois fatores (obrigatória), você pode precisar gerar uma App-Specific Password em appleid.apple.com para usar no Transporter.
Adicionar o arquivo
Clique em "Add App" ou arraste o arquivo .ipa para a janela do Transporter. O app vai verificar o arquivo e mostrar informações básicas (nome do app, versão, bundle ID).
Entregar
Clique em "Deliver" para iniciar o upload. O Transporter valida o arquivo localmente antes de enviar — erros de assinatura ou formato são detectados aqui. Após a validação, o upload começa e pode levar de 2 a 15 minutos.
5. Transporter via linha de comando
Para automação em CI/CD, o Transporter pode ser usado via linha de comando com o utilitário iTMSTransporter. O Fastlane usa internamente essa ferramenta — o lane upload_to_app_store do Fastlane chama o iTMSTransporter automaticamente.
Para uso direto, gere uma App-Specific Password em appleid.apple.com → Sign-In and Security → App-Specific Passwords. Use essa senha no script em vez da senha principal da conta Apple.
✓ Em pipelines de CI/CD, sempre use App-Specific Passwords — nunca a senha principal da conta Apple. As App-Specific Passwords podem ser revogadas individualmente sem afetar outras integrações.
6. Transporter vs. Xcode Organizer
- Xcode Organizer: integrado ao Xcode, mais conveniente para fluxos manuais. Não requer download separado. Permite validar, distribuir e ver relatórios de crash em uma única interface.
- Transporter: app separado e leve. Ideal para automação e CI/CD. Pode ser usado sem abrir o Xcode completo. Suporta linha de comando.
Para publicações manuais do dia a dia, o Xcode Organizer é mais completo. Para equipes com pipeline automatizado, o Transporter (ou Fastlane, que usa o Transporter internamente) é a escolha certa.
7. Erros comuns
- "Invalid credentials": use uma App-Specific Password — a senha principal da conta Apple não funciona no Transporter.
- "The file is not a valid IPA": o arquivo .ipa está corrompido ou não foi gerado corretamente. Gere um novo archive.
- Upload falha sem mensagem de erro: problema de rede ou timeout. Tente novamente em alguns minutos ou verifique o status dos serviços Apple em developer.apple.com/system-status.
Quer que a gente publique por você?
App Store e Google Play em até 7 dias. A partir de R$1.800.
Solicitar publicação