CHEMIN Table des matières > Définition des pré-requis et scripts d'installation des composants
Définition des pré-requis et scripts d'installation des composants

Ce document décrit les pré-requis et scripts d'installation que vous pouvez définir et qui permettent respectivement de déterminer si un composant peut être installé sur la machine ou un volume en particulier et les opérations à effectuer avant et après l'installation du composant.

Enfin, ce document décrit comment procéder pour ajouter des resources, par exemple utilisées par un script d'installation, à un composant.

Gestion des pré-requis d'installation

Par défaut, lorsque vous installez un composant, celui-ci peut être installé sur tout Macintosh fonctionnant sous Mac OS X et sur n'importe quelle partition (sous réserve, bien entendu, que l'option Volume de boot uniquement du ou d'un des packages soit inactive).

Les pré-requis d'installation permettent de déterminer d'une part si un composant peut étre installé avec le système d'exploitation courant ou les applications installées sur celui-ci, d'autre part sur quelles partitions le composant peut être installé.

Il existe deux niveaux pour un pré-requis :

Important : Les pré-requis d'installation ne sont évalués par le Programme d'installation qu'à partir de Mac OS X 10.3 et ultérieur. Si vous souhaitez être compatible avec des versions antérieures de Mac OS X, il est recommandé d'utiliser les scripts InstallationCheck ou VolumeCheck.

Pour ajouter un pré-requis d'installation :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Cliquez sur le bouton Ajouter… dans la section Pré-requis.
4Configurez le pré-requis comme vous le souhaitez.
5Cliquez sur le bouton OK.

Pour éditer un pré-requis d'installation :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Sélectionnez le pré-requis dans la liste des Pré-requis.
4Cliquez sur le bouton Éditer… dans la section Pré-requis.
5Modifiez les réglages du pré-requis.
6Cliquez sur le bouton OK.

Pour supprimer un pré-requis d'installation :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Sélectionnez le ou les pré-requis que vous souhaitez supprimer.
4Cliquez sur le bouton Supprimer… dans la section Pré-requis.
5Cliquez sur le bouton Supprimer.

Pour activer ou désactiver un pré-requis d'installation :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Sélectionnez le pré-requis.
4Cochez ou décochez la boîte à cocher dans la colonne Adhésion (•).

Pour modifier le niveau d'un pré-requis d'installation :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Sélectionnez le pré-requis dont vous souhaitez modifier le niveau.
4Cliquez sur le menu local dans la colonne Niveau et choisissez le niveau que vous souhaitez.

Configuration des pré-requis d'installation

Il existe deux familles de pré-requis. Ceux qui sont évalués au tout début de l'installation et qui permettent de décider si l'installation d'un composant est possible avec le système actuel et ceux qui sont évalués pour chaque partition disponible afin de savoir quelles partitions peuvent être choisies pour installer le composant.

Voici la description des différents pré-requis disponibles :

Chaque pré-requis est défini par les éléments suivants :

Pour ajouter un pré-requis de type Package :

1Sélectionnez le metapackage dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Cliquez sur le bouton Ajouter… dans la section Pré-requis.
4Saisissez le libellé du pré-requis dans le champ libellé.
5Sélectionnez le niveau du pré-requis dans le menu local Niveau.
6Sélectionnez Package dans le menu local en haut à gauche de la section Spécification.
7Saisissez l'identifiant (CFBundleIdentifier) du package dans le champ Bundle Identifier.
8Sélectionnez la clé du fichier Info.plist dont la valeur doit être comparée dans le menu local clé.
9Sélectionnez la fonction de comparaison dans le menu local comparateur.
10Saisissez la valeur de comparaison dans le champ en bas à droite de la section Spécification.
11Saisissez le titre de l'alerte dans le champ Titre.
12Saisissez le message de l'alerte dans le champ Message.
13Cliquez sur le bouton OK.

Pour ajouter un pré-requis de type Gestalt :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Cliquez sur le bouton Ajouter… dans la section Pré-requis.
4Saisissez le libellé du pré-requis dans le champ libellé.
5Sélectionnez le niveau du pré-requis dans le menu local Niveau.
6Sélectionnez Gestalt dans le menu local en haut à gauche de la section Spécification.
7Saisissez l'identifiant du gestalt dans le champ texte ou bien sélectionnez le dans le menu local.
8Sélectionnez la fonction de comparaison dans le menu local comparateur.
9Saisissez la valeur de comparaison dans le champ en bas à droite de la section Spécification.
10Saisissez le titre de l'alerte dans le champ Titre.
11Saisissez le message de l'alerte dans le champ Message.
12Cliquez sur le bouton OK.

