Un “ Magic Folder ” correspond à un emplacement spécifique, par exemple le dossier d’installation sélectionné par l’utilisateur, le bureau Windows ou l’emplacement des fichiers de bibliothèque. Lors de l’installation, l’installateur détecte le système d’exploitation utilisé par l’ordinateur et il associe les Magic Folders aux chemins absolus appropriés. En général, les Magic Folders dépendent de la plate-forme considérée ; la plupart d’entre eux sont implantés automatiquement par InstallAnywhere dans des emplacements standard des différentes plates-formes supportées.
Chaque Magic Folder est associé à une variable InstallAnywhere. La première initialisation de ces variables a lieu au lancement de l’installateur. Chaque fois que la valeur d’une variable de Magic Folder est modifiée, le Magic Folder correspondant est installé dans une destination différente. Tout changement de valeur de $USER_INSTALL_DIR$ (dans InstallAnywhere) modifie la destination d’installation des fichiers.
À trois exceptions près (voir ci-dessous), ces variables sont initialisées lors de l’installation et ne changent pas – sauf par utilisation de code personnalisé ou par exécution de l’action “ Définir une variable ”. Les trois exceptions sont les suivantes :
$USER_INSTALL_DIR$: – Cette variable est initialisée à la valeur par défaut déterminée dans la tâche Plates-formes d’Advanced Designer. Sa valeur peut changer lors de l’étape Sélection du dossier d’installation, si l’utilisateur sélectionne un dossier différent.
$USER_SHORTCUTS$: – Cette variable est initialisée à la valeur par défaut déterminée dans la tâche Plates-formes d’Advanced Designer. Sa valeur peut changer lors de l’étape Créer alias/lien/raccourci, si l’utilisateur sélectionne un emplacement différent.
$JAVA_HOME$: Pour un installateur sans VM, prend par défaut la valeur de la propriété Java java.home. Cette valeur peut changer lors de l’exécution de l’étape Sélection de la VM Java, si l’utilisateur sélectionne une VM. Pour un installateur avec VM, prend par défaut la valeur spécifiée dans la tâche Projet | Java. Cette valeur peut changer si $USER_INSTALL_DIR$ change, ou lors de l’étape Sélection de la VM Java, si l’utilisateur sélectionne une VM déjà présente sur son système.
Remarque :la valeur d’une variable ne peut pas être cette variable. Exemple : pour compléter/tester USER_MAGIC_FOLDER_1, il n’est pas possible de déclarer USER_MAGIC_FOLDER_1 = USER_MAGIC_FOLDER_1$/$test. InstallAnywhere n’autorise pas la récursion directe ou indirecte avec les variables InstallAnywhere (cette situation déclenche une erreur).
|
Nom du dossier |
Variable InstallAnywhere |
Destination |
|
Dossier d’installation sélectionné par l’utilisateur |
$USER_INSTALL_DIR$ |
Dossier d’installation désigné par l’utilisateur. Les développeurs peuvent spécifier la valeur par défaut de cette variable dans l’écran Infos sur le projet d’Advanced Designer, et sélectionner un emplacement dans la zone Dossier d’installation par défaut. |
|
Dossier des programmes |
$PROGRAMS_DIR$ |
Dossier du système de destination dans lequel les applications sont installées par défaut, soit Windows = dossier \Program Files\ ; Mac OS = dossier Applications ; UNIX = compte Home de l’utilisateur ayant ouvert la session. |
|
Raccourcis |
$USER_SHORTCUTS$ |
Dossier spécifié par l’utilisateur comme emplacement pour les raccourcis/liens/alias. L’utilisateur peut changer la valeur de cet emplacement en activant l’action Sélectionner le dossier des alias/liens/raccourcis dans l’installateur. Les développeurs peuvent spécifier une valeur par défaut pour cette variable (en fonction de la plate-forme cible) en sélectionnant la tâche Plates-formes d’Advanced Designer. |
|
Système |
$SYSTEM$ |
Cette variable représente le dossier contenant les fichiers système de la machine cible. Sous Windows 95/98, sa valeur est : <WINDOWS>\System. Sous Windows NT/2000, sa valeur est : <WINDOWS>\System32. Sous Mac OS, sa valeur est : dossier System. Sous UNIX, sa valeur est : /usr/local/bin. |
|
Bureau |
$DESKTOP$ |
Cette variable représente le dossier “ bureau ” de la machine cible (limité aux systèmes sous Windows, Linux et Mac OS). |
|
Dossier temporaire |
$TEMP_DIR$ |
Cette variable représente le dossier temporaire (Temp) de la machine cible. Si l’installateur exécuté est de type Pure Java sous Windows, $TEMP_DIR$prend la valeur du dossier racine/Home de l’utilisateur. |
|
Démarrage |
$STARTUP$ |
Dossier contenant les applications qui sont lancées automatiquement au démarrage du système d’exploitation (limité aux systèmes sous Windows et Mac OS). |
|
Racine/root de l’unité d’installation |
$INSTALL_DRIVE_ROOT$ |
Dossier root/racine du volume sélectionné pour l’installation. |
|
Dossier Home |
$USER_HOME$ |
Dossier Home de l’utilisateur qui exécute l’installateur. Cette variable est disponible avec toutes les plates-formes sauf Mac OS. Si la variable $UNIX_USER_HOME$ a déjà été spécifiée, elle utilisera la même définition que $USER_HOME$. |
|
Racine/root de l’unité système |
$SYSTEM_DRIVE_ROOT$ |
Dossier racine/root de l’unité contenant les fichiers système. |
|
Dossier Home pour Java |
$JAVA_HOME$ |
Dossier Home de la VM Java qui sera utilisée. |
|
Windows |
$WIN_WINDOWS$ |
Dossier Windows (uniquement pour systèmes sous Windows 95/98/Me/XP/NT/2000). |
|
Menu Démarrer |
$WIN_START_MENU$ |
Dossier contenant les applications déclarées dans le menu Démarrer de Windows (uniquement pour systèmes sous Windows 95/98/Me/XP/NT/2000). |
|
Barre de lancement rapide (Quick Launch) |
$WIN_QUICK_LAUNCH_BAR$ |
Barre de lancement rapide (Quick Launch) sous Windows. Sous Windows 2000 et XP, l’emplacement de la Quick Launch dépend de la valeur de la variable denvironnement UserProfile. Sous Windows 98/Me, l’emplacement de la barre Quick Launch est relatif par rapport au dossier Windows. |
|
Ne pas installer |
$DO_NOT_INSTALL$ |
Indique que le fichier ne doit pas être installé sur la plate-forme cible. Utilisé pour les fichiers qui sont utilisés pendant l’installation mais qui ne sont pas conservés dans le système cible (par exemple, Contrat de licence localisé et éléments graphiques). |
|
USER_ |
$USER_MAGIC_FOLDER_#$ |
Ces variables représentent des Magic Folders de destination d’installation définies par l’utilisateur. elles correspondent aux dossiers indiqués par leur nom. Pour définir ces variables, utilisez l’action Définir variable. |
|
Menu Programmes |
$WIN_PROGRAMS_MENU$ |
Menu Programmes du menu Démarrer de Windows (95/98/Me/XP/NT/2000 uniquement). |
|
Menu Démarrer/Tous utilisateurs |
$WIN_COMMON_ START_ MENU$ |
Dossier All Users\Start Menu (Windows NT/2000 uniquement). Sous Win 9x, même valeur que $WIN_START_MENU$. |
|
Menu Tous utilisateurs/Programmes |
$WIN_COMMON_PROGRAMS _MENU$ |
Dossier All Users\Start Menu\Programs (Windows NT/2000 uniquement ; sous XP : Tous utilisateurs\Menu Démarrer\Programmes).Sous Win 9x, même valeur que $WIN_PROGRAMS_MENU$. |
|
Menu Démarrer/Tous utilisateurs
|
$WIN_COMMON_STARTUP$
|
Dossier Tous utilisateurs/Démarrage de Windows (dans le menu Démarrer) (Windows NT/2000/XP uniquement). Sous Win 9x, même valeur que $STARTUP$.
|
|
Bureau/Tous utilisateurs
|
$WIN_COMMON_DESKTOP$
|
Dossier “ bureau commun ” de Windows (Windows NT/2000/XP uniquement). Sous Win 9x, même valeur que $DESKTOP$. |
|
Polices |
$FONTS$
|
Dossiers contenant les polices (Windows et Mac OS uniquement). $WIN_WINDOWS$\Fonts(sous Windows), $SYSTEM$:Fonts (sous Mac OS)
|
|
Articles de menu Apple |
$MAC_APPLE_MENU$ |
Dossier des articles de menu Apple (Mac OS uniquement). |
|
Tableaux de bord |
$MAC_CONTROL_PANELS$
|
Dossier des tableaux de bord Apple (Mac OS uniquement).
|
|
Extensions |
$MAC_EXTENSIONS$ |
Dossier des extensions (Mac OS uniquement). |
|
Préférences |
$MAC_PREFERENCES$ |
Dossier des préférences (Mac OS uniquement). $SYSTEM$:Preferences |
|
Nettoyage au démarrage |
$MAC_CHEWABLE$ |
Dossier de nettoyage au démarrage (Mac OS uniquement). $SYSTEM_DRIVE_ROOT$:Cleanup At Startup |
|
Applications de l’utilisateur |
$MACX_USER_APPLICATIONS$ |
Dossier Applications utilisateur de l’utilisateur exécutant l’installateur (Mac OS X uniquement). |
|
Dock |
$MACX_DOCK$ |
Dock Mac OS X – Pour raccourcis uniquement. Les fichiers ne peuvent pas être installés dans le Dock. |
|
/usr/local/bin |
$UNIX_USR_LOCAL_BIN$ |
Répertoire /usr/local/bin (systèmes UNIX uniquement). |
|
/opt |
$UNIX_OPT$ |
Répertoire /opt directory (systèmes UNIX uniquement). |
|
/usr/bin |
$UNIX_USR_BIN$ |
Répertoire /usr/bin (systèmes UNIX uniquement). |
Remarque : dans la version Standard Edition d’InstallAnywhere, les développeurs ne peuvent pas définir de Magic Folders.