Variáveis de ambiente
Variáveis de ambiente são definições que o usuário pode utilizar para permitir a geração de código de forma condicional em função destas definições. Elas são utilizadas pelas Diretivas de compilação para remover ou acrescentar trechos de código da aplicação.
O OnStudio permite a criação de variáveis de ambiente em múltiplos locais.
Variáveis de ambiente de escopo global do projeto
Podem ser definidas nas propriedades do Recurso do projeto (aba Code Generation, campo Parâmetros de Ambiente). Estas variáveis são visíveis por todos os blocos do programa de aplicação, incluindo os blocos definidos nas bibliotecas.
Múltiplas variáveis podem ser definidas (ver Edição dos parâmetros).
Importante
Variáveis de ambiente não devem possuir espaços, caracteres especiais e devem sempre iniciar com uma letra, podendo conter letras, números e o caracter “_” .
As variáveis são ‘case insentitive’ ou seja, caracteres maiúsculos e minúsculos são tratados indiferentemente.
Variáveis de ambiente específicas do equipamento selecionado
Podem ser definidas nos Parâmetros de Ambiente (pragmas) de cada dispositivo existente abaixo do item Hardware do recurso: na aba Configuração do dispositivo ou na coluna Parâmetros de Ambiente da tabela de dispositivos das propriedades do recurso.
Estas variáveis são visíveis pelo programa de aplicação apenas quando o equipamento associado estiver selecionado como dispositivo atual (Definir como Atual) no item Hardware.
Múltiplas variáveis podem ser definidas e as observações da nota anterior se aplicam integralmente. O primeiro parâmetro da lista é sempre o nome do dispositivo e não pode ser alterado nem removido (ver Variáveis de ambiente automáticas).
Dica
Observe que, definindo variáveis nos equipamentos é possível customizar o código gerado em função do equipamento que está sendo compilado.
Variáveis de ambiente automáticas
O ambiente, define algumas variáveis de ambiente automaticamente. São elas:
Os nomes dos equipamentos criados abaixo do item Hardware são automaticamente incluídos nas variáveis de ambiente quando o equipamento associado estiver sendo compilado.
Por exemplo, se o recurso possuir um dispositivo chamado DEV_1, a variável de ambiente DEV_1 será automaticamente definida pelo ambiente quando o equipamento DEV_1 for o equipamento selecionado no item Hardware.
Edição dos parâmetros
O campo Parâmetros de Ambiente apresenta os parâmetros ativos separados por vírgula e não é editado diretamente: o botão de edição ao lado dele abre a lista de parâmetros, com as colunas Nome, Ativado e Ações.
Para incluir um parâmetro, digite o nome no campo abaixo da lista e pressione ENTER ou clique em Adicionar Parâmetro (+). O interruptor ao lado do campo define se ele entra ativo.
O nome de um parâmetro pode ser alterado diretamente na lista; nomes repetidos são indicados como Nome duplicado.
O interruptor Ativado liga ou desliga o parâmetro sem removê-lo: um parâmetro desligado permanece na lista, mas não é definido na compilação.
Remover Parâmetro (ícone de lixeira) exclui o parâmetro.
As alterações são gravadas automaticamente, sem botão de salvar.