Pour ajouter un pré-requis de type sysctl :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Cliquez sur le bouton Ajouter… dans la section Pré-requis.
4Saisissez le libellé du pré-requis dans le champ libellé.
5Sélectionnez le niveau du pré-requis dans le menu local Niveau.
6Sélectionnez sysctl dans le menu local en haut à gauche de la section Spécification.
7Saisissez l'identifiant du sysctl dans le champ ou sélectionnez un identifiant dans le menu local.

Note : La liste complète des identifiants sysctl peut être obtenue en exécutant la commande sysctl -a dans le Terminal.

8Sélectionnez la fonction de comparaison dans le menu local comparateur.
9Saisissez la valeur de comparaison dans le champ en bas à droite de la section Spécification.
10Saisissez le titre de l'alerte dans le champ Titre.
11Saisissez le message de l'alerte dans le champ Message.
12Cliquez sur le bouton OK.

Pour ajouter un pré-requis de type Bundle :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Cliquez sur le bouton Ajouter… dans la section Pré-requis.
4Saisissez le libellé du pré-requis dans le champ libellé.
5Sélectionnez le niveau du pré-requis dans le menu local Niveau.
6Sélectionnez Bundle dans le menu local en haut à gauche de la section Spécification.
7Sélectionnez "n'existe pas" dans le menu local situation pour tester l'absence du bundle ou "situé" pour vérifier la valeur d'une des clés du fichier Info.plist du bundle.
8Saisissez le chemin absolu du bundle dans le champ emplacement et passez à l'étape 12 si vous avez sélectionné "n'existe pas".
9Sélectionnez la clé du fichier Info.plist dont la valeur doit être comparée dans le menu local clé.
10Sélectionnez la fonction de comparaison dans le menu local comparateur.
11Saisissez la valeur de comparaison dans le champ en bas à droite de la section Spécification.
12Saisissez le titre de l'alerte dans le champ Titre.
13Saisissez le message de l'alerte dans le champ Message.
14Cliquez sur le bouton OK.

Pour ajouter un pré-requis de type Fichier :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Cliquez sur le bouton Ajouter… dans la section Pré-requis.
4Saisissez le libellé du pré-requis dans le champ libellé.
5Sélectionnez le niveau du pré-requis dans le menu local Niveau.
6Sélectionnez Fichier dans le menu local en haut à gauche de la section Spécification.
7Sélectionnez "n'existe pas" dans le menu local situation pour tester l'absence du fochier ou "situé" pour vérifier la valeur d'un des attributs du fichier.
8Saisissez le chemin absolu du fichier dans le champ emplacement et passez à l'étape 12 si vous avez sélectionné "n'existe pas".
9Sélectionnez l'attribut du fichier dont la valeur doit être comparée dans le menu local attribut.
10Sélectionnez la fonction de comparaison dans le menu local comparateur.
11Saisissez la valeur de comparaison dans le champ en bas à droite de la section Spécification.
12Saisissez le titre de l'alerte dans le champ Titre.
13Saisissez le message de l'alerte dans le champ Message.
14Cliquez sur le bouton OK.

Pour ajouter un pré-requis de type Property List :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Cliquez sur le bouton Ajouter… dans la section Pré-requis.
4Saisissez le libellé du pré-requis dans le champ libellé.
5Sélectionnez le niveau du pré-requis dans le menu local Niveau.
6Sélectionnez Property List dans le menu local en haut à gauche de la section Spécification.
8Saisissez le chemin absolu du fichier Property List dans le champ emplacement.
9Sélectionnez le type de la valeur associée à la clé dans le menu local type.
10Sélectionnez la clé du fichier Property List dont la valeur doit être comparée dans le menu local clé.
10Sélectionnez la fonction de comparaison dans le menu local comparateur.
11Saisissez la valeur de comparaison dans le champ en bas à droite de la section Spécification.
12Saisissez le titre de l'alerte dans le champ Titre.
13Saisissez le message de l'alerte dans le champ Message.
14Cliquez sur le bouton OK.

Pour ajouter une localisation de l'alerte :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Sélectionnez le pré-requis dans liste de la section Pré-requis.
4Cliquez sur le bouton Éditer… dans la section Pré-requis.
5Cliquez sur le menu local localisation de la section Dialogue d'alerte et choisissez Ajouter une localisation… .
6Tapez le nom de la localisation (en Anglais) et cliquez sur Ajouter.
7Saisissez le titre localisé de l'alerte dans le champ Titre.
8Saisissez le message localisé de l'alerte dans le champ Message.
9Cliquez sur le bouton OK.

Pour modifier une localisation de l'alerte :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Sélectionnez le pré-requis dans liste de la section Pré-requis.
4Cliquez sur le bouton Éditer… dans la section Pré-requis.
5Cliquez sur le menu local localisation de la section Dialogue d'alerte et choisissez la localisation que vous souhaitez modifier.
6Modifiez le titre ou message de l'alerte.
7Cliquez sur le bouton OK.

