Orientações para Desenvolvimento Backend

CONTEÚDO

1. Visão Geral
2. Permissões
3. Publicação
4. Android
5. IOS

01. VISÃO GERAL

Objetivo de orientar na preparação do ambiente e dos passos a seguir para realizar as publicações na Apple Story e PlayStore.

02. PERMISSÕES

Acesso as lojas App Store e Google Play.

Para solicitação dos acessos as lojas mencionadas, faça os seguintes passos abaixo: 

• Realizar a abertura de um chamado através do Service Desk (Acesso a Segurança da informação >> Acesso Loja de APPS >> Novo Acesso TOTVER), link para facilitar abaixo: Solicitar acesso a loja de Apps
• Preencher as informações conforme orientação abaixo:

Após os acessos solicitados retornarem com sucesso, você irá necessitar do certificado para publicação.

Certificado para publicação do aplicativo MeuRH.

Para ter acesso ao certificado você terá que enviar um e-mail para [email protected], solicitando o certificado e permissão para o Apple Development. 

03. Publicação

Nota: você terá que abrir uma issue de publicação para realizar o mesmo.

Para realizar a publicação do aplicativo MeuRH, certifique-se de adicionar um novo versionamento para o aplicativo e todas as alterações feitas terão que estar na branch dev. Com isso, abaixo explicará as regras para versionamento e arquivos que possuem a versão do aplicativo.

Versionamento

As regras para a inserção de uma nova versão funciona da seguinte maneira, considerando no exemplo que a versão atual do aplicativo é 2.6.5 e o mesmo será atualizado:

• Mudança no patch: pequenas mudanças ou de baixo impacto, só mudará o patch, seguindo o nosso exemplo a versão irá para 2.6.6.
• Mudança no release: mudanças significativas ou de alto impacto, mudará a release da versão, seguindo o nosso exemplo a versão irá para 3.0.0.

A nova versão será incluída nos seguintes arquivos:

Package.json:

Modifique o versionCode e o versionName no android/app/build.gradle:

Após isto, siga os seguintes procedimentos:

• Exclua as pastas node_modules, www e .angular. Exclua o arquivo package-lock.json.
• Rode o comando npm i

Rode o comando ionic cap sync para sincronizar as alterações

04. ANDROID

Compilar o aplicativo

Após todas as modificações feitas e a alteração na versão, orientadas no tópico acima execute o sincronismo e o build (ionic cap sync e ionic cap build android). Finalizando, entre na pasta Android no seu terminal e execute os comandos abaixo conforme a necessidade:

• ./gradlew assembleDebug: Responsável por gerar um apk no modo Debug.
• ./gradlew assembleRelease: Responsável por gerar um apk assinado para a loja da PlayStore.
• ./gradlew bundleRelease: Responsável por gerar um arquivo bundle assinado para a loja PlayStore. Este é o método em que usamos para geração do arquivo que será incluído na PlayStore.

Todos os arquivos gerados, ficarão na pasta android/app/build/outputs/apk ou android/app/build/outputs/bundle.

Publicação no teste fechado na Google Play

Após o arquivo bundle gerado, conforme o tópico acima, faça os seguintes passos: 

• Para publicação do aplicativo, irá navegar até na Google Play Store, acessando o aplicativo do MeuRH, você irá para Teste Fechado > Gerenciar faixa.

• Clicará em criar nova versão.

• Selecionar o arquivo para upload.

• Selecione no explorador de arquivos o bundle assinado.

• Após, navegando a tela para baixo terá o campo notas da versão, o mesmo será preenchido informando aos clientes do aplicativo o que foi feito. Neste caso será um breve resumo de forma genérica, colando nas 3 línguas disponíveis, português, espanhol e inglês e cada uma delas dentro das tags que possui no campo.

• Feito isso, você clicará em próximo.

• Na tela seguinte, certifique-se de que a porcentagem de usuários que receberá será 100% e clique para prosseguir.

• Agora a nova versão entrará em análise pela loja.

Após finalizar a análise, você terá que ir em visão geral da publicação, no menu esquerdo e lançará o mesmo para os usuários de testado fechado clicando nos botões disponibilizados e orientados pela loja.

Como baixar uma versão do aplicativo no teste fechado ou interno.

O teste fechado ou interno, normalmente demoram para atualizar a versão na loja, com isso, há uma maneira alternativa para seu testador receber essa versão. É possível ser feito isso com os passos abaixo:

• Seu usuário na Playstore não pode estar como Testador beta e deve ter o e-mail cadastrado nos testadores da determinada versão. Com isso, acesse Mais detalhes da versão:

• Acesse seu arquivo bundle gerado:

• Vá na aba de downloads e clique em Copiar link compartilhado:

Certifique-se que o e-mail está cadastrado no “Gerenciar o acesso” e após envie para seu testador o link copiado. Ele abrirá o mesmo no dispositivo, que o redirecionará para o aplicativo na loja com a versão solicitada.

05. IOS

Publicação no TestFlight  na Apple Store.

Nota: certifique-se de ter acesso a um notebook Macbook, pois para lançar a nova versão no TestFlight é feita uma integração da IDE Xcode com a loja, e só é permitido realizar este procedimento com um Macbook.

Com o Macbook acesse o VSCODE e troque a branch para a dev.

Certifique-se que foi baixado todas as alterações feitas recentemente no projeto através do git fetch e git pull. Caso solicite as credencias, você terá que acessar o projeto no Azure, acionar o clone do repositório para ele disponibilizar o botão generate credentials. Para que com isso copiei a informação gerada e coloque a mesma no VSCODE.

Exclua as pastas node_modules, platforms, plugins, www e o arquivo package-lock.json.

Finalizado a exclusão, execute o comando npm i para instalação das dependências e o comando ionic cordova prepare ios para criar o ambiente IOS do ionic.

Continuando seu acesso ao Macbook, acessará o XCode através do arquivo gerado conforme a imagem abaixo.

Ao abrir a IDE você colará o aplicativo para MeuRH e modificará a plataforma para uma versão de sua preferência que seja confiável para teste e afins.

Rode o build no projeto.

Caso ele aconteça um erro de compilação, remova as linhas 107 a 110 conforme abaixo e executa o mesmo novamente.

Após o build concluído, você abrirá o meu RH no menu esquerdo, acessando a aba Signing & Capabilities.

Nos checkbox's disponibilizados nesta aba, desmarque e marque novamente o mesmo, caso apareça para habilitar, habilite. Em todos os combobox's preencha com o MeuRH.

Execute o projeto e teste o necessário para sua demanda.

Concluindo os testes, modifique a plataforma para conforme feito anteriormente, para Any IOS device.

Agora faremos o procedimento de análise do aplicativo para sua publicação.

Caso solicite uma senha, será necessário solicitar a Vitor Rafael Leite o mesmo para prosseguir.

Finalizado a análise da IDE, você entrará em irá no tópico de conexão com a loja.

Abrindo um modal, você irá em Validate APP, para validação inicial do aplicativo feita pela integração com a loja, seguindo os passos das imagens a seguir.

Finalizado o mesmo, você fará a distribuição do aplicativo na loja, acionando o botão Distribute App, e seguindo com os botões de prosseguir até finalizar. Concluindo o procedimento, você terá a nova versão do aplicativo na Apple Store do TestFlight, será feito uma avalição rápida (em média 6-12hrs) pela Apple e a publicação em seguida de forma automática.