Criador de Add-ins

O Criador de Add-ins permite que você crie e modifique facilmente os pacotes de Add-in do RoboDK. A ferramenta Criador de Add-ins faz parte do Gerenciador de Add-ins

O Criador de Add-ins pode ser aberto selecionando Ferramentas-Gerenciador de Add-ins e clicando no botão Criar Add-in na parte inferior do Gerenciador de Add-ins.

Ao abrir o assistente do Criador de Add-ins, você pode escolher entre as seguintes opções:

●Criar um novo Add-in do zero: isso resultará em um novo pacote do RoboDK (arquivo RDKP).

●Criar novo add-in a partir de pasta ou aplicativo legado: nesse caso, você pode especificar o caminho para a pasta onde os arquivos do seu add-in estão localizados. A opção Não criar um pacote permite que você edite um add-in diretamente na pasta onde ele reside sem criar um pacote do RoboDK (arquivo RDKP).

●Modificar Add-in existente: abre um pacote existente do RoboDK para modificar e criar uma nova versão.

Criando ou editando Add-ins

Você pode criar facilmente um novo Add-in inserindo informações básicas, como tipo, nome, informações do autor, etc.

Na janela Criador de Add-ins, você encontrará os campos obrigatórios em negrito. Há cinco deles no total:

1.Tipo: O tipo de seu Add-in, como App, Driver de Robô, Linguagem, etc.

2.Nome: O nome do seu Add-in.

3.Identificador exclusivo: um identificador exclusivo que pertence a esse Add-In específico. A caixa de seleção próxima a esse campo permite que você ative o modo de edição e defina um identificador arbitrário, que pode conter letras latinas, números e caracteres adicionais, como sinal de menos, ponto e sublinhado.

4.Versão: A versão deve ser escrita no formato de controle de versão semântico (maior.menor.patch).

5.Revisão: O número de alterações do Add-in, que assume valores numéricos de 1 a mais.

Os campos restantes são opcionais, mas permitem que você forneça uma descrição mais precisa do Add-in:

6.Autor: O nome e o sobrenome do autor, ou o nome da sua empresa ou equipe (se houver vários autores).

7.Empresa: O nome da empresa.

8.Idioma: O idioma usado no Add-in. Todos os idiomas do padrão IETF BCP 47 estão listados.

9.Status do conteúdo: Status do add-in, por exemplo, Final, Teste interno, Beta, etc.

10.Descrição: Breve descrição do Add-in.

11.Modificado por: Esse campo pode ser usado quando alguém modifica o Add-in de outro autor e deseja ser mencionado como o autor das modificações.

12.Criado: Data de criação da primeira versão do Add-in (a ser preenchida automaticamente).

13.Modificado: Data de modificação do Add-in (a ser preenchida automaticamente).

14.E-mail: Endereço de e-mail para fins de vendas, suporte ou feedback.

15.Site: O site da sua empresa (desenvolvedora do Add-in).

16.Link de documentação: Link para a documentação do seu Add-in.

17.Link do repositório: Para Add-ins de código aberto, um link para o repositório do GitHub ou outro repositório público onde o add-in está localizado.

18.Palavras-chave: Uma lista de palavras-chave (tags) para simplificar a pesquisa do Add-in no Add-in Marketplace.

Adicionando Recursos ao seu Add-in

O Add-in deve conter um ou mais Recursos. Os Recursos podem ser scripts e ícones que definirão as ações do seu Add-in.

A página Recursos do Add-in é dividida em três áreas funcionais:

1.Área de seleção de ícones de pacotes.

2.Área da árvore de arquivos.

3.Área de visualização do conteúdo do arquivo.

A finalidade dos botões e da caixa de seleção nesta página:

●O botão Caminho de destino: Caminho de destino abre a janela de propriedades do arquivo de ícone atual e permite definir a propriedade de destino (consulte a seção correspondente sobre os componentes internos do pacote).

●O botão Mudar Ícone... permite que você substitua o ícone do pacote atual por um novo.

●O botão Remover Ícone exclui o ícone atual do pacote e define o ícone padrão que corresponde ao tipo de pacote que está sendo criado.

●O botão Nova pasta cria uma nova subpasta na ramificação selecionada da árvore de arquivos.

●O botão Adicionar Recursos... adiciona novos arquivos à ramificação selecionada da árvore de arquivos.

●O botão Remover apaga os itens selecionados da árvore de arquivos, exceto aqueles que estão bloqueados.

●A caixa de seleção Criar Pacote Python adiciona o arquivo __init__.py ao projeto para que o interpretador Python possa usar os arquivos do projeto como um módulo carregável externamente.

