Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Esse tutorial irá mostrar o funcionamento das ferramentas do menu superior chamada Dispositivos Móveis ( Destaque da Figura 1)
Figura 1 - Dispositivos Móveis
Pré-requisitos para o tutorial
Antes de começar a seguir os passos do tutorial é preciso ter certeza de que se tem um ambiente minimamente preparado para reproduzir o exemplo. Abaixo estão os requisitos principais.
Requisitos:
- Projeto do tipo mobile criado. Caso haja dúvidas de como criar esse tipo de projeto acesse o link ( Criar projeto );
Gerar chave, configurar e compilar
Compilar
Área responsável por compilar Com o projeto finalizado, agora é o momento de criar a chave de upload, realizar a compilação da aplicação para Android e baixar o arquivo bundle. Para isso, acesse no menu do sistema Dispositivos Móveis > Configurações,
Image Removed
Figura 1.1 - Janela de configuração dos dispositivos móveis
A opção selecionada no campo Tipo de Compilação (destaque 1 da figura 1.1) irá influenciar as configurações exibidas na aba Android (destaque 2 da figura 1.1). Dessa forma, ao configurar o conteúdo da aba Android (2) com a opção "debug" selecionada no campo Tipo de Compilação (1) e depois alterar de "debug" para "release", o conteúdo da aba Android (2) estará vazio, pois ainda não foi feita uma configuração específica para o tipo de compilação "release" (1).
Geração da chave para assinar o APP
O sistema Android exige que as aplicações desenvolvidas possuam assinaturas digitais com certificados para que elas sejam instaladas ou atualizadas.
Criar chave utilizando o Cronapp
Caso ainda não tenha aberto a janela de Configurações, acesse Dispositivos Móveis > Configurações no menu do sistema e clique na aba Android, clique no botão Criar novo... para abrir a janela que irá gerar a chave (Figura 1.1.2).
Image Removed
Figura 1.1.1 - Janela de configuração dos dispositivos móveis
Nota |
---|
Fique atente a opção selecionada no campo Tipo de compilação (Aba aplicativo - destaque 1 da figura 1.1), as alterações feitas aqui estarão vinculadas a opção selecionada lá. |
A janela de criação apresenta três seções (Figura 1.1.2), uma para definir o nome e a senha do arquivo binário; a outra, para definir a chave propriamente dita e, a última, os dados que serão apresentados no certificado.
Image Removed
Figura 1.1.2 - Criar arquivo binário e chave
- Arquivo binário
- Nome da chave: crie um nome para o arquivo binário que servirá de repositório para sua chave. Esse arquivo binário será salvo na pasta certs (Endereço:
src/main/mobileapp/certs
. Acessível apenas com o Modo Avançado habilitado); - Senha: defina uma senha para esse arquivo e confirme no campo seguinte. Ela tem que ser diferente do campo da senha do Alias.
- Nome da chave: crie um nome para o arquivo binário que servirá de repositório para sua chave. Esse arquivo binário será salvo na pasta certs (Endereço:
- Chave: campos de configuração da chave:
- Alias: defina um nome de identificação para a chave;
- Senha: defina uma senha para a chave e confirme no campo seguinte. Ela tem que ser diferente do campo da senha do nome da chave.
- Validade: período em que sua chave estará ativa para assinatura de atualizações que são de 25 anos ou mais.
- Certificado: informações que são incluídas no certificado.
- Primeiro e último nome;
- Unidade organizacional;
- Organização;
- Cidade ou Localidade;
- Estado ou Província;
- Código do País (XX): a sigla do país, como BR, CA ou US.
Atribuída todas as informações nos campos e salve através do botão Criar novo (Figura 1.1.2).
Com essa chave criada, agora será feito a parte de vinculação com seu aplicativo na janela de configuração (Figura 1.1.3). Primeiro, escolha o arquivo binário no botão Escolher existente (1 da Figura 1.1.3) para abrir a janela que mostrará todos os arquivos binários criados nesse projeto e dê um duplo clique no arquivo desejado (2 da Figura 1.1.3) para adicionar o endereço dessa chave no campo origem da chave. Após, insira a senha desse arquivo binário no campo senha da chave, o alias da chave e a sua senha correspondente. Por fim, clique em salvar.
Image Removed
Figura 1.1.3 - Vincular chave ao projeto
Dica |
---|
Acesse a documentação oficial para entender como funciona o processo de assinatura digital do bundle. |
Configurações
Com seu projeto mobile aberto no Cronapp, vamos realizar algumas configurações necessárias para compilação.
No menu do sistema, acesse Dispositivos móveis > Configurações e acesse a aba Aplicativo na janela que abrir (Figura 1.2).
Image Removed
Figura 1.2 - Configurações para a aplicação
- Pacote ID: define o Id da sua aplicação, esse identificador deverá ser único na loja do Google Play. Por isso que normalmente usamos o domínio da empresa de forma invertida e o nome da aplicação no final;
Ex.:br.com.nome_da_empresa.nome_do_aplicativo
- Nome: nome da aplicação;
- Descrição: pequena descrição da aplicação;
- Informações do desenvolvedor: campos que definem e-mail, site e nome do autor da aplicação;
- Versão: define a versão atual da aplicação;
- Tipo de Compilação:
- debug: os dados serão exportados apenas para a versão de testes da aplicação;
- release: os dados serão exportados para uma nova versão que será lançada na loja;
- Ícone*: define o ícone que será usado na aplicação. Recomendamos o uso de uma imagem com resolução 1024 x 1024 px;
- Abertura*: define a imagem que é usada na abertura da aplicação; recomendamos que a imagem tenha uma resolução de 2732 x 2732 px;
- URL do Servidor (produção): indica a URL do servidor da sua aplicação.
Informações | ||
---|---|---|
| ||
No campo 9 da Figura 1.2 estamos usando a URL temporária gerada pelo Cronapp. Lembramos que esse endereço é temporário e poderá ser alterado se você parar e executar novamente o servidor da aplicação no Cronapp. |
Finalizada as configurações, clique no botão Salvar.
Compilação
Após realizar as configurações na etapa anterior, vamos compilar o projeto seguindo os passos abaixo.
Image Removed
para compilar em Android, acesse a documentação sobre .
Image AddedFigura 1.3 - Gerando a aplicação Android no Cronapp
- No menu do sistema, acesse Dispositivos móveis > Compilar > Android.
- Janela Selecione o modo de build:
- Perfil: permite selecionar o tipo de Compilação. A opção selecionada faz referência as configurações dos dispositivos móveis.
- debug: permite exportar apenas para o tipo de pacote APK.
- release: permite exportar para os tipos de pacote APK e Bundle (
*.aab
).
- Tipo de Pacote: define a extensão do arquivo
*.apk
ou*.aab
. - URL do Servidor: exibe o endereço do servidor da aplicação, para alterar, acesse as configurações dos dispositivos móveis (destaque 9 da figura 1.2).
- Perfil: permite selecionar o tipo de Compilação. A opção selecionada faz referência as configurações dos dispositivos móveis.
- Aguarde alguns minutos para gerar o pacote e, em seguida, clique em Baixar para iniciar o download do conteúdo compactado no formato
*.zip
.
Nota | |||||||
---|---|---|---|---|---|---|---|
| |||||||
As aplicações Android desenvolvidas pelo Cronapp, por padrão, são compatíveis para suportar a versão 7.0 (Nougat - API 24) ou superior. É possível, no entanto, alterar e definir uma versão mínima de compatibilidade diferente. Porém, essa redução pode gerar incompatibilidades, visto que alguns plugins e recursos usados no Cronapp não oferecerem suporte para versões abaixo da 7.0 (Nougat - API 24). Ainda assim, caso queira alterar a versão mínima da sua aplicação, será necessário acrescentar ou editar o elemento abaixo no arquivo
Para mais detalhes sobre a alteração de versões, acesse a documentação oficial do Apache Cordova e do Android. |