Ir para o conteúdo principal

Pronto - Como criar o App do Portal do Cidadão (iOS)


Data de elaboração  27/07/21
Responsável pelo estudo


  1. Rafael Passos dos Santos (Assessor)
Equipe do estudo
  1. Gustavo Felix Gomes (Assessor)
  2. Rafael Passos dos Santos (Assessor)
  3. André Honório de Andrade Silva (Tecnico)
  4. Emanuel Rufino Alcantara de Lima (Analista)
  5. Lucas de Souza e Sousa (Estagiario)
  6. Euriane Nogueira (Product Owner)
Alvo Portal do Cidadão
Origem

Mostrar como publicar aplicações PWA feitas em AspNetCore na App Store

Objetivo Ter um entendimento mais claro e estruturado de como publicar aplicações PWA feitas em AspNetCore na App Store, conforme a User Story: “Eu como vingadores, preciso realizar um estudo de caso de como criar aplicações para iPhone" presente na Sprint número 79 do time Vingadores.
Documentação correlata
Observações Este estudo serve como um passo a passo de uma possivel forma de publicar aplicações PWA feitas em AspNetCore na App Store

1. Objetivo

Ter um entendimento mais claro e estruturado de como publicar aplicações PWA feitas em AspNetCore na App Store, conforme a User Story: “Eu como vingadores, preciso realizar um estudo de caso de como criar aplicações para iPhone" presente na Sprint número 79 do time Vingadores.

2. Introdução

Diante da realização do desenvolvimento da aplicação Portal do Cidadão tendo como uma de suas características ser acessada por dispositivos moveis, é de grande valor para o cliente a criação de um App, onde deve ser disponível tanto na Play Store para dispositivos Androides, quanto na App Store para dispositivos iPhone. Deste modo, tornasse necessário a realização deste estudo para se ter uma base, de como publicar a aplicação PWA em AspNetCore para iPhone.

RESULTADOS ESPERADOS

Obter o conhecimento em forma de passo a passo de como publicar uma aplicação Web em AspNetCore para iPhone na App Store. 

3. Desenvolvimento - Como criar o App do Portal do Cidadão (iOS)

Apple tem políticas mais rígidas em relação a quais aplicativos podem estar na App Store. Isso não é um bom presságio para os Progressive Web Apps. A Apple não permite que PWAs estejam na App Store . A Apple explica essa restrição citando a experiência do usuário. Nas próprias palavras da Apple, de acordo com as políticas da loja de aplicativos:

“Seu aplicativo deve incluir recursos, conteúdo e interface do usuário que o elevem além de um site reformulado. Se seu aplicativo não for particularmente útil, exclusivo ou "semelhante a um aplicativo", ele não pertence à App Store. ” 

Por enquanto, não é possível enviar PWA para a App Store. Se você deseja alcançar um público iOS, deve considerar pesar os prós e os contras do PWA em comparação com o desenvolvimento de aplicativos nativos. Os aplicativos nativos fornecem a melhor experiência de usuário possível em dispositivos iOS . No entanto, se você tiver um PWA, ainda terá a opção de alcançar usuários iOS. 

A Apple ainda permite que o iOS Safari abra e salve PWAs na tela inicial. Seu PWA estará acessível a partir da tela inicial como todos os outros aplicativos, mas existem limitações quanto ao que ele pode ou não fazer . Aqui estão algumas das principais limitações que os PWAs enfrentam em dispositivos Apple:

  • Limite de cache de 50 MB
  • Sem acesso ao Face ID
  • Sem acesso ao Touch ID
  • Sem acesso Bluetooth
  • Sem acesso ao Siri
  • Você não pode enviar notificações push
  • Não consigo acessar informações privadas, como contatos
  • Sem integração com aplicativos sociais como o Facebook

Embora os PWAs tenham acesso limitado aos recursos nativos do iPhone e de outros dispositivos Apple, eles ainda podem acessar os seguintes recursos:

  • Geolocalização
  • Discurso 
  • Câmera
  • Saída de áudio
  • Apple Pay

A Apple limita as capacidades dos PWAs até mesmo no iOS Safari. A Apple prioriza claramente os aplicativos nativos para promover uma rica experiência do usuário em seus telefones e outros dispositivos. Se alcançar o público do iOS é crucial para seu sucesso, considere seriamente o desenvolvimento de um aplicativo nativo ou a próxima opção a seguir.


Webview

