Créateur d'Add-in

L'outil Add-in Creator vous permet de créer et de modifier facilement des packages d'Add-in RoboDK. L'outil Add-in Creator fait partie du gestionnaire d'Add-in.

Vous pouvez ouvrir le créateur de Add-ins en sélectionnant Outils-Gestionnaire de Add-ins et en cliquant sur le bouton Créer un Add-in en bas du Gestionnaire de Add-ins.

Lorsque vous ouvrez l'assistant du créateur d'Add-in, vous pouvez choisir parmi les options suivantes :

●Créez un nouvel Add-in à partir de zéro : vous obtiendrez un nouveau package RoboDK (fichier RDKP).

●Créer un nouveau Add-in à partir d'un dossier ou d'une application existante : dans ce cas, vous pouvez indiquer le parcours du dossier où se trouvent les fichiers de votre Add-in. L'option Ne pas créer de package vous permet de modifier un Add-in directement dans le dossier où il réside sans créer de package RoboDK (fichier RDKP).

●Modifier un add-in existant : ouvre un paquetage RoboDK existant pour le modifier et en créer une nouvelle version.

Créer ou modifier des Add-in

Vous pouvez facilement créer un nouvel Add-in en saisissant des informations de base telles que le type, le nom, les informations sur l'auteur, etc.

Dans la fenêtre Add-in Creator, les champs obligatoires sont en gras. Il y en a cinq au total :

1.Type : Le type de votre Add-in, tel que App, Pilote de robot, etc.

2.Nom : Le nom de votre Add-in.

3.Identifiant unique : un identifiant unique qui appartient à ce module complémentaire spécifique. La case à cocher située à côté de ce champ vous permet d'activer le mode édition et de définir un identifiant arbitraire, qui peut contenir des lettres latines, des chiffres et des caractères supplémentaires tels que le signe moins, le point ou le trait de soulignement.

4.Version : La version doit être écrite en utilisant le format (major.minor.patch).

5.Révision : Le nombre de modifications de l'Add-in, il prend des valeurs numériques de 1 et plus.

Les champs restants sont facultatifs, mais vous permettent de donner une description plus précise de l'Add-in :

6.Auteur : Le prénom et le nom de l'auteur, ou le nom de votre entreprise ou de votre équipe (s'il y a plusieurs auteurs).

7.Entreprise : Le nom de l'entreprise.

8.Langue : La langue utilisée dans l'Add-in. Toutes les langues de la norme IETF BCP 47 sont répertoriées.

9.Statut du contenu : Statut du Add-in, par exemple : final, test interne, bêta, etc.

10.Description : Brève description de l'Add-in.

11.Modifié par : Ce champ peut être utilisé lorsque quelqu'un modifie l'Add-in d'un autre auteur et souhaite être mentionné comme l'auteur des modifications.

12.Créé : Date de création de la première version de l'add-in (à remplir automatiquement).

13.Modifié : Date de modification de l'Add-in (à remplir automatiquement).

14.Courriel : Adresse électronique à des fins de vente, d'assistance ou de retour d'information.

