Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

Versão 1 Próxima »

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:

  1. 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

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,


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).


Figura 1.1.1 - Janela de configuração dos dispositivos móveis


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.


Figura 1.1.2 - Criar arquivo binário e chave


  1. 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.
  2. 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.
  3. 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.


Figura 1.1.3 - Vincular chave ao projeto


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).


Figura 1.2 - Configurações para a aplicação


  1. 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
  2. Nome: nome da aplicação;
  3. Descrição: pequena descrição da aplicação;
  4. Informações do desenvolvedor: campos que definem e-mail, site e nome do autor da aplicação;
  5. Versão: define a versão atual da aplicação;
  6. 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;
  7. Ícone*: define o ícone que será usado na aplicação. Recomendamos o uso de uma imagem com resolução 1024 x 1024 px;
  8. Abertura*: define a imagem que é usada na abertura da aplicação; recomendamos que a imagem tenha uma resolução de 2732 x 2732 px;
  9. URL do Servidor (produção): indica a URL do servidor da sua aplicação.


Observação

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.


Figura 1.3 - Gerando a aplicação Android no Cronapp


  1. No menu do sistema, acesse Dispositivos móveis > Compilar > Android.
  2. 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).
  3. Aguarde alguns minutos para gerar o pacote e, em seguida, clique em Baixar para iniciar o download do conteúdo compactado no formato *.zip.


Observação

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 config.xml (Endereço: src/main/mobileapp/config.xml).

<platform name="android">
	<preference name="android-minSdkVersion" value="24" />
 	...
</platform>

Para mais detalhes sobre a alteração de versões, acesse a documentação oficial do Apache Cordova e do Android.








  • Sem rótulos