|
September 14, 2016
|

Como executar e empacotar as aplicações facilmente usando o tc.Help

Um dos grandes desafios para quem começa a usar uma plataforma é saber como executar e empacotar apps. No TotalCross, utiliza-se a classe totalcross.Launcher para executar o aplicativo no Java, e o tc.Deploy para empacotá-lo. Porém, quais argumentos devem ser usados e em que ordem?

Foi pensando nisso que criamos o utilitário tc.Help. Ele deve ser visto como algo temporário, um ajudante inicial até que você se familiarize com os comandos. Isso porque, ao usar o tc.Help para executar o aplicativo, você perde a opção de depuração, pois o aplicativo é executado fora da IDE (Eclipse, Netbeans) utilizada para desenvolvimento.

Para invocar o tc.Help, basta dar um clique-duplo no arquivo TotalCross3\dist\tc.jar. Outra opção é executar ele usando o java: java -jar TotalCross3\dist\tc.jar. Aparecerá então a seguinte tela do aplicativo:

help_01

O aplicativo é bilíngue, funciona em inglês ou português. Pode-se trocar a linguagem clicando a qualquer momento no botão de rádio na parte superior da tela. Em cima também vemos 3 botões: um que abre o javadoc, outro que abre o blog, e um terceiro para o TotalCross Companion.pdf, que está na pasta TotalCross3\doc. O aplicativo tem ajuda para todos os campos, basta colocar o cursor em cima do campo para exibir na área azul do rodapé. Ele também grava os dados selecionados, mostrando a aplicação do jeito exato em que estava quando saiu pela última vez.

Em seguida, vem 3 campos que devem ser preenchidos:

  1. Nome da classe, que deve incluir o pacote. Exemplo: tc.samples.api.TotalCrossAPI;
  2. Pasta dos .class, que especifica onde estão os arquivos binários da classe. É importante que seja a pasta base, onde está o diretório da primeira parte do pacote – no exemplo acima, do diretório tc. Exemplo: G:/temp/eclipse/TotalCross/ (abaixo dessa, vê-se a pasta tc);
  3. Chave, que no caso, é a chave que você recebeu por email para poder utilizar o SDK.

Esses campos são comuns para executar e empacotar a aplicação. Logo abaixo, aparecem as 3 abas, que veremos em detalhes.

Aba Console

Essa aba está em último lugar, e mostra a saída dos comandos de Executar e Empacotar. Você pode copiar e colar o código exibido nessa aba.

Aba Executar

Essa aba serve para executar a aplicação no Java. Como dito anteriormente, deve ser usada apenas para você se familiarizar com as opções, visto que ela impede que voce depure o aplicativo em sua IDE favorita.
Você pode definir configurações da janela, como a posição x e y de abertura, e também o tamanho. O TotalCross possui 4 tamanhos pré-configurados, que são Win32, WinCE, Android e iOS. Você pode usar um desses clicando no botão correspondente ou entao selecione Customizado e preencha com os valores que desejar.
Existe a opção de passar um comando para a aplicação em tempo de empacotamento, que pode ser recuperado usando o método MainWindow.getCommandLine(). E, por fim, você pode exibir a posição do cursor do mouse na aplicação. Isso é útil para saber a posição de cada controle na janela.
Você pode ajustar esses comandos ou simplesmente deixa-los no valor pré-selecionado e clicar no botão Executar a aplicação. Nesse momento, a aba Console é exibida; não deixe de ler as instruções nela escritas. Lembre-se de fechar a aplicação antes de executá-la novamente.
Note que o comando totalcross.Launcher permite outras opções, que estão descritas no Companion.

Aba Empacotar

Essa aba permite empacotar a aplicação, criando arquivos que podem ser instalados nos equipamentos. Para isso, algumas ações são necessárias.

help_02

Primeiro, você escolhe a plataforma. Pode-se escolher todas as plataformas, porém, o ideal é escolher apenas as que você for usar, pois isso acelera o empacotamento.
Se escolher iOS, deverá informar também a pasta do mobile provision (vide capítulo 6 do Companion). Sem isso definido, o deploy para iOS é ignorado.
Para instalar no equipamento, você pode selecionar apenas uma plataforma, e marcar a opção correspondente.
Por fim, para as plataformas Windows Mobile e Android, existe a opção de empacotar a máquina virtual junto com a aplicação. Isso é útil porque permite que você crie apenas um pacote de instalação (caso contrário, terá que instalar a vm, disponível na pasta TotalCross3/dist/vm, e depois a aplicação).
Quando tiver terminado o preenchimento dos campos, clique em Empacotar a aplicação, e a aba Console será exibida. Se o empacotamento ocorreu com sucesso, você pode clicar no botão Pasta da instalação, para ter acesso rápido à pasta os estão os arquivos gerados.

Com isso chegamos ao fim desse artigo. Espero que o tc.Help ajude você a iniciar de forma mais fácil o uso da plataforma TotalCross.

Comments

More articles

X dicas para você criar uma estratégia de mobile marketing infalível

November 20, 2018

Afinal, é possível criar app sem saber programação?

November 16, 2018

Como transformar um website em aplicativo?

November 14, 2018

Aplicativos: O que conhecer antes de criar um

November 13, 2018