WebView é uma “moldura” nativa para seu aplicativo web, onde com ela se torna possível publicar aplicativos na App Store (iOS), normalmente os apps dessas plataformas que disponibilizam o WebView são NO-CODE, algumas plataformas cobram para criar apps no iOS, todavia através de muita pesquisa, foi encontrado uma que é gratis, a AppGyver.


AppGyver

Para colocar nossa aplicação web dentro da "moldura" do WebView, precisamos abrir sua pagina web, e fazer isso lá, será necessário fazer algumas configurações para o WebView ficar na tela toda.

Todas as configurações estarão disponíveis nos links em referencias.

appGyverTela.png

Após fazer a moldura precisasse do documento Keystore para gerar o APK no Android e do certificado p.12 para gerar o APK no iOS.

Como cada sistema operacional usa um arquivo diferente vamos mostrar a forma de gerar cada um deles:


keystore - Arquivo para gerar o APK no Android

Todo app android desse para se gerar o instalador, para criar o keystore da aplicação é necessário ter o Java instalado na maquina e realizar os comandos a seguir:

gerandoKeystore1.png

gerandoKeystore2.png

Com a keyStory pode se gerar o apk, agora acesse seu app na pagina do appGyver pois lá será feito o BUILD, lá também possível colocar os icones do aplicativo Androides e as imagem nos tamanhos dos formatos dos celulares para o Launch screens.

padrao-icones.png



Agora para se gerar o APK do aplicativo iOS é necessário o certificado (arquivo).p12 

Geração da chave de assinatura do aplicativo

Criação do arquivo .p12 para iOS - precisará de um arquivo .p12 para publicar seu aplicativo na Apple App Store(iOS), mas o processo pode ser um pouco confuso, o arquivo .p12 contém um certificado que é usado para provar que o aplicativo vem de você.

