Central de Ajuda

Leitura de 10 min

Geração de Aplicativo iOS: Passo a Passo

Introdução e Pré-requisitos

Antes de iniciar a geração do seu aplicativo iOS, certifique-se de ter todos os pré-requisitos listados abaixo. O não cumprimento de qualquer um deles pode impedir o sucesso do processo.

Pré-requisitos

Hardware e Sistema

  1. Computador Apple com MacOS 14.4.1 ou superior
    • ⚠️ Versões anteriores podem causar erros
    • ❌ Não funciona em máquina virtual (VM)
  2. iPhone para testes

Domínio e Certificados

  1. Domínio apontado para IP do servidor IXC
  2. Certificado SSL instalado
    • Pode ser o mesmo do sistema IXC

Contas e Aplicativos

  1. Conta Apple Developer Program ativa
  2. Xcode (última versão)

Arquivos Necessários

  1. GoogleService-Info.plist
    • Gerado no Firebase
    • Use mesmo projeto do Android (se existente)
  2. Ícone do Aplicativo
    • Resolução: 1024x1024 pixels
    • Formato: PNG
    • Fundo: Sólido (não transparente)
    • Script Imagemagick disponível para gerar variações

Próximos Passos

Após reunir todos os pré-requisitos, continue para a seção de geração do arquivo GoogleService-Info.plist

Importante

Mantenha todos os arquivos e credenciais em local seguro durante o processo de desenvolvimento

1. Primeiros Passos no Firebase

Esta seção detalha como gerar o arquivo GoogleService-Info.plist no Firebase.

  1. Acesse o site https://firebase.google.com/ com sua conta e clique em Ir para o console.
  2. Selecione o projeto já existente (ou crie um novo, caso não possua aplicativo Android).
  3. Abra o projeto e então clique em Adicionar app.
  4. Selecione a plataforma iOS.
  5. Preencha o campo ID do pacote Apple com o seu domínio de trás para frente.
    • Exemplo: Se o seu domínio for ixcteste.com.br, seu Bundle ID será br.com.ixcteste.
  6. Clique em Registrar app.
  7. Após registrar, você poderá baixar o arquivo GoogleService-Info.plist. Salve-o em um local seguro, pois ele será utilizado mais adiante no projeto.
  8. Após salvá-lo, avance o restante das etapas até voltar para o console do Firebase.

2. Instalação das Aplicações Necessárias

Requisito Inicial

Instale o Xcode através da App Store antes de prosseguir

Instalação via Terminal

1. Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Node

brew install node

3. CocoaPods

brew install cocoapods

4. Imagemagick

brew install imagemagick

5. Gsed

brew install gsed

6. Configuração Xcode

sudo xcode-select --switch /Applications/Xcode.app

Dicas para Instalação

  • Execute os comandos individualmente
  • Aguarde a conclusão de cada comando
  • Será necessária a senha do Mac para o último comando

3. Geração dos Ícones

Preparação

  1. Download do script
  2. Descompacte a pasta
  3. Prepare a imagem:
    • Resolução: 1024x1024 pixels
    • Formato: PNG
    • Nome: 1024x1024.png
    • Fundo: Sólido (não transparente)

Execução

  1. Coloque a imagem na pasta do script
  2. Abra o Terminal na pasta
  3. Execute os comandos:
chmod +x ./script.sh
./script.sh

Será criada uma pasta Images.xcassets com todos os ícones necessários

Importante

  • A imagem deve estar exatamente com o nome 1024x1024.png
  • Não use fundo transparente
  • Mantenha as dimensões exatas

4. Geração dos Certificados Necessários para o Aplicativo