Os scripts Python podem ser marcados para posterior compilação em arquivos com extensão .pyc. O processo de compilação será exibido na próxima página do assistente.

O campo Caminho de Destino permite que você defina a propriedade de destino para cada arquivo. Isso pode ser feito manualmente, digitando o caminho desejado e os nomes das variáveis, ou chamando a janela de propriedades quando você clica no botão de engrenagem no Target Path:

A caixa de diálogo de propriedades do arquivo permite que você defina os valores da propriedade de destino e oferece uma lista conveniente de variáveis disponíveis. Ela também permite que você defina os parâmetros da plataforma de destino (tipo e versão do sistema operacional, modelo da CPU) na qual o arquivo será implementado.

Compilação de scripts Python

A página Compilação de Scripts Python será aberta se pelo menos um script Python tiver sido selecionado quando você adicionou os Recursos do Add-in.

A compilação será realizada por todos os interpretadores Python disponíveis. A lista de interpretadores disponíveis e usados pode ser editada na janela Configurações do Gerenciador de Add-in. O processo de compilação em si não requer intervenção do usuário, e a página exibe um registro de compilação detalhado para detectar possíveis problemas.

Configuração do aplicativo

A página Configuração do App permite que você customize como as suas ações ou scripts são vinculados a partir da interface de usuário do RoboDK (menu e barra de ferramentas). Você verá a janela Configuração do App se estiver criando um Add-in do tipo App.

Os parâmetros dessa página definem o conteúdo do arquivo AppConfig.ini. As chaves e os valores possíveis estão listados nesta página. Cada aplicativo tem seu próprio menu e barra de ferramentas no RoboDK. Os itens de menu e os botões da barra de ferramentas são chamados de Ações nos termos do aplicativo. Você pode definir as condições de exibição das ações, sua ordem no menu e atribuir teclas de atalho a elas.

O conjunto básico de parâmetros inclui:

●Nome do menu: Nome da entrada no menu principal do RoboDK.

●Visível: Desmarque essa caixa de seleção para evitar que o menu seja exibido no menu principal do RoboDK.

●Menu principal: Selecione o item de menu principal para o qual o menu secundário do aplicativo será criado ou selecione Principal para criar um item de menu principal.

●Prioridade: Defina a prioridade que determina a ordem em que os menus desse aplicativo são exibidos em relação aos menus dos outros aplicativos (o mais baixo aparece primeiro).

●Toolbar Area (Área da barra de ferramentas): Posição (lado) na janela principal do RoboDK onde a barra de ferramentas do aplicativo estará localizada.

●Escala da barra de ferramentas: Proporção dos ícones da barra de ferramentas em relação ao tamanho atual dos ícones da barra de ferramentas do RoboDK.

●Comandos: Comandos da API do RoboDK que serão executados quando o add-in for ativado.

É criada uma ação para cada script Python que esteja na mesma pasta do arquivo AppConfig.ini. Se o script for de natureza auxiliar, essa ação poderá ser suprimida usando a propriedade Visível.

As propriedades da ação são representadas pela lista a seguir:

●Nome: o nome da ação conforme aparece no menu e na barra de ferramentas.

●Descrição: texto de uma dica quando o usuário passa o ponteiro do mouse sobre um item de menu ou botão da barra de ferramentas.

●Prioridade: a ordem em que a ação é exibida em relação a outras ações desse aplicativo (a mais baixa aparece primeiro).

●Atalho

●Visível

●Somente para desenvolvedores: essa ação só será exibida se o RoboDK for alternado para o modo de desenvolvedor (Ctrl+Alt+Shift+G).

●Mostrar no menu

●Mostrar na barra de ferramentas

●Verificável: crie uma ação verificável, as ações verificáveis também podem ser agrupadas por números.

●Filtro do menu de contexto: define os tipos de elementos da árvore do RoboDK para os quais essa ação será adicionada ao menu de contexto.

●Filtro de clique duplo: define os tipos de elementos da árvore do RoboDK para os quais essa ação será chamada ao clicar duas vezes.

Criando seu pacote Add-in

A criação do Add-in é concluída com a construção do pacote do RoboDK como um arquivo RDKP. Essa é a etapa final da criação do seu Add-in.

No estágio final, pouco antes de criar o pacote, as seguintes opções estão disponíveis:

●Criptografar pacote: criptografe o arquivo para que ele possa ser facilmente enviado por e-mail, contornando os sistemas de detecção de ameaças (os serviços de e-mail do Google proíbem diretamente a transferência de arquivos executáveis e scripts Python em anexos).

●Instalar após a criação: permite que o Gerenciador de Add-ins instale o pacote recém-criado.

●Abrir pasta de conteúdo: abre a pasta onde o pacote foi criado.