Java Script Lite para Visual Studio Code
A extensão Java Script Lite facilita o desenvolvimento e a criação de aplicativos e skins para o POS Legacy rapidamente a partir do Visual Studio Code. Também fornece o PhVM, uma máquina virtual para executar e testar as aplicações.
Pré-Requisitos
- Windows 10 64 Bits
- Windows PowerShell
- Visual Studio Code (V1.64) ou superior
Instalação
Para instalar a extensão, abra a aba Extensões, clique em ..., selecione Instalar do VISX e selecione o arquivo .visx fornecido pela Phoebus.
Configuração do Plugin
Para acessar as configurações do plugin, acesse o menu Arquivo->Preferência->Configurações.
Na janela de Configurações, selecione Extensões->Java Script Lite e será exibida a tela das configurações do Java Script Lite.
A caixa Options Preference
mostra as opções utilizadas na compilação dos arquivos durante o desenvolvimento e build da aplicação. Não altere essas opções sob risco dos arquivos de script não serem compilados.
Opção |
Descrição |
-n |
Não checa dependência entre PhScripts |
-L |
Habilita o uso de logs onde o valor tanto pode ser um numérico quanto um texto definido: all, error, warning or debug |
-F |
Força que ocorra a compilação |
As opções show errors
, show warnings
, show info messages
e show others messages
... referem-se às informações respectivas: erros, avisos, informações e outras mensagens enviadas pelo compilador.
A opção Stop after Errors
permite ao usuário bloquear, ou não, a execução da PhVM, caso contenha erros durante a compilação dos arquivos.
A opção User Projects
permite ao usuário alterar o diretório padrão de todos os seus projetos.
A opção Colorize
adiciona cores aos arquivos .jcss
Criando o primeiro POS
Para criar o seu primeiro terminal, clique na aba POS, em User Terminals List clique no botão + ou então use o atalho ctrl+alt+8
Nas opções, escolha o nome, tipo de modelo, emulador de cartão , tipo de comprovante e porcentagem da bateria. Em seguida clique em Salvar
Opção |
Descrição |
Modelos |
Os modelos atualmente suportados são: C680 , D195 , D200 , M5000 , S920 , Vx680 , Vx685 , Vx690 |
Emulador de cartão |
Escolha entre cartão magnético ou cartão de chip. |
Comprovante |
Escolha entre comprovante de impressão gráfico ou textual |
Bateria |
Selecione o Nível de bateria do Terminal |
Selecionar Terminal POS
Para selecionar um terminal POS, clique em Selecionar Terminal, na barra inferior esqueda e selecione o terminal desejado.
Primeira aplicação.
Para criar sua primeira aplicação, clique na aba POS e em Projeto clique no botão Criar um novo projeto.
Nesta etapa, defina um nome para sua aplicação em Nome
e, se preferir, desmarque a opção
Localização Padrão
e selecione um caminho para salvar sua aplicação no campo Localização
.
Na seção Tipo de Projeto
, pode ser escolhido entre Samples e Templates para criação da estrutura incial do projeto. Os Samples
são códigos com exemplos de utilização do PhScript SDK, e os Templates
são modelos de applets pré-definidos para auxiliar no desenvolvimento da aplicação.
Para finalizar, selecione um sample
ou um template
e clique em Criar. Ao final desta etapa, o projeto será criado e será dada 3 opções ao usuário.
Opção |
Descrição |
Abrir no Espaço de Trabalho Atual |
Abre a aplicação no espaço de trabalho atual, permitindo adicionar um ou mais projetos no mesmo ambiente. |
Abrir na janela atual |
Recarrega a janela atual removendo todos os projetos do espaço de trabalho e abre a aplicação criada. |
Abrir em uma nova janela |
Abre uma nova instância do Visual Studio Code com a aplicação criada. |
Executando as Aplicações
Para executar a aplicação, selecione o terminal requerido na barra inferior esqueda e em seguida clique no botão "Play". A aplicação será construida, e caso não ocorra erros a PhVM será executada com a aplicação.
Gerando pacote de distribuição
Para gerar o pacote de distribuição, clique no icone "box" na barra inferior esquerda e o pacote será gerado para todos os terminais suportados pelo plugin.
Atalhos
Atalhos |
Descrição |
ctrl+alt+0 |
Compila os Projetos WMLS |
ctrl+alt+1 |
Cria um novo componente JCSS ou WMLS |
ctrl+alt+2 |
Cria um novo projeto Java Script Lite |
ctrl+alt+3 |
Executa a PHVM |
ctrl+alt+4 |
Executa a PHVM em modo de debug |
ctrl+alt+5 |
Finaliza a execução da PHVM |
ctrl+alt+6 |
Abre o diretório da PHVM |
ctrl+alt+7 |
Gera os pacotes de distribuição |
ctrl+alt+8 |
Cria um novo terminal POS |
ctrl+alt+u |
Exibe as bibliotecas para importação |