Runbook • App Store • iOS, iPadOS e CarPlay

Publique o app para iPhone da sua rádio na App Store

Publique o app da rádio na App Store a partir da sua própria conta Apple Developer. O painel entrega um projeto Xcode completo: sem CocoaPods, sem pacotes Swift, nada para baixar. Você assina com a sua equipe em um Mac, arquiva, envia ao App Store Connect e passa pela revisão da Apple. O CarPlay é uma permissão que a Apple concede separadamente, em um formulário que pede a página do app na App Store, então ele chega em uma versão posterior.

Abra seu painel de controle
Apple Developer Program: US$ 99 por ano Xcode 26 ou posterior, no macOS iOS 16 e posterior, iPhone e iPad

Procedimento

Os rótulos seguem o Xcode 26 e o App Store Connect de 2026. A Apple renomeia telas entre versões; cada etapa indica a finalidade da tela.

1

Inscreva-se no Apple Developer Program

  1. Inscreva-se em developer.apple.com/programs usando uma Conta Apple que a rádio controle a longo prazo.
  2. Inscreva-se como pessoa física (a App Store mostra seu nome pessoal como vendedor) ou como organização (o nome da pessoa jurídica; exige o número D-U-N-S dela).
  3. Pague a taxa anual de US$ 99. A aprovação pode levar alguns dias, normalmente mais para organizações.
2

Prepare o Xcode

  1. Instale o Xcode pela Mac App Store, sem custo.
  2. Use o Xcode 26 ou posterior: desde 2026, o App Store Connect rejeita uploads compilados com um SDK anterior ao iOS 26.
  3. Adicione sua conta de desenvolvedor em Xcode → Ajustes → Contas para que a assinatura automática possa criar certificados e perfis.
3

Abra o projeto e defina a equipe

  1. Baixe o projeto Xcode (.zip) do painel e extraia-o.
  2. Abra StationApp.xcodeproj.
  3. Selecione o alvo StationApp e abra Assinatura e Recursos.
  4. Mantenha Gerenciar assinatura automaticamente ativado e escolha sua Equipe. O bundle identifier já vem definido por Config/Station.xcconfig; o Xcode o registra como um App ID na sua equipe.

Não mexa nas configurações de build. Tudo o que é específico da rádio fica em Config/Station.xcconfig, que o gerador grava, e editá-lo à mão divergiria do que o painel compila na próxima vez.

4

Crie o registro no App Store Connect

  1. Em appstoreconnect.apple.com, vá em Apps e depois em + → Novo App.
  2. Plataforma iOS; um nome com 30 caracteres ou menos; o idioma principal.
  3. Selecione o bundle ID registrado na etapa 3 e informe um SKU: uma referência interna de sua escolha, nunca exibida publicamente.

Se o bundle ID não aparecer no menu, registre-o manualmente em Certificados, Identificadores e Perfis → Identificadores em developer.apple.com, copiando o valor do painel.

5

Arquive e envie o build

  1. Defina o destino de execução como Qualquer Dispositivo iOS (arm64).
  2. Produto → Arquivar. O Organizer abre no novo arquivo.
  3. Distribuir App → App Store Connect, aceitando as opções padrão.
  4. Aguarde o processamento; o build aparece no App Store Connect quando termina, e a Apple envia um e-mail.

Conformidade de exportação: o Info.plist define ITSAppUsesNonExemptEncryption como NO, então builds processados não devem ficar aguardando a pergunta sobre criptografia.

6

Complete os metadados da listagem

  1. Informações do App: subtítulo (opcional) e categoria principal, normalmente Música. Em direitos de conteúdo, declare que o app transmite sua própria programação.
  2. Preços e Disponibilidade: o nível gratuito e os territórios desejados.
  3. Privacidade do App: informe a URL da política de privacidade gerada e declare que o app não coleta dados. A listagem mostra Dados Não Coletados, o que corresponde ao manifesto de privacidade compilado no build.
  4. Metadados da versão: descrição, palavras-chave, URL de suporte, copyright e o build processado.
  5. Capturas de tela: a família de dispositivos alvo é iPhone e iPad, então os dois conjuntos são obrigatórios. Os espaços obrigatórios do App Store Connect são iPhone com Dynamic Island (tela média) em 1206 × 2622 ou 1179 × 2556 px e tela de iPad de 13 polegadas em 2064 × 2752 ou 2048 × 2732 px. Execute o app em um simulador de iPhone 18 Pro ou 17 Pro (um Pro Max renderiza no tamanho de tela grande, que esse espaço rejeita) e em um iPad Pro de 13 polegadas, e capture com o controle de captura abaixo da visualização do dispositivo (no Xcode mais antigo, Simulador Arquivo → Salvar Tela). Os arquivos são salvos na Mesa.
  6. Classificação indicativa: responda ao questionário da Apple para a sua programação.

O ícone da App Store é lido do catálogo de assets do build; o App Store Connect não tem upload de ícone separado.

7

Oriente a revisão da Apple

  1. Em Informações da Revisão do App, informe um contato acessível.
  2. Desmarque Login obrigatório: o app não tem contas, então não há credenciais de demonstração para fornecer.
  3. Use Notas para descrever o app como o player oficial da rádio para sua transmissão ao vivo, programação e podcasts, e informe seus horários no ar se você não transmite continuamente.
  4. Tenha a documentação de licenciamento musical à mão. Os revisores podem pedir evidências do direito de transmitir sua música sob a diretriz 5.2.3.

