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

En utilisant une syntaxe, des commandes et des attributs particuliers, il est possible de gérer les extensions via la ligne de commande.

  1. Sous Windows, ouvrez l’invite de commandes en sélectionnant Démarrer > Tous les programmes > Accessoires > Invite de commandes. Sous Mac Os, ouvrez Terminal en double-cliquant sur l’icône correspondante dans le dossier Applications/Utilitaires.
  2. Accédez au dossier suivant :

    • Windows : C:\Program Files\Adobe\Adobe Extension Manager CSx\
    • Mac OS : /Applications/Adobe Extension Manager CSx/Adobe Extension Manager CSx.app/Contents/MacOS

    où CSx est le numéro de version d’Extension Manager, tel que CS6.

  3. Dans la ligne de commande, indiquez l’exécutable comme suit (en intégrant les guillemets) :
    • Windows (CS5 ou version ultérieure) : XManCommand.exe
    • Windows (CS4) : "Adobe Extension Manager CS4.exe"
    • Mac OS : “./Adobe Extension Manager CSx

    où CSx est le numéro de version d’Extension Manager, tel que CS6.

  4. Après l’exécutable, saisissez la commande souhaitée.

    Les commandes disponibles sont décrites dans la liste suivante :

    -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.

    Les attributs disponibles sont décrits dans la liste suivante :

    mxi

    Indique le nom et l’emplacement du fichier d’installation de l’extension.

    mxp

    Indique le nom et l’emplacement du fichier de compression au format MXP.

    zxp

    Indique le nom et l’emplacement du fichier de compression au format ZXP.

    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.

    extension

    Indique le nom de l’extension (comme indiqué dans le fichier MXI).

    pcdentry

    (CS5 ou version ultérieure) Indique l’identifiant BridgeTalk de l’émetteur de la commande.

    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 ».

    lang

    Indique le code de la langue locale (fr_FR, par exemple).

    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.

    set

    (CS6 ou version ultérieure) Indique le nom du jeu à activer.

    setcfg

    (CS6 ou version ultérieure) Indique le nom et l’emplacement du fichier de configuration du jeu exporté.

Empaquetage d’une extension à partir de la ligne de commande

  1. Naviguez jusqu’au dossier de l’application Extension Manager.
  2. (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"
  3. (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"
  4. 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

  1. Naviguez jusqu’au dossier de l’application Extension Manager.
  2. (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"
  3. (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"
  4. Pour supprimer l’interface utilisateur d’Extension Manager, ajoutez la commande suppress avant la commande install, comme suit :
    ... -suppress -install zxp="c:\myfile.zxp"
  5. 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"
  6. Testez l’extension afin de vérifier que tout fonctionne comme prévu.

Suppression d’une extension à partir de la ligne de commande

  1. Naviguez jusqu’au dossier de l’application Extension Manager.
  2. Saisissez la commande suivante en spécifiant vos propres valeurs d’attributs :
    • (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"

    où CSx est le numéro de version d’Extension Manager, tel que CS6.

    Utilisez l’attribut product pour indiquer quel produit utilise l’extension. Utilisez l’attribut extension pour indiquer le nom de l’extension.

Activation d’une extension à partir de la ligne de commande

  1. Naviguez jusqu’au dossier de l’application Extension Manager.
  2. Saisissez la commande suivante en spécifiant vos propres valeurs d’attributs :
    • (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"

    où CSx est le numéro de version d’Extension Manager, tel que CS6.

    Utilisez l’attribut product pour indiquer quel produit utilise l’extension. Utilisez l’attribut extension pour indiquer le nom de l’extension.

Désactivation d’une extension à partir de la ligne de commande

  1. Naviguez jusqu’au dossier de l’application Extension Manager.
  2. Saisissez la commande suivante en spécifiant vos propres valeurs d’attributs :
    • (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"

    où CSx est le numéro de version d’Extension Manager, tel que CS6.

    Utilisez l’attribut product pour indiquer quel produit utilise l’extension devant être désactivée. Utilisez l’attribut extension pour indiquer le nom de l’extension.

Localisation du produit de point dans l’espace de travail d’Extension Manager

  1. Naviguez jusqu’au dossier de l’application Extension Manager.
  2. Saisissez la commande suivante en définissant votre propre valeur d’attribut :
    • (Windows, CS5 ou version ultérieure) : XManCommand.exe -locate product="Dreamweaver CSx"
    • (Windows, CS4) : "Adobe Extension Manager CS4.exe" -locate product="Dreamweaver CS4"
    • (Macintosh) : "./Adobe Extension Manager CSx" -locate product="Dreamweaver CSx"

    où CSx est le numéro de version d’Extension Manager, tel que CS6.

    Utilisez l’attribut product pour indiquer quel produit doit être localisé.

Conversion d’une extension MXP en ZXP à partir de la ligne de commande (CS6 ou version ultérieure)

  1. Naviguez jusqu’au dossier de l’application Extension Manager.
  2. 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)

  1. Naviguez jusqu’au dossier de l’application Extension Manager.
  2. 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)

  1. Naviguez jusqu’au dossier de l’application Extension Manager.
  2. 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).

Ce produit est distribué sous licence Creative Commons Attribution - Pas d’utilisation commerciale - Partage à l’identique 3.0 non transposé  Les publications Twitter™ et Facebook ne sont pas couvertes par les dispositions Creative Commons.

Mentions légales   |   Politique de confidentialité en ligne