Pour supprimer une localisation de l'alerte :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Sélectionnez le pré-requis dans liste de la section Pré-requis.
4Cliquez sur le bouton Éditer… dans la section Pré-requis.
5Cliquez sur le menu local localisation de la section Dialogue d'alerte et choisissez la localisation que vous souhaitez supprimer.
6Cliquez sur le menu local localisation de la section Dialogue d'alerte et choisissez Supprimer… .
7Cliquez sur le bouton Supprimer.
8Cliquez sur le bouton OK.

Définition des script d'installation

Par défaut, lorsque vous installez un composant, aucune opération n'est effectuée avant et après l'installation des fichiers. Si vous le souhaitez, vous pouvez définir des scripts (shell ou perl par exemple) qui seront exécutés avant ou après l'installation.

Voici les six types de scripts que vous pouvez définir :

Important : Les scripts InstallationCheck et VolumeCheck ne sont pas gérés par la section Scripts d'installation. Si vous souhaitez utiliser un script InstallationCheck et/ou VolumeCheck, utilisez la section Ressources additionnelles.

Pour ajouter un script d'installation :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Sélectionnez le type de script que vous souhaitez ajouter dans la liste de la section Scripts d'installation.
4Cliquez sur le bouton Choisir… de la section Scripts d'installation.
5Sélectionnez le fichier de script que vous souhaitez utiliser et cliquez sur le bouton Choisir.

Note : Par défaut, la référence au fichier script est un chemin absolu. Vous pouvez basculer vers un chemin relatif au projet en utilisant le menu local du champ d'édition.

6Cochez la boîte à cocher dans la colonne Adhésion (•) pour le type de script que vous avez choisi.

Pour activer ou désactiver un script d'installation :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Sélectionnez le type de script que vous souhaitez activer ou désactiver.
4Cochez ou décochez la boîte à cocher dans la colonne Adhésion (•).

Ajout de ressources complémentaires

Si vous souhaitez utiliser un script InstallationCheck ou VolumeCheck ou bien si un des scripts d'installation requiert des fichiers additionnels, vous pouvez les ajouter dans la liste des ressources additionnelles. Par défaut, les ressources sont ajoutées directement dans le dossier Resources du composant final. Si vous le souhaitez, vous pouvez définir des ressources localisées.

Note : Si vous souhaitez utiliser un script InstallationCheck et/ou VolumeCheck, ajoutez-le(s) dans les Ressources de la localisation Internationale. Les permissions de ce(s) script(s) seront vérifiées et modifiées si nécessaire lors de la construction du composant.

Pour ajouter une ressource additionnelle :
1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
4Cliquez sur le bouton Ajouter… de la section Ressources Additionnelles.
5Sélectionnez le(s) fichier(s) ou dossier(s) que vous souhaitez ajouter et cliquez sur le bouton Ajouter.

Note : Par défaut, les références des éléments sont des chemins absolus. Vous pouvez basculer vers un chemin relatif au projet en utilisant le menu local de la colonne Référence.

Pour supprimer une ressource additionnelle :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
2Sélectionnez la ou les ressources additionnelles que vous souhaitez supprimer dans la liste de la section Ressources Additionnelles.
4Cliquez sur le bouton Supprimer… de la section Ressources Additionnelles.
5Cliquez sur le bouton Supprimer.

Note : Les fichiers et dossiers référencés ne sont pas supprimé du disque, seules les références à ces éléments sont supprimées.

Pour activer ou désactiver une ressource additionnelle :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
2Sélectionnez la ressource additionnelle que vous souhaitez activer ou désactiver dans la liste de la section Ressources Additionnelles.
4Cliquez sur la boîte à cochez de la colonne Adhésion.

Pour ajouter une localisation de ressources :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Cliquez sur le menu local localisation de la section Ressources Additionnelles et choisissez Ajouter une localisation… .
4Tapez le nom de la localisation (en Anglais) et cliquez sur Ajouter.

Pour supprimer une localisation de ressources :

1Sélectionnez le composant dans la colonne Packages et metapackages.
2Choisissez Vue > Scripts.
3Cliquez sur le menu local localisation de la section Ressources Additionnelles et choisissez la langue de la localisation que vous souhaitez supprimer.
4Cliquez sur le menu local localisation de la section Ressources Additionnelles et choisissez Supprimer… .
5

Cliquez sur Supprimer

Note : Les fichiers et dossiers référencés ne sont pas supprimé du disque, seules les références à ces éléments sont supprimées.


Auteur : Stéphane Sudre