15.Site web : Le site web de votre entreprise (développeur de l'Add-in).

16.Lien de documentation : Lien vers la documentation de votre Add-in.

17.Lien vers le dépôt : Pour les Add-in open-source, un lien vers le dépôt GitHub ou un autre dépôt public où se trouve l'add-in.

18.Mots-clés : Une liste de mots-clés (tags) pour simplifier la recherche de Add-ins dans le Add-in Marketplace.

Ajouter des actifs à votre Add-in

L'Add-in doit contenir une ou plusieurs ressources. Les actifs peuvent être des scripts et des icônes qui définiront les actions de votre Add-in.

La page Add-in Assets est divisée en trois zones fonctionnelles :

1.Zone de sélection de l'icône du package.

2.Zone d'arborescence des fichiers.

3.Zone de prévisualisation du contenu du fichier.

L'objectif des boutons et de la case à cocher de cette page :

●Le bouton TargetPath : Le bouton Target Path ouvre la fenêtre des propriétés du fichier d'icône actuel et vous permet de définir la propriété de la cible (voir la section correspondante sur les éléments internes du package).

●Le bouton Changer l’icône… vous permet de remplacer l'icône actuelle du package par une nouvelle icone.

●Le bouton Supprimer l'icône supprime l'icône actuelle du package et définit l'icône par défaut correspondant au type du package en cours de création.

●Le bouton Nouveau dossier crée un nouveau sous-dossier dans la branche sélectionnée de l'arborescence des fichiers.

●Le bouton Add-in... permet d'ajouter de nouveaux fichiers à la branche sélectionnée de l'arborescence.

●Le bouton Supprimer supprime les éléments sélectionnés de l'arborescence des fichiers, à l'exception de ceux qui sont verrouillés.

●La case à cocher Make Python Package ajoute le fichier __init__.py au projet afin que l'interpréteur Python puisse utiliser les fichiers du projet comme un module chargeable en externe.

Les scripts Python peuvent être marqués pour être compilés ultérieurement dans des fichiers portant l'extension .pyc. Le processus de compilation sera affiché sur la page suivante de l'assistant.

Le champ Chemin cible vous permet de définir la propriété cible pour chaque fichier. Vous pouvez le faire soit manuellement, en tapant le parcours et les noms de variables souhaités, soit en invoquant la fenêtre des propriétés lorsque vous cliquez sur le bouton en forme d'engrenage dans le champ Chemin cible :

La boîte de dialogue des propriétés du fichier vous permet de définir les valeurs de la propriété cible et offre une liste pratique des variables disponibles. Elle vous permet également de définir les paramètres de la plateforme cible (type et version du système d'exploitation, modèle de CPU) sur laquelle le fichier sera déployé.

Compilation de scripts Python

La page Compilation Python s'ouvre si au moins un script Python a été sélectionné lors de l'ajout des ressources de l'Add-in.

La compilation sera effectuée par tous les interprètes Python disponibles. La liste des interprètes disponibles et utilisés peut être modifiée dans la fenêtre Paramètres du gestionnaire d'Add-in. Le processus de compilation lui-même ne nécessite aucune intervention de la part de l'utilisateur, et la page affiche un journal de compilation détaillé afin de détecter les problèmes potentiels.

Configuration de l'application

La page App Configuration vous permet de personnaliser la manière dont vos actions ou vos scripts sont liés à l'interface utilisateur de RoboDK (menu et barre d'outils). Vous verrez la fenêtre Configuration de l'App si vous créez un Add-in de type App.

Les paramètres de cette page définissent le contenu du fichier AppConfig.ini. Les clés et valeurs possibles sont listées sur cette page. Chaque application possède son propre menu et sa propre barre d'outils dans RoboDK. Les éléments de menu et les boutons de la barre d'outils sont appelés Actions en termes d'application. Vous pouvez définir les conditions d'affichage des actions, leur ordre dans le menu et leur attribuer des raccourcis clavier.

L'ensemble des paramètres de base comprend

●Menu Name (Nom du menu) : Nom de l'entrée dans le menu principal de RoboDK.

●Visible : Décochez cette case pour empêcher l'affichage du menu dans le menu principal de RoboDK.

●Menu principal : Sélectionnez l'élément de menu principal pour lequel le menu enfant de l’App sera créé ou sélectionnez Main pour créer un nouvel élément de menu principal.

●Priorité : Définissez la priorité qui détermine l'ordre d'affichage des menus de cette application par rapport aux menus des autres applications (le plus bas s'affiche en premier).

●Toolbar Area (Zone de la barre d'outils) : Position (côté) sur la fenêtre principale de RoboDK où la barre d'outils de l'application sera située.

●Toolbar Scale (Échelle de la barre d'outils) : Proportion des icônes de la barre d'outils par rapport à la taille actuelle des icônes de la barre d'outils de RoboDK.

●Commandes : Commandes de l'API RoboDK qui seront exécutées lorsque le Add-in sera activé.

Une action est créée pour chaque script Python qui se trouve dans le même dossier que le fichier AppConfig.ini. Si le script est de nature auxiliaire, cette action peut être supprimée à l'aide de la propriété Visible.

Les propriétés de l'action sont représentées par la liste suivante :

●Nom : le nom de l'action tel qu'il apparaît dans le menu et dans la barre d'outils.

●Description : texte d'une infobulle lorsque vous passez le pointeur de la souris sur un élément de menu ou un bouton de la barre d'outils.

●Priorité : l'ordre dans lequel l'action est affichée par rapport aux autres actions de cette application (la plus basse apparaît en premier).

●Raccourci

●Visible

●Développeur uniquement : cette action ne sera affichée que si RoboDK est passé en mode développeur (Ctrl+Alt+Shift+G).

●Afficher dans le menu

●Afficher dans la barre d'outils

●Contrôlable : créez une action contrôlable. Les actions contrôlables peuvent également être regroupées par numéros.

●Filtre du menu contextuel : définit les types d'éléments de l'arbre RoboDK pour lesquels cette action sera ajoutée au menu contextuel.

●Filtre double-clic : définit les types d'éléments de l'arbre RoboDK pour lesquels cette action sera appelée lors d'un double-clic.

Création de votre Add-in Package

La création de l'Add-in s'achève par la construction du package RoboDK sous la forme d'un fichier RDKP. C'est la dernière étape de la création de votre Add-in.

À l'étape finale, juste avant de créer le package, les options suivantes sont disponibles :

●Cryptage du package : cryptez le fichier afin qu'il puisse être facilement envoyé par courrier électronique, en contournant les systèmes de détection des menaces (les services de messagerie de Google interdisent directement le transfert de fichiers exécutables et de scripts Python dans les pièces jointes).

●Installer après la création : permet au gestionnaire d'Add-in d'installer le package nouvellement créé.

●Ouvrir le dossier contenant : ouvrir le dossier dans lequel le package a été créé.