Para se criar esse arquivo é necessário alguns requisitos:

  • Acesso a um computador Mac NOTA: Este é um requisito da Apple.
  • Uma conta de desenvolvedor da Apple ( https://developer.apple.com ) - 99 Dólares por ano.

Ssite-apple.jpeg


     

    • Você precisará do seu endereço de e-mail e “nome comum” para este processo (por exemplo, “joao_silva@empresa.com”, “Joao Silva”).
    • Se você não tiver certeza de seu nome real, faça login em sua conta de desenvolvedor da Apple e use o nome que aparece no canto superior direito. 
    •  

Após ter cumprindo esses requisitos, vamos ao processo de criar o arquivo p12

Criar um arquivo p12 pode ser um pouco confuso na primeira vez, já que você precisa usar peças de software muitas vezes despercebidas em seu computador, bem como a interface da web do Apple Developer (que tem melhorado nos últimos anos).

Dividimos o processo em três etapas abaixo, o que deve ajudar no processo:

ETAPA 1: Crie um arquivo “.certSigningRequest” (CSR)

  • Abra o Acesso às Chaves no seu Mac (encontrado em Aplicativos / Utilitários)

  • Na barra de ferramentas, abra Acesso às Chaves> Assistente de Certificado> Solicitar um Certificado de uma Autoridade de Certificação

image-one.png


  • Insira o endereço de e-mail e o nome comum que você usou para se registrar no Programa de Desenvolvedor iOS NOTA: O nome comum deve ser o nome do desenvolvedor conforme aparece em sua conta de desenvolvedor Apple
  • Deixe o e-mail da CA em branco e certifique-se de que “Salvo no disco” esteja selecionado
  • Clique em Continuar
  • Escolha um nome de arquivo e destino em seu disco rígido (por exemplo, “CertificateSigningRequest.certSigningRequest”)
  • Clique em Salvar
  • Isso criará e salvará seu arquivo certSigningRequest (CSR) em seu disco rígido. Uma chave pública e privada também será criada no Acesso às Chaves com o Nome Comum que você inseriu anteriormente (por exemplo, Jo Smith)

image-two.png


ETAPA 2: Crie o arquivo “.cer” em sua conta de desenvolvedor iOS

image-three.png

Clique no botão Adicionar (+)

image-four.png

Escolha “Distribuição iOS (App Store e Ad Hoc) e pressione“ Continuar ”

image-five.png

Selecione o arquivo CSR que você criou anteriormente e pressione “Continuar”.

image-six.png

Baixe o download

image-seven.png

ETAPA 3: instale o .cer e gere o .p12

  • Encontre o arquivo .cer que você acabou de baixar e clique duas vezes. Se o certificado não tiver sido instalado automaticamente, você verá o seguinte (caso contrário, pule as próximas duas etapas):

image-eight.png

  • Certifique-se de que o menu suspenso esteja definido como “login”
  • Clique em Adicionar
  • Abra o KeyChain Access novamente
  • Encontre os dois perfis que você criou na Etapa 1

image-nine.png

  • Agora você deve ser capaz de expandir o perfil de "chave privada", que deve mostrar o certificado que você acabou de adicionar
  • Selecione apenas esses dois itens ( não a chave pública ), segurando SHIFT e clicando em ambos os itens, a seguir, clique com o botão direito e clique em “Exportar 2 itens…” do pop-up.

image-ten.png

Na janela seguinte, certifique-se de que o formato do arquivo é “.p12” e escolha um nome de arquivo e destino em seu disco rígido.

image.png

  • Clique em Salvar
  • Finalmente, você será solicitado a definir uma senha - você pode deixar ambos em branco se desejar.



Para publicar seu aplicativo na Apple App Store, você precisa saber como fazer um arquivo mobileprovision. Depois de criar um arquivo p12 , siga este guia para criar um arquivo mobileprovision.

Requisitos

O processo

1.png

Clique em “Perfis de provisionamento” na coluna da esquerda

2.png

Em “Perfis de provisionamento” (painel inferior esquerdo), clique em “Distribuição”

3.png

  • Clique no botão “Adicionar” (+) no canto superior direito do painel principal
  • Selecione “App Store”

4.png

  • Clique em Continuar
  • Selecione o ID do aplicativo relevante no menu suspenso

5.png

  • Clique em Continuar
  • Selecione o certificado para assinar (você pode ter apenas uma opção)

6.png

  • Clique em Continuar
  • Dê ao seu perfil um nome relevante (por exemplo, “Nome do aplicativo, ano”)

7.png

Clique em Download para salvar seu arquivo de provisão

8.png

  • Clique em Concluído quando o download for concluído

Agora você tem um arquivo mobileprovision, permitindo enviar seu aplicativo para a iOS App Store.


Com os arquivos salvo na sua maquina vc poderá fazer o BUID da aplicação e gerar o Apk. 

O Build para gerar o apk será feito na plataforma appGyver - https://platform.appgyver.com/

vale ressaltar que o app já tem q está com o webview e com o certificado gerado, depois basta ir pra tela de Launch:

0.png

depois em configurações no iOS

1.png

E inserir a senha e o certificado p.12 (iOS Distribution certificate)

2.png

Logo após, você precisará inserir  também o arquivo mobileprovision, depois basta ir salvando e dando next, as outras configurações são mais simples, e podem serem vista no vídeo disponível no link a segui: 

https://youtu.be/kRc4ZoeMhTo

Com os arquivos p.12 e arquivo mobileprovision pode se gerar o apk no IOS, lá também é possível colocar os icones do aplicativo iOS e as imagem nos tamanhos dos formatos dos celulares para o Launch screens.

IOS-ICONS.png

4. Conclusão

O presente estudo objetivou encontrar a melhor maneira de realizar a publicação de aplicações PWAs em AspNetCore para iPhone na App Store, que é a loja que se tem mais critérios específicos para se publicar aplicativos e se o App for uma PWA vale ressaltar que o IOS está começando a ter compatibilidade com a tecnologia agora.

e a Apple está focando nas APIs que são relevantes para a plataforma IOS, com isso seu suporte para a tecnologia PWAs é parcial, sendo uma das ultimas empresas entre Google, mozilla, Microsoft na adoção da tecnologia, sendo assim a partir da versão 11.3 ela introduziu suporte parcial a PWA, E na 12.2 ela realizou mais updates.

5. Referências 

https://www.koombea.com/blog/can-you-put-a-pwa-on-the-app-store/

https://www.simicart.com/blog/pwa-app-stores/

https://www.appgyver.com/

https://platform.appgyver.com/

https://platform.appgyver.com/builder/applications/255886/pages/1

https://developer.apple.com/

https://calvium.com/how-to-make-a-p12-file/

https://youtu.be/kRc4ZoeMhTo

https://idmsa.apple.com/IDMSWebAuth/signin?appIdKey=891bd3417a7776362562d2197f89480a8547b108fd934911bcbea0110d07f757&path=%2Fdownload%2F&rv=1

https://youtu.be/kRc4ZoeMhTo

https://www.youtube.com/playlist?list=PL47ISohHocDlhE-A7tkWW0MJdq4UIqk9f - Como publicar na app store