Siga os passos abaixo para gerar os certificados necessários para o aplicativo.

  1. Abra o aplicativo Acesso às Chaves (Keychain) no Mac.
  2. Siga o caminho: Acesso às chaves > Assistente de Certificado > Solicitar um Certificado de uma Autoridade de Certificação.
  3. Preencha as informações de nome e e-mail.
  4. Selecione a opção Salvar no disco e salve o arquivo em um local seguro.
    • Importante: Repita este processo mais uma vez, pois serão necessários dois arquivos CertificateSigningRequest.certSigningRequest (request) mais adiante.
  5. Acesse sua conta de desenvolvedor em Apple Developer e clique em Certificates.
  6. Vá para Identifiers e então crie um novo Identifier.
  7. Selecione App IDs e continue.
  8. Selecione App e continue.
  9. Preencha a descrição com o nome que você dará ao aplicativo e o Bundle ID com o mesmo ID do pacote Apple (seu domínio de trás para frente) utilizado para gerar o arquivo GoogleService-Info.plist no Firebase.
  10. Desça a página até encontrar Push Notifications e selecione-a. Depois disso, pode continuar e então registrar.
  11. Ao registrar e voltar para Identifiers, clique no identificador que você acabou de criar.
  12. Desça novamente até Push Notifications e clique em Configure.
  13. Clique em Create Certificate, na seção Production SSL Certificate (não pode ser na Development SSL Certificate).
  14. Na próxima tela, faça upload do primeiro arquivo CertificateSigningRequest.certSigningRequest que você criou através do Acesso às Chaves e então clique em Continue.
  15. Faça o download do certificado e salve-o em um local seguro.
  16. Após baixar o certificado, instale-o em sua máquina com um duplo clique.
  17. Após esse duplo clique, ele será instalado e estará disponível no Acesso às Chaves, onde você deverá exportar a chave privada no formato .p12.
  18. Ao clicar em Exportar, será necessário adicionar uma senha para a chave privada, mas você pode deixar sem (em branco) e clicar em Ok.
  19. Depois disso, será necessário digitar a senha do Mac para liberar a exportação.
  20. Salve a chave privada em um local seguro. Será necessário fazer upload dessa chave no Firebase mais adiante.
  21. Volte ao site Apple Developer, acesse Certificates e crie um novo.
  22. Selecione a opção Apple Distribution e continue.
  23. Faça o upload do segundo arquivo CertificateSigningRequest.certSigningRequest que você gerou no Acesso às Chaves anteriormente e continue.
  24. Faça o download deste novo certificado em um local seguro.
  25. Instale-o da mesma maneira que instalou o anterior, com duplo clique.
    • Desta vez não será necessário exportar a chave privada.
  26. Acesse Profiles e crie um novo.
  27. Selecione a opção App Store Connect, na seção Distribution, e continue.
  28. Selecione o App ID que você criou anteriormente e continue.
  29. Selecione o certificado do App ID que você criou anteriormente e continue.
  30. Em Provisioning Profile Name, preencha o nome que você dará ao aplicativo e continue.
  31. Faça o download do arquivo (Nome_do_app.mobileprovision) em um local seguro.

5. Criação do Aplicativo na App Store Connect

Crie um novo aplicativo na App Store Connect.

  1. Acesse novamente a Apple Developer e desta vez clique em Apps.
  2. Crie um novo aplicativo.
  3. Preencha os campos conforme as informações do seu aplicativo.
  4. No campo SKU, coloque o mesmo nome do aplicativo, em letras minúsculas e sem espaços (pode separar as palavras com hifens).
  5. Após criar o novo aplicativo, você poderá fazer todo o processo no Xcode antes de retornar à App Store Connect.

6. Geração do Projeto no Xcode

Preparação Inicial

  1. Download do projeto base
  2. Descompacte no diretório Home/Usuário (Ctrl + Shift + H)
  3. Evite espaços no nome da pasta

Substituição de Recursos

  1. Substitua Images.xcassets em: 
    Projeto > ios > CentralMobile
  2. Atualize info.plist com nome do app
  3. Substitua GoogleService-Info.plist em: 
    Projeto > ios
  4. Configure URL em ConstantesHelper.js: 
    https://seudominio.com.br/central_assinante_ios

Comandos Terminal

Execute na pasta do projeto:

rm -rf node_modules
npm install -legacy-peer-deps
cd ios
rm -rf main.jsbundle
rm -rf Pods
pod install
cd ..
brew update
brew install watchman
npx react-native bundle --entry-file index.js --platform ios --dev false --bundle-output ios/main.jsbundle --assets-dest ios
gsed -i 's/11\.0/12.4/g' ios/Pods/Pods.xcodeproj/project.pbxproj

Configuração Xcode

Configuração Inicial

  1. Abra CentralMobile.xcworkspace
  2. Aguarde indexação
  3. Configure LaunchScreen e splash

Configurações do Projeto

  1. Adicione main.jsbundle
  2. Configure dispositivos suportados
  3. Defina categoria e nome
  4. Configure versão e build
  5. Configure Bundle Identifier
  6. Selecione conta desenvolvedor

Importante

  • Versão inicial: 1.0
  • Build inicial: 1
  • Bundle ID deve corresponder ao Firebase

Testes e Distribuição

Teste no Dispositivo

  1. Conecte iPhone ou use simulador
  2. Ative modo desenvolvimento no iPhone: 
    Configurações > Privacidade e Segurança > Modo de Desenvolvimento
  3. Registre dispositivo se necessário

Distribuição

  1. Execute build
  2. Acesse Product > Archive
  3. Selecione Distribute App
  4. Escolha TestFlight & App Store
  5. Complete distribuição

Próximos Passos

Após envio bem-sucedido, continue o processo na App Store Connect via navegador

7. Envio do Aplicativo para Análise através da App Store Connect

