Créer et exécuter des actions personnalisées
Les commandes personnalisées exécutent vos propres programmes sur un référentiel à partir du bouton Custom actions et des menus de validation, de branche et de fichier. Chaque argument est passé exactement tel qu'il est écrit, aucun shell n'est impliqué et la première exécution d'une commande montre exactement ce qui sera exécuté avant elle.
Fonctionne dans GitTree Gratuit : toutes les fonctionnalités Git locales, une fois connecté.
Sur cette page
Avant de commencer
- Le programme que vous souhaitez exécuter est installé et vous connaissez son chemin complet.
Où le trouver
- Préférences › External Tools › Custom Commands pour les ajouter.
- Le bouton Custom actions dans la barre d'outils, le menu Custom Commands sur un commit, une branche ou un fichier, ou la palette : Run Custom Command….
| Action | macOS | Windows et Linux |
|---|---|---|
| Préférences | ⌘, | Ctrl+, |
| La palette de commandes | ⌘⇧P | Ctrl+Shift+P |
Mesures
Ajouter une commande
Dans Custom Commands, appuyez sur Add Command, donnez-lui un Name et choisissez le Program avec Browse… ou tapez son chemin complet.
Ajouter ses arguments
Appuyez sur Add Argument pour chacun. Utilisez
{repo}(le dossier de travail),{branch},{sha}ou{file}où GitTree doit en remplir un. Cochez Ask before every run s'il doit toujours demander. Appuyez sur Save Commands.Exécutez-le
Choisissez-le dans Custom actions ou dans un menu de branche, de validation ou de fichier. La première fois, GitTree répertorie le programme et chaque argument sous Program and arguments, ainsi que le dossier Runs in ; appuyez sur Run.
Lire la sortie
La fenêtre affiche Output et Messages et indique qu'elle a terminé ou échoué avec son code de sortie. Stop met fin à une longue course.
Résultat attendu
Votre commande s'est exécutée sur le référentiel, la branche, le commit ou le fichier que vous avez choisi, et vous avez vu ce qu'elle imprimait.
Comment les commandes s'exécutent
- Chaque champ d'argument est un argument : les espaces et les guillemets n'ont pas besoin d'être échappés. Rien n'est géré par un shell, donc les tuyaux et
&&ne fonctionnent pas ; pointez plutôt le programme vers un script. - Une commande s'exécute uniquement lorsque vous la choisissez. Une commande que vous modifiez affiche à nouveau sa vérification lors de la prochaine exécution.
- Une commande qui nécessite
{branch},{sha}ou{file}s'exécute uniquement à partir d'un menu qui en possède un.
Si quelque chose ne va pas
"Aucune de vos commandes personnalisées ne peut s'exécuter ici."
Leurs arguments nécessitent une branche, un commit ou un fichier : exécutez-les depuis le menu de cet élément.
Questions
Une commande personnalisée peut-elle utiliser mes alias shell ?
Non, car aucun shell ne l'exécute. Utilisez bash, zsh ou pwsh comme programme et votre script comme argument.