Diretriz 4.2.6: a Apple rejeita apps gerados a partir de modelos, a menos que o provedor de conteúdo os envie. Enviar pela conta de desenvolvedor da própria rádio é o caminho em conformidade, e a razão pela qual o painel nunca publica em seu nome.

8

Envie

  1. Na página da versão, Adicionar para Revisão e depois Enviar para Revisão do App.
  2. A maioria das revisões termina em poucos dias. As perguntas chegam no App Store Connect e geralmente podem ser respondidas lá sem um novo build.
  3. Ao ser aprovado, libere manualmente ou deixe a versão ser liberada automaticamente.
9

Solicite e ative o CarPlay

Apps de áudio para CarPlay precisam da permissão com.apple.developer.carplay-audio na sua equipe, que só a Apple pode conceder.

  1. O Titular da Conta da equipe preenche o formulário de solicitação de permissão do CarPlay da Apple na categoria de áudio, indicando o conteúdo de áudio que o app reproduz. O formulário pede a página do app na App Store, então envie-o depois que a primeira versão estiver no ar. As respostas costumam levar de uma a três semanas.
  2. Mantenha o interruptor de CarPlay do painel desligado até lá. Um projeto CarPlay falha na assinatura automática em uma equipe sem a permissão, porque o perfil de provisionamento não a possui.
  3. Depois de concedida, ative o interruptor do painel com o rótulo "A Apple aprovou o CarPlay para meu app", recompile o iOS e baixe o novo projeto. Ele passa a usar o Info.plist e o arquivo de permissões do CarPlay.
  4. Arquive e envie como na etapa 5, crie uma nova versão na App Store correspondente à versão exibida no build do painel, anexe o build e envie.

Atualizações: mesmo ciclo, da recompilação ao envio. O feed da rádio carrega transmissões, programação, podcasts e links, então nada disso exige uma versão.

Perguntas frequentes sobre publicar um app de rádio na App Store

Quando o CarPlay pode ser solicitado, para que serve um Mac, o que um revisor precisa ver e para onde vai um arquivo.

A primeira versão pode sair com CarPlay?

Não. O áudio do CarPlay exige a permissão com.apple.developer.carplay-audio na sua equipe, e o formulário da Apple pede a página do app na App Store, que só existe depois que uma versão está no ar. Então a ordem é: envie sem CarPlay, seja aprovado e, em seguida, o Titular da Conta preenche o pedido na categoria de áudio - etapa 9. As respostas costumam levar de uma a três semanas. Até a concessão, deixe o interruptor de CarPlay do painel desligado: um projeto CarPlay falha na assinatura automática em uma equipe cujo perfil de provisionamento não tem a permissão. Depois de concedida, ligue-o, recompile o iOS, arquive e envie como uma nova versão. O CarPlay então mostra a lista Ao Vivo, Podcasts e Tocando Agora na interface do próprio carro. O Android Auto é distribuição, não permissão, no runbook do Google Play.

Preciso de um Mac para publicar o app de iPhone?

Sim, para o arquivo e o upload. O Xcode roda apenas no macOS, e o iOS é a única plataforma que chega como código-fonte: o painel compila um projeto Xcode completo, e a assinatura, Produto → Arquivar e Distribuir App acontecem em um Mac com Xcode 26 ou posterior. Tudo depois do upload é trabalho de navegador no App Store Connect, em qualquer máquina. Nenhum certificado ou chave da Apple próprio é necessário além da conta de desenvolvedor, porque a assinatura automática os cria. O app Android não exige desktop algum - o App bundle chega assinado e é enviado pelo navegador.

A revisão da Apple aceitará um app que reproduz uma transmissão de rádio?

Duas diretrizes decidem isso. A 4.2.6 recusa apps gerados a partir de um modelo, a menos que o provedor de conteúdo os envie, e é por isso que você publica com a conta da própria rádio e nós nunca publicamos por você. A 5.2.3 permite que um revisor peça evidências de que você tem o direito de transmitir sua música, então mantenha a documentação de licenciamento à mão. A funcionalidade mínima é a terceira questão, e o build a responde: cada transmissão do plano com seletor de qualidade e economia de dados no celular, reconexão após quedas e mudanças de rede, controles na tela de bloqueio e na Central de Controle, a programação quando a rádio publica uma, podcasts dos seus feeds RSS, tocadas recentemente, músicas curtidas, timer de sono com fade-out, AirPlay e rótulos VoiceOver. Descreva isso na descrição da versão e nas notas da revisão do app, em vez de deixar o revisor descobrir sozinho.

Produto → Arquivar terminou - onde está o build?

No Organizer do Xcode, em Janela → Organizer → Arquivos, que abre sozinho quando um arquivo termina. Selecione-o e use Distribuir App → App Store Connect para enviar. Duas coisas confundem as pessoas: Arquivar fica indisponível enquanto o destino de execução é um simulador, então defina Qualquer Dispositivo iOS (arm64) primeiro - etapa 5; e um build enviado não fica selecionável na hora, porque o App Store Connect o processa e envia um e-mail quando termina. O build processado precisa então ser anexado à página da versão manualmente, em Build, antes que Adicionar para Revisão aceite a versão. O que cada build contém está na página do app de rádio.

Precisa de ajuda? Fale conosco no chat

Um erro de assinatura no Xcode, uma rejeição da revisão da Apple ou um bundle ID ausente: envie ao suporte no chat, a qualquer hora.

Todos os runbooks