Dependências do Add-in

A página de dependências do Add-in permite definir condições que devem ser atendidas antes que o Add-in (ou arquivos específicos dentro dele) seja instalado. Se uma condição falhar, o escopo afetado (todo o pacote ou um único arquivo) será ignorado durante a instalação.

Use os botões na parte superior da página para gerenciar as entradas:

1.Adicionar: cria uma nova linha de dependência com valores padrão. Clique em cada célula da linha para configurá-la.

2.Remover: exclui a linha selecionada no momento. Selecione uma linha primeiro clicando nela.

Cada linha de dependência tem cinco colunas. Os campos exibidos em itálico cinza indicam um valor não definido ou opcional.

Escopo: Pacote vs. Recurso

Pacote: se a verificação falhar, todo o Add-in não será instalado. Use essa opção quando o Add-in não puder funcionar de forma alguma sem que o requisito seja atendido.

Recurso: se a verificação falhar, apenas o arquivo específico indicado na coluna Identificador / Nome do arquivo será ignorado. O restante do Add-in é instalado normalmente.

Grupos de dependências para recursos

Para dependências com escopo de Recurso, a coluna Nome tem um papel especial: ela define um grupo de dependências. Várias linhas com o mesmo nome são avaliadas uma após a outra para o mesmo arquivo de recurso.

Isso é útil quando um arquivo pode ser instalado sob condições diferentes — por exemplo, fornecendo uma versão do arquivo para Windows e outra para Linux. Cada grupo é avaliado como um todo; se qualquer linha do grupo for aprovada, o recurso é incluído.

Especificando valores

A forma como você insere o Valor depende do tipo de dependência:

Verificação de versão: usa notação matemática de intervalo (consulte Intervalos de versão).

Arquivo criado / Arquivo modificado: escolha entre três modos de data/hora (consulte Valores de data e hora).

Todos os outros tipos: o campo Valor oferece uma lista suspensa durante a edição com duas opções:

Valor exato: a verificação é aprovada se o valor do sistema corresponder à sua entrada (a comparação não diferencia maiúsculas de minúsculas).

Expressão regular: a verificação é aprovada se o valor do sistema corresponder ao padrão fornecido.

Intervalos de versão

Os valores de versão usam a notação matemática padrão de intervalo:

1.Um colchete [ ou ] significa que a versão limite está incluída.

2.Um parêntese ( ou ) significa que a versão limite está excluída.

3.A ausência de um limite superior ou inferior significa que não há limite nessa direção.

Valores de data e hora

As verificações de data/hora de arquivo não usam notação de intervalo.

Em vez disso, selecione um dos três modos:

Exato: o registro de data/hora do arquivo deve corresponder exatamente à data/hora especificada.

Antes: o registro de data/hora do arquivo deve ser anterior à data/hora especificada.

Depois: o registro de data/hora do arquivo deve ser posterior à data/hora especificada.

Tipos de dependência

Tipo

Descrição

Nenhum

Nenhuma verificação é realizada — a dependência é sempre considerada satisfeita. Útil como espaço reservado.

Verificação de versão

Verifica se a versão de um componente de software selecionado está dentro do intervalo especificado.

1.Identificador: selecione o software a verificar: RoboDK, Add-in Manager, Qt Framework ou Sistema Operacional.

2.Valor: um intervalo de versão usando notação de intervalo (consulte Intervalos de versão).

Arquitetura da CPU

Verifica se a arquitetura do processador do sistema corresponde ao valor esperado.

1.Valor: a string de arquitetura de CPU esperada, por exemplo, x86_64, arm64 ou i386. Aceita correspondência exata ou expressão regular.

Arquitetura de Build

Verifica a string completa da interface binária do aplicativo (ABI) da build em execução. Isso é mais detalhado do que a arquitetura da CPU e inclui informações de compilador, modelo de dados e ordenação de bytes (endianness).

2.Valor: por exemplo, x86_64-little_endian-lp64. Aceita correspondência exata ou expressão regular.

Tipo de Kernel

Verifica o identificador do kernel do sistema operacional subjacente.

3.Valor: por exemplo, winnt (Windows), linux, darwin (macOS). Aceita correspondência exata ou expressão regular.

Verificação de sistema

Verifica o nome do produto do sistema operacional conforme relatado pelo próprio SO.

4.Valor: por exemplo, windows, ubuntu. Aceita correspondência exata ou expressão regular.

Versão do arquivo (somente Windows)

Lê o recurso de versão incorporado em um executável ou biblioteca do Windows (.exe ou .dll) e o compara com o valor ou usando uma expressão.

5.Valor: por exemplo, 1.4.3.3123 aceita correspondência exata ou expressão regular.

Arquivo criado

Verifica o registro de data/hora de criação do arquivo especificado.

6.Identificador / Nome do arquivo: o caminho do arquivo a ser inspecionado.

7.Valor: uma data/hora com o modo: Exato, Antes ou Depois (consulte Valores de data e hora).

Arquivo modificado

Verifica o registro de data/hora da última modificação do arquivo especificado.

8.Identificador / Nome do arquivo: o caminho do arquivo a ser inspecionado.

9.Valor: uma data/hora com o modo: Exato, Antes ou Depois (consulte Valores de data e hora).