O menu do sistema Dispositivos Móveis possui diversas ferramentas para execução, teste e configurações das aplicações móveis desenvolvidas no Cronapp. (Destaque da Figura 1)

Figura 1 - Dispositivos Móveis

• Compilar: ferramentas de compilação das aplicações iOS ou Android.
• Executar: permite testar a aplicação móvel através do simulador ou Cronapp Browser.
• Gerar Projeto Nativo: permite baixar o fonte compactado da aplicação móvel para abrir Xcode (ambiente de desenvolvimento Apple).
• LimparWorkspace: Apaga modificações feitas no plugin do Cordova.
• Configurações: Área para configurações do projeto mobile.

Compilar

Área responsável por compilar o projeto mobile (Figura 2) nos formatos APK ou Budlle no Android ou Ipa para o iOS

Para mais detalhes sobre a compilação, acesse os tutoriais abaixo:

• Android: Publicar seu projeto para Android.
• iOS:
  • Compilação Remota - IOS (utilizando ferramentas do Cronapp);
  • Publicar aplicação na Apple Store (utilizando ferramentas do Cronapp);
  • Testar e publicar seu projeto para iOS (iPhone / iPad) (utilizando o Xcode).

Build Android

O formato Bundle só está disponível no tipo de compilação (perfil) Release, já o formato APK está disponível em ambos perfis.

Figura 2 - 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 às configurações dos dispositivos móveis;
     • debug: permite exportar apenas para o tipo de pacote APK e compila com base nas configurações feitas para o perfil debug (janela de configuração dos dispositivos móveis);
     • release: permite exportar para os tipos de pacote APK e Bundle (*.aab) e compila com base nas configurações feitas para o perfil release (janela de configuração dos dispositivos móveis);
   • Tipo de Pacote: define a extensão do arquivo;
   • URL do Servidor: exibe o endereço do servidor da aplicação, para alterar, acesse as configurações dos dispositivos móveis.
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.

Build iOS

O compila a aplicação móvel no formato *.ipa.

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

1. No menu do sistema, acesse Dispositivos móveis > Compilar > IOS (figura 2.1);
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: gera o arquivo *.ipa compactado com as configurações do tipo de compilação debug.
     • release: gera o arquivo *.ipa compactado com as configurações do tipo de compilação release.
   • URL do Servidor: exibe o endereço do servidor da aplicação, clique em Baixar para iniciar o download do conteúdo compactado no formato *.zip.
3. Janela Download Aplicação Móvel:
   
   • Botão Publicar: direcionado para a funcionalidade Publicar aplicação na Apple Store já com o arquivo compilado;
   • Botão Baixar: iniciar o download de um arquivo compactado que possui o arquivo compilado *.ipa.

Executar

A opção Executar possui dois recursos para testar sua aplicação antes mesmo de compilar. 

Figura 3 - Simulador

• Simulador: Utilize o simulador para testar sua aplicação mobile com uma resolução de tela de tamanho padrão para Smartphones ou Tablets;
• Cronapp Browser: Exibe uma janela com o código QR para abrir a aplicação diretamente do seu Smartphone através do aplicativo Cronapp Browser.

Simulador

Abre uma aba entro do Cronapp onde é possível emular sua aplicação mobile com uma resolução de tela de tamanho padrão para Smartphones ou Tablets.

Figura 4.1 - Aplicação sendo executada no simulador 

1. Botão que atualiza o projeto que está sendo executado dentro do simulador;
2. Faz a função de rotacionar, para verificar o layout do projeto deitado ou em pé;
3. Altera a visualização para celular;
4. Altera a visualização para tablet;
5. Diminui o zoom;
6. Mostra a porcentagem do zoom;
7. Aumenta o zoom.

Cronapp Browser

Para usar essa opção de teste é necessário que você tenha o aplicativo Cronapp Browser instalado em seu Smartphone e assim que for acionado, seu projeto será baixado em seu smartphone e rodará em uma camada acima do aplicativo. O app Cronapp Browser é a melhor opção para testar, não nativamente, seu projeto mobile, pois consegue simular e usar praticamente todos os recursos do Smartphone exigidos pela aplicação.

Para instalar o aplicativo, acesse a loja virtual iOS ou Android através dos links abaixo, faça o download e instale a aplicação Cronapp Browser em seu dispositivo.

Links para o aplicativo de teste Cronapp Browser

Como usar

No Cronapp, gere o QRCode da sua aplicação através da opção Executar > Cronapp Browser no menu Dispositivos Móveis (figura <TODO: Ajustar numeração>).

Figura <TODO: Ajustar numeração>

Abra o aplicativo Cronapp Browser instalado em seu Smartphone e clique no botão Acionar Leitura para ativar o recurso da câmera que faz a leitura do código QR gerado pelo Cronapp.

Figura 4 - Tela inicial do Cronapp Browser

Aponte a câmera do smartphone para o seu monitor e efetue a leitura do QRCode gerado pela IDE. 

Figura 4.1 - Realizando a leitura do QRCode gerado pelo Cronapp através do Cronapp Browser

Após a leitura, o projeto é baixado temporariamente no smartphone e executado por cima da aplicação Cronapp Browser.