Após o upload do aplicativo, finalize a configuração e o envie para análise na App Store Connect.

  1. Acesse novamente a App Store Connect e abra o aplicativo que você havia criado anteriormente.
    • Às vezes pode demorar um pouco para que o upload do aplicativo após o “Archive” apareça nesta tela. Atualize-a com frequência.
  2. Clique no símbolo “+” para adicionar o build.
  3. Complete as informações da seção Informações para a equipe de revisão dos apps.
    • É necessário informar um cliente/login de teste, para que a Apple possa acessar a Central do Assinante e testar o aplicativo.
  4. Selecione o aplicativo e clique em Concluído.
    • Caso apareça a mensagem Faltam dados de conformidade após clicar em Concluído, selecione a opção Gerenciar e então marque o campo Nenhum dos algoritmos mencionados acima.
  5. Preencha as informações comuns do aplicativo, como Texto promocional (descrição breve) e Descrição (descrição completa).
  6. Em Palavras-chave, preencha com provedor, internet, finanças e mais palavras que você julgue necessárias.
  7. Em URL de suporte, preencha com o link de seu site (se você não tiver um site, utilize a URL da Central do Assinante).
  8. Em Copyright, preencha com o ano atual seguido do nome da sua empresa caso a conta de desenvolvedor seja empresarial; ou, com o nome do dono da conta, caso ela seja uma conta individual.
  9. Acesse Informações do app, confira se o nome está correto, selecione a categoria Finanças e após isso, clique em Configurar informações de direitos de conteúdo.
  10. Marque a opção Não, este app não contém, exibe ou acessa conteúdo de terceiros.
  11. Clique em Definir classificação etária em todas as plataformas.
  12. Marque todas as opções como Nenhum e clique em Próximo.
  13. Selecione as opções Não, este app não contém acesso irrestrito à internet e Não, este app não contém jogos de azar.
  14. Restrinja o acesso a maiores de 17 anos e então clique em Concluído.
  15. Acesse Preços e disponibilidade. Configure o preço gratuito e em Disponibilidade, deixe selecionado apenas o Brasil.
  16. Acesse Privacidade do app. Em Política de privacidade, insira o link da sua política de privacidade.
  17. Depois, clique em Começar.
  18. Marque a opção Não, nós não coletamos dados deste app e clique em Próximo.
  19. Acesse novamente 1.0 Preparar para envio. É obrigatório enviar no mínimo 3 capturas de cada um dos dispositivos: iPhone com tela de 6,5”, iPhone com tela de 5,5”, iPad Pro (6ª geração) com tela de 12,9” e iPad Pro (2ª geração) com tela de 12,9”.
  20. Ainda em 1.0 Preparar para envio, na App Store Connect, faça os uploads das capturas de tela e então clique na opção Adicionar para revisão.
  21. Na próxima tela, selecione a opção Enviar para Revisão do app.

8. Firebase, Chave Privada (.p12) e Chave do Servidor (Firebase Server Key)

Após enviar o aplicativo para revisão, retorne ao Firebase para configurar as notificações push e coletar a chave do servidor.

  1. Acesse a aba Cloud Messaging no Firebase.
  2. Desça até o aplicativo iOS e clique em Fazer upload, na seção de produção. Faça o upload do arquivo .p12 exportado através do Acesso às Chaves.
    • Lembre-se de que você não colocou senha no arquivo, portanto, deixe o campo que solicita a senha em branco.
  3. Vá para a aba Contas de acesso e clique em Gerar nova chave privada.
  4. Clique em Gerar chave. Você então irá fazer o download de um arquivo na extensão .json.
  5. Salve-o em um local seguro. Esta chave não deve ser compartilhada.
  6. Com o arquivo baixado, abra-o em um editor de texto, como o Sublime Text ou VSCode, por exemplo. Caso você não tenha nenhum deles instalado, poderá abrir o arquivo no Google Chrome.
  7. Copie todo o conteúdo (inclusive as chaves). Depois disso, você irá colocá-lo em seu sistema IXC Provedor.
  8. Acesse seu sistema IXC e vá para o caminho: Menu Sistema > Hotsite > Configurações > Configurações Gerais > Aba Aplicativos.
  9. Cole a informação copiada na etapa anterior no campo Arquivo de configuração do Firebase.
    • Se você já possui aplicativo Android no mesmo projeto do Firebase que está utilizando, pode ser que a chave já esteja inserida em seu sistema.
  10. Depois disso, basta salvar.

Considerações Finais

Pronto! Seu aplicativo para dispositivos iOS foi enviado para revisão com sucesso. Basta aguardar a Apple analisá-lo. Esse processo pode levar alguns dias.Caso esteja tudo certo e o aplicativo seja aprovado, o status dele na App Store Connect aparecerá como Pronto para a venda. Caso seja recusado, é necessário avaliar qual foi o motivo informado pela Apple. Em caso de dúvidas quanto à recusa, você pode abrir um novo atendimento com o nosso suporte. Além disso, caso haja algum erro no processo, principalmente se tratando dos comandos que precisam ser executados no Terminal, você também pode nos contatar para verificarmos.

Etiquetas

iOS Desenvolvimento AppStore Firebase Xcode MacOS Certificados AppDevelopment MobileApp CentralAssinante ConfiguracaoApp NotificacoesPush

Leia Também

Firebase Atualização App iOS

Visão de gráfico

Páginas relacionadas