En utilisant une syntaxe, des commandes et des attributs particuliers, il est possible de gérer les extensions via la ligne de commande.
Dans CS4 ou version ultérieure, la ligne de commande vous permet de procéder à plusieurs opérations pouvant être effectuées dans l’espace de travail d’Extension Manager.
Bases de la ligne de commande Extension Manager
-
-package
Empaquetage d’une extension. Attributs requis : mxi et mxp (CS5.5 et versions antérieures) ou zxp.
-install
Installation d’une extension. Attribut requis : mxp ou zxp. Attributs facultatifs : suppresseula (CS5.5 ou version ultérieure), forallusers (CS6 ou version ultérieure) et timeout (CS5 ou version ultérieure).
-remove
Suppression d’une extension. Attributs requis : product, extension. Attribut facultatif (CS5 ou version ultérieure) : timeout.
-enable
Activation d’une extension. Attributs requis : product, extension. Attribut facultatif (CS5 ou version ultérieure) : timeout.
-disable
Désactivation d’une extension. Attributs requis : product, extension. Attribut facultatif (CS5 ou version ultérieure) : timeout.
-activate
(CS6 ou version ultérieure) Activation d’un jeu pour un produit particulier. Attributs requis : product, set.
-import
(CS6 ou version ultérieure) Importation d’une configuration de jeu à partir d’un fichier XML. Attribut requis : setcfg.
-convert
(CS6 ou version ultérieure) Conversion d’une extension mxp en zxp. Attributs requis : mxp et zxp.
-locate
Localisation du produit de point dans l’espace de travail d’Extension Manager. Attribut requis : product.
-from
(CS5 ou version ultérieure) Indique l’émetteur de la commande lorsque le paramètre de ligne de commande est transmis via BridgeTalk. Après l’exécution de la commande, Extension Manager renvoie le résultat à l’émetteur spécifié. Attributs requis : product ou pcdentry.
-EMBT
Utilisé uniquement lorsque le paramètre de ligne de commande est transmis via BridgeTalk. -EMBT doit apparaître avant toutes les autres commandes. Attributs : aucun.
-suppress
Suppression de l’interface utilisateur d’Extension Manager. Doit précéder toutes les autres commandes, à l’exception de -EMBT. Attributs : aucun.
-locale
Définition des paramètres régionaux d’Extension Manager au démarrage. Attribut requis : lang.
-quit
(CS5 ou version ultérieure) Quitter Extension Manager. Cette commande doit être utilisée seule.
product
Indique le produit qui utilise l’extension. La valeur doit être la même que le nom du produit affiché dans le panneau de gauche de la fenêtre Extension Manager.
suppresseula
(CS5.5 ou version ultérieure) Indique si la boîte de dialogue du contrat de licence utilisateur final doit être supprimée ou non lors de l’installation de l’extension. Les valeurs valides sont « y » (supprimer) ou « n » (ne pas supprimer). La valeur par défaut est « n ».
forallusers
(CS6 ou version ultérieure) Indique que l’extension doit être installée pour tous les utilisateurs si la valeur est « y » et que l’extension est une extension par utilisateur. Une extension par utilisateur est un type d’extension dont les fichiers sont copiés dans des dossiers spécifiques à l’utilisateur lors de l’installation. La valeur par défaut est « n ».
timeout
(CS5 ou version ultérieure) Indique la durée maximale (en secondes) pendant laquelle Extension Manager patiente pendant la fermeture du produit avant d’exécuter la commande suivante. Doit suivre les commandes install/enable/disable/remove et doit être un entier positif compris entre 0 et 1 000.
Empaquetage d’une extension à partir de la ligne de commande
- Naviguez jusqu’au dossier de l’application Extension Manager.
- (Windows) Saisissez la commande suivante en spécifiant vos propres valeurs d’attributs :
- (CS4) : "Adobe Extension Manager CS4.exe" -package mxi="c:\myfile.mxi" mxp="c:\myfile.mxp"
- (CS5 et CS5.5, format MXP) : "XManCommand.exe" -package mxi="c:\monfichier.mxi" mxp="c:\monfichier.mxp"
- (CS5 ou version ultérieure, format ZXP) : "XManCommand.exe" -package mxi="c:\monfichier.mxi" zxp="c:\monfichier.zxp"
- (Macintosh) Saisissez la commande suivante en spécifiant vos propres valeurs d’attributs :
- (CS4/CS5/CS5.5, format MXP) : "./Adobe Extension Manager CSx" -package mxi="/myfolder/mysubfolder/myfile.mxi" mxp="/myfolder/mysubfolder/myfile.mxp"
- (CS5 ou version ultérieure, format ZXP) : "./Adobe Extension Manager CSx" -package mxi="/myfolder/mysubfolder/monfichier.mxi" zxp="/myfolder/mysubfolder/monfichier.zxp"
- (CS4/CS5/CS5.5, format MXP) : "./Adobe Extension Manager CSx" -package mxi="/myfolder/mysubfolder/myfile.mxi" mxp="/myfolder/mysubfolder/myfile.mxp"
- Installez et testez l’extension afin de vérifier que tout fonctionne comme prévu.
Installation d’une extension à partir de la ligne de commande
- Naviguez jusqu’au dossier de l’application Extension Manager.
- (Windows) Saisissez la commande suivante en spécifiant votre propre valeur d’attribut :
- (CS4) : "Adobe Extension Manager CS4.exe" -install mxp="c:\myfile.mxp"
- (CS5 ou version ultérieure, format MXP) : "XManCommand.exe" -install mxp="c:\myfile.mxp"
- (CS5 ou version ultérieure, format ZXP) : "XManCommand.exe" -install zxp="c:\myfile.zxp"
- (Macintosh) Saisissez la commande suivante en spécifiant votre propre valeur d’attribut :
- (Format MXP) : "./Adobe Extension Manager CSx" -install mxp="/myfolder/mysubfolder/myfile.mxp"
- (Format ZXP) : "./Adobe Extension Manager CSx" -install zxp="/myfolder/mysubfolder/myfile.mxp"
- Pour supprimer l’interface utilisateur d’Extension Manager, ajoutez la commande suppress avant la commande install, comme suit :
... -suppress -install zxp="c:\myfile.zxp" - Pour spécifier un paramètre régional, ajoutez la commande locale et spécifiez l’attribut lang avant la commande install, comme suit :
... -locale lang="fr_FR" -install zxp="c:\myfile.zxp" - Testez l’extension afin de vérifier que tout fonctionne comme prévu.
Suppression d’une extension à partir de la ligne de commande
-
- (Windows, CS5 ou version ultérieure) : XManCommand.exe -remove product="Dreamweaver CSx" extension="Sample"
- (Windows, CS4) : "Adobe Extension Manager CS4.exe" -remove product="Dreamweaver CS4" extension="Sample"
- (Macintosh) : "./Adobe Extension Manager CSx" -remove product="Dreamweaver CSx" extension="Sample"
- (Windows, CS5 ou version ultérieure) : XManCommand.exe -remove product="Dreamweaver CSx" extension="Sample"
Activation d’une extension à partir de la ligne de commande
-
- (Windows, CS5 ou version ultérieure) : XManCommand.exe -enable product="Dreamweaver CSx" extension="Sample"
- (Windows, CS4) : "Adobe Extension Manager CS4.exe" -enable product="Dreamweaver CS4" extension="Sample"
- (Macintosh) : "./Adobe Extension Manager CSx" -enable product="Dreamweaver CSx" extension="Sample"
Désactivation d’une extension à partir de la ligne de commande
-
- (Windows, CS5 ou version ultérieure) : XManCommand.exe -disable product="Dreamweaver CSx" extension="Sample"
- (Windows, CS4) : "Adobe Extension Manager CS4.exe" -disable product="Dreamweaver CS4" extension="Sample"
- (Macintosh) : "./Adobe Extension Manager CSx" -disable product="Dreamweaver CSx" extension="Sample"
Localisation du produit de point dans l’espace de travail d’Extension Manager
Conversion d’une extension MXP en ZXP à partir de la ligne de commande (CS6 ou version ultérieure)
- Naviguez jusqu’au dossier de l’application Extension Manager.
- Saisissez la commande suivante en spécifiant vos propres valeurs d’attributs :
- Windows : XManCommand.exe -convert mxp="c:\myOldExtension.mxp" zxp=”c:\myNewExtension.zxp"
- Mac OS : "./AdobeExtension Manager CS6" -convert mxp="/myfolder/mysubfolder/myOldExtension.mxp" zxp="/myfolder/mysubfolder/myNewExtension.zxp"
Utilisez l’attribut mxp pour indiquer l’extension MXP à convertir. Utilisez l’attribut zxp pour indiquer le chemin et le nom de la nouvelle extension ZXP.
Activation d’un jeu d’extensions à partir de la ligne de commande (CS6 ou version ultérieure)
- Naviguez jusqu’au dossier de l’application Extension Manager.
- Saisissez la commande suivante en définissant votre propre valeur d’attribut :
- Windows : XManCommand.exe -activate product="Dreamweaver CS6" set="Adobe Extensions"
- Mac OS : "./Adobe Extension Manager CS6" -activate product="Dreamweaver CS6" set="Adobe Extensions"
Utilisez l’attribut product pour indiquer le produit pour lequel activer le jeu d’extensions. Utilisez l’attribut set pour indiquer le nom du jeu d’extensions à activer.
Importation de la configuration d’un jeu à partir de la ligne de commande (CS6 ou version ultérieure)
- Naviguez jusqu’au dossier de l’application Extension Manager.
- Saisissez la commande suivante en définissant votre propre valeur d’attribut :
- Windows : XManCommand.exe -import setcfg="c:\SetConfig.xml"
- Mac OS : "./Adobe Extension Manager CS6" -import setcfg="/myfolder/mysubfolder/SetConfig.xml"
Utilisez l’attribut setcfg afin d’indiquer le chemin et le nom du fichier de configuration du jeu à importer.
Exécution des commandes via BridgeTalk
Extension Manager peut exécuter des commandes transmises via BridgeTalk. Toutes les commandes envoyées via BridgeTalk doivent commencer par le paramètre -EMBT. Pour envoyer des commandes vers Extension Manager, indiquez l’identifiant BridgeTalk cible à l’aide de l’attribut "exman-6.0".
Exécutez le script d’exemple ci-dessous dans ExtendScript Toolkit CS6 pour envoyer une commande d’empaquetage à Extension Manager via BridgeTalk.
Windows : var bt = new BridgeTalk(); bt.target = "exman-6.0" ; bt.body = ’-EMBT -package mxi="C:\\test.mxi" zxp="C:\\test.zxp"’ ; bt.send(); |
Mac OS : var bt = new BridgeTalk(); bt.target = "exman-6.0" ; bt.body = ’-EMBT -package mxi="/Volumes/x1/test.mxi" zxp="/Volumes/x1/test.zxp"’ ; bt.send(); |
Codes de retour générés après l’exécution de commandes
Extension Manager fournit des codes de retour après l’exécution de commandes lorsque l’un des deux paramètres suivants est inclus dans la commande :
- « -suppress » (l’interface utilisateur d’Extension Manager ne s’affiche pas lorsque la commande est exécutée)
- « -from »
Après l’exécution de la commande, Extension Manager renvoie l’un des codes de retour suivants :
0 - La commande a abouti.
1 - L’installation de l’extension a échoué.
2 - La suppression de l’extension a échoué.
3 - L’activation de l’extension a échoué.
4 - La désactivation de l’extension a échoué.
5 - L’empaquetage de l’extension a échoué.
6 - L’activation du jeu d’extensions a échoué.
7 - Une instance d’Extension Manager est déjà ouverte.
8 - L’importation de la configuration du jeu a échoué.
101 - Format CLI incorrect
102 - Le produit spécifié n’existe pas.
103 - L’extension spécifiée n’existe pas.
104 - L’extension spécifiée est déjà activée.
105 - L’extension spécifiée est déjà désactivée.
106 - Le jeu d’extensions spécifié n’existe pas.
107 - Le fichier de configuration du jeu spécifié n’existe pas.
108 - Le fichier de configuration du jeu spécifié est incorrect.
109 - L’extension spécifiée ne peut pas être activée ni désactivée lorsque le jeu d’extensions actif est prédéfini.
Remarque : si l’exécution de la commande requiert des droits d’administration et que le niveau d’autorisation actuel est insuffisant, Extension Manager CS5.5 (ou version ultérieure) exige les informations d’identification de l’administrateur lorsque l’interface utilisateur n’est pas supprimée. Lorsque l’interface utilisateur est supprimée (si le paramètre -suppress est spécifié), l’exécution échoue. Dans ce cas, ouvrez l’invite de commande en tant qu’administrateur (Windows) ou utilisez la commande sudo dans la fenêtre Terminal (Macintosh).
Accéder à votre compte