Figura 4.2 - Aplicação Get Started executando com o Cronapp Browser

Gerar Projeto Nativo

Precisará realizar os passos da documentação Compilação Remota - iOS para baixar o seu projeto para Xcode, onde poderá manipular seu projeto no ambiente de desenvolvimento integrado e software livre da Apple Inc.

Figura 5 - Xcode

Limpar Workspace

Apaga todos os arquivos usados no processo de compilação das aplicações mobile (Figura 6).

Figura 6 - Limpando Workspace

Configurações

A janela de configurações mobile possui diversas propriedades para incluir informações, exportar ou compilar o projeto mobile.

Resumo

A janela de Configurações dos dispositivos móveis conta com 3 abas, segue abaixo o resumo seguido da explicação de cada uma.

Figura 7 - Configurações

• Aba Aplicativo: possui diversas propriedades válidas para ambas as plataformas (Android e iOS).
• Aba Android: permite gerar uma chave para a assinatura digital do aplicativo, desnecessário ao publicar no Google Play.
• Aba IOS: possui os campos usados na compilação remota e na solicitação de recursos para o usuário.

Aplicativo

No menu do sistema, acesse Dispositivos móveis > Configurações e acesse a aba Aplicativo na janela que abrir (Figura 7.1).

O sistema Android exige que as aplicações desenvolvidas possuam assinaturas digitais com certificados para que elas sejam instaladas ou atualizadas. Para configurar acesse o tópico Geração da chave para assinar o APP da documentação Publicar seu projeto para Android.

Figura 7.1 - 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: 
   

   Aviso

   O conteúdo nas abas Android e iOS são influenciados pela opção selecionada em Tipo de compilação (destaque 6 da figura 7.1), dessa forma é possível criar uma configuração específica para a opção debug e outra para a opção release. No momento em que for compilar a aplicação, é possível selecionar o perfil (tipo de compilação) e utilizar a configuração desejada. Os campos da área iOS Mensagens de Privacidade (aba IOS) não são influenciados pelo tipo de compilação, podendo ser configurado independente do perfil selecionado.

   • 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, é necessário possuir o endereço para a compilação.
   

   Informações
   title Observação
   No campo 9 da Figura 7.1 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.

Aba Android

Para configurarmos a aba Android, é necessário entender o processo correto de configuração, acesse a documentação Publicar seu projeto para Android para aprender cada passo da configuração.

Figura 7.2 - Aba Android

1. Origem da chave: Pode ser inserido o endereço da chave criado no endereço: src/main/mobileapp/certs(Acessível apenas com o Modo Avançado habilitado) ou apenas clicar em Escolher existente e selecionar;
   • Criar novo: Abre a janela da figura 7.3 onde irá preencher os campos requeridos para criar uma nova chave;
   • Escolher existente: Irá aparecer uma janela onde irá selecionar a chave desejada;
   • Limpar: Irá limpar o campo Origem da chave;
2. Senha da chave: Campo onde deverá inserir a senha do Arquivo binário;
3. Alias: Nome de identificação da chave;
4. Senha: Insira a senha do Alias;
5. Ícone de Notificação: Imagem do ícone que irá aparecer na notificação.

Figura 7.3 - Janela que abre após clicar no botão Criar novo

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 o Alias 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.

Aba iOS

Na etapa de configuração para IOS vamos precisar fazer os uploads dos arquivos *.cer e *.p12, como indicado abaixo, para entender melhor como configurar e preencher os campos, acesse a documentação Compilação Remota iOS.

Figura 8 - Aba iOS

• Compilação Remota iOS: campos necessários para gerar a compilação remota.
  • Code Sign Identity: esse campo deve ser configurado de acordo com a opção do campo Tipo de compilação da aba Aplicativo;
    • debug: informe "iPhone Developer";
    • release: informe "iPhone Distribution";
  • Provisioning Profile File: selecione o arquivo *.mobileprovision obtido na etapa em que criamos o Provision Profile ( Figura 5.1 da documentação Compilação Remota iOS);
  • Development Team: esse campo será automaticamente preenchido ao fazer o upload do arquivo Provision profile e refere-se ao identificador criado junto com a conta de desenvolvimento;
  • Provisioning Profile: esse campo será automaticamente preenchido ao fazer o upload do arquivo Provision profile e é o identificador do provisioning profile;
  • Certificado de Distribuição: selecione o arquivo *.p12 (Figura 7.1 da documentação Compilação Remota iOS) ;
  • Senha do certificado: senha criada ao gerar o arquivo *.p12 ( Figura 7.1 da documentação Compilação Remota iOS);
  • Servidor de Compilação: máquina virtual Apple do Cronapp. Se você possuir um servidor de compilação Apple próprio, poderá informar o endereço nesse campo;
• iOS Mensagens de Privacidade: caso você tenha selecionado algum recurso durante a criação do identificador do aplicativo (Capabilities Figura 4.1 da documentação Compilação Remota iOS) , será necessário adicionar uma frase informando porquê o aplicativo necessita desse recurso, para assim o usuário autorizar ou não o uso do recurso. Caso o aplicativo utilize um recurso e não possua um texto, será rejeitado durante o processo de validação na Apple Store;