Ce document décrit le format des documents de l'application Iceberg.

Un document Iceberg est un fichier Property List. Son contenu peut être édité sans Iceberg, avec un éditeur de texte ou bien l'application PropertyList Editor.app. Un document Iceberg est globalement architecturé comme la liste Package et metapackages.

Le premier niveau de la hiérarchie décrit l'objet Projet.

Le jeton Name est pour le moment uniquement utilisé pour avoir un nom pour l'objet racine de la hiérarchie des packages et metapackages.

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Hierarchy</key> <dict> </dict> <key>Name</key> <string>Project</string> <key>Settings</key> <dict> </dict> </dict> </plist>

Clé Type Valeur par défaut Description Hierarchy Dictionnaire Décrit ci-dessous Hiérarchie des packages et metapackages Name Chaîne de caractères "Project" Nom de l'objet Projet Settings Dictionnaire Décrit ci-dessous Règlages du projet

Ce dictionnaire contient les réglages du projet. Ils peuvent être édités avec le panneau Configuration.

N/A

<key>10.1 Compatibility</key> <true/> <key>Build Path</key> <string>build</string> <key>Build Path Type</key> <integer>2</integer> <key>Comment</key> <string></string> <key>Remove .DS_Store</key> <true/> <key>Remove .pbdevelopment</key> <true/> <key>Remove CVS</key> <false/>

Clé Type Valeur par défaut Description 10.1 Compatibility Nombre true Construit des composants pouvant être installés sur 10.1 et antérieur Build Path Chaîne de caractères "build" Emplacement où sera construit le projet Build Path Type Nombre N/A Type de chemin : 1 Chemin absolu 2 Chemin relatif au projet Comment Chaîne de caractères "" Note utilisateur sur le projet Remove .DS_Store Nombre true Retire tous les fichiers .DS_Store de l'archive pax Remove .pbdevelopment Nombre true Retire tous les fichiers .pbdevelopment de l'archive pax Remove CVS Nombre false Retire tous les dossiers CVS de l'archive pax

Ce dictionnaire décrit soit un package soit un metapackage. L'élément racine de la hiérarchie de projet est aussi un composant.

• Le statut du composant permet de savoir si le composant doit être construit ou non.
• La valeur IFPkgFlagPackageSelection est utilisé pour connaître l'état par défaut du composant en mode d'installation personnalisée. Elle peut être ignoré si le drapeau IFPkgFlagIsRequired est actif.

<key>Attributes</key> <dict> </dict> <key>IFPkgFlagPackageSelection</key> <integer>0</integer> <key>Name</key> <string>Iceberg</string> <key>Status</key> <integer>1</integer> <key>Type</key> <integer>1</integer>

Clé Type Valeur par défaut Description Attributes Dictionnaire Décrit ci-dessous Attributs du composant IFPkgFlagPackageSelection Nombre N/A Mode de sélection du composant : -1 Unselected 0 Selected 1 Required Name Chaîne de caractères "untitled component" Nom du composant Status Nombre 1 Statut du composant : 0 Unselected 1 Selected Type Nombre N/A Type de composant : 0 Metapackage 1 Package

Component > Attributes

Ce dictionnaire décrit les attributs d'un composant.

Deux modès d'attributs sont utilisés pour chaque type de composant :

• Les metapackages ne contiennent pas d'objet Files.
• Les packages ne contiennent pas d'objet Components.

Package

<key>Files</key> <dict> </dict> <key>Documents</key> <dict> </dict> <key>Scripts</key> <dict> </dict> <key>Plugins</key> <dict> </dict> <key>Settings</key> <dict> </dict>

<key>Components</key>
<dict>
</dict>
<key>Documents</key>
<dict>
</dict>
<key>Scripts</key>
<dict>
</dict>
<key>Plugins</key>
<dict>
</dict>
<key>Settings</key>
<dict>
</dict>

Clé Type Valeur par défaut Description Components Table Described above Liste des composants du metapackage Files Table Décrit ci-dessous Fichiers installés par le package Documents Dictionnaire Décrit ci-dessous Documents attachés au composant Scripts Dictionnaire Décrit ci-dessous Scripts et resources additionnelles du composant Plugins Dictionnaire Décrit ci-dessous Plugins Installer du composant Settings Dictionnaire Décrit ci-dessous Règlage du composant

Component > Attributes > Files

Ce dictionnaire décrit les fichiers qui seront présent dans l'archive du package et les options utilisées pour créer cette même archive.

Le jeton IFPkgFlagDefaultLocation doit pointer sur un dossier de la hiérarchie de fichier quand le package n'est pas un package qui a été importé
L'opération de split est réalisée par l'outil /Developer/Tools/SplitForks.

<key>Compress</key> <true/> <key>Hierarchy</key> <dict> </dict> <key>IFPkgFlagDefaultLocation</key> <string>/</string> <key>Imported Package</key> <false/> <key>Package Path</key> <string></string> <key>Split Forks</key> <true/>

Clé Type Valeur par défaut Description Compress Nombre true Compresser l'archive pax en gzip Hierarchy Dictionnaire Décrit ci-dessous Hiérarchie des fichiers à installer IFPkgFlagDefaultLocation Chaîne de caractères "/" Destination par défaut de l'installation Imported Package Nombre false Le package a-t'il été importé ? Package Path Chaîne de caractères "" Emplacement du package importé Split Forks Nombre true Sérer les data forks et resource forks si nécessaire

Component > Attributes > Files > File Item

Ce dictionnaire décrit un objet de la hiérarchie des fichiers.

• Un dossier standard ne peut pas être supprimé de la hiérarchie. Il correspond à un dossier de la hiérarchie de fichiers de Mac OS X. Les dossiers standards sont utilisés dans les modèles de projet pour que les permissions soient correctes sur ces dossiers./LI>
• Un dossier personnalisé est un dossier créé par l'utilisateur. Il n'existe pas sur disque.
• Un fichier réel pointe vers un fichier ou dossier sur disque. Si un fichier réel est absent, la construction du package échouera.

<key>Children</key> <array/> <key>GID</key> <integer>80</integer> <key>Path</key> <string>Utilities</string> <key>Path Type</key> <integer>0</integer> <key>Privileges</key> <integer>509</integer> <key>Type</key> <integer>1</integer> <key>UID</key> <integer>0</integer>

Clé Type Valeur par défaut Description Children Table N/A Liste des éléments contenus par l'élément GID Nombre GID of the parent folder Identifiant de groupe de l'élément Path Chaîne de caractères N/A Nom ou chemin de l'élément Path Type Nombre N/A Type de chemin de fichier : 0 Nom de dossier 1 Chemin absolu 2 Chemin relatif au projet Privileges Nombre N/A Permission Unix de l'élément Type Nombre N/A Type d'élément : 1 Dossier Standard 2 Dossier personnalisé 3 Fichier réel UID Nombre N/A Identifiant d'utilisateur de l'élément Search Rules Table No value Règle de recherche de l'élément

Component > Attributes > Files > File Item > Search Rule

Ce dictionnaire décrit une règle de recherche d'un élément du système de fichier.

Les règles de recherche sont utilisées pour construire le fichier TokenDefinitions.plist et le tableau IFPkgPathMappings du fichier Info.plist. Les règles de recherche permettent de localiser l'emplacement d'une ancienne version d'un fichier ou bundle.

<key>Status</key> <true/> <key>Name</key> <string>Untitled Rule</string> <key>Settings</key> <dict> </dict>

Clé Type Valeur par défaut Description Status Boolean true Statut de la règle Name Chaîne de caractères Untitled Rule Nom de la règle Settings Dictionnaire Describe below Règlages de la règle

Component > Attributes > Files > File Item > Search Rule > Settings

Ce dictionnaire décrit les règlages d'une r`gle de recherche.

Il existe cinq types de règles :

• CheckPath
• CommonAppSearch
• LaunchServicesLookup
• BundleIdentifierSearch
• BundleVersionFilter

Voir la documentation Apple.

Clé Type Valeur par défaut Description searchPlugin Chaîne de caractères CheckPath Type de règle ... ... ... Clés/valeurs qui dépendent du type de règle

Component > Attributes > Documents

Ce dictionnaire décrit tous les documents utilisés pour personnaliser le Programme d'installation quand le composant est installé.

N/A

<key>Background Image</key> <dict> </dict> <key>License</key> <dict> </dict> <key>ReadMe</key> <dict> </dict> <key>Welcome</key> <dict> </dict>

Clé Type Valeur par défaut Description Background Image Dictionnaire Décrit ci-dessous Information sur l'image de fond License Dictionnaire Décrit ci-dessous Liste de licences utilisateurs localisées ReadMe Dictionnaire Décrit ci-dessous Lise de messages Ouvrez-moi localisés Welcome Dictionnaire Décrit ci-dessous Lise de messages d'introduction localisés

Component > Attributes > Documents > Background Image

Ce dictionnaire décrit si et comment une image de fond personnalisée sera affichée par le Programme d'installation quand le composant est installé.

L'image de fond personnalisée ne sera affichée que si le composant est le composant racine du projet.

<key>IFPkgFlagBackgroundAlignment</key> <integer>4</integer> <key>IFPkgFlagBackgroundScaling</key> <integer>1</integer> <key>Mode</key> <integer>0</integer> <key>Path</key> <string></string> <key>Path Type</key> <integer>1</integer>

Clé Type Valeur par défaut Description IFPkgFlagBackgroundAlignment Nombre 4 Alignement : 0 Centré 1 En haut 2 En haut à gauche 3 En haut à droite 4 À gauche 5 En bas 6 En bas à gauche 7 En bas à droite 8 À droite IFPkgFlagBackgroundScaling Nombre 1 Mise à l'échelle : 0 Proportionnelle 1 Remplir 2 Aucun Mode Nombre 0 Statut : 0 Pas d'image personnalisée 1 Afficher l'image Path Chaîne de caractères "" Chemin de l'image Path Type Nombre N/A Type de chemin : 1 Chemin absolu 2 Chemin relatif au projet

Component > Attributes > Documents > License

Ce dictionnaire décrit si et quelle licence utilisateur doit être proposée à l'utilisateur quand le composant est installé.

Les licences ne seront affichés que si le composant est le composant racine du projet.

<key>International</key> <dict> <key>Keywords</key> <dict/> <key>Mode</key> <integer>0</integer> <key>Path</key> <string></string> <key>Path Type</key> <integer>1</integer> <key>Template</key> <string></string> </dict>

Clé Type Valeur par défaut Description Keywords Dictionnaire Empty Dictionnaire de clés/valeurs à utiliser pour le modèle de licence Mode Nombre 0 Statut : 0 Pas de licence utilisateur 1 Afficher une licence utilisateur personnalisée 2 Afficher une licence utilisateur à partir d'un modèle Path Chaîne de caractères "" Chemin de la licence Path Type Nombre N/A Type de chemin : 1 Chemin absolu 2 Chemin relatif au projet Template Chaîne de caractères "" Nom du modèle de licence

Component > Attributes > Documents > ReadMe

Ce dictionnaire décrit si un message Ouvrez-moi personnalisé doit être affiché ou non.

Le message Ouvrez-moi ne sera affiché que si le composant n'est pas un sous-composant d'un metapackage.

<key>International</key> <dict> <key>Mode</key> <integer>0</integer> <key>Path</key> <string></string> <key>Path Type</key> <integer>1</integer> </dict>

Clé Type Valeur par défaut Description Mode Nombre 0 Statut : 0 Pas de message 1 Afficher le message Ouvrez-moi Path Chaîne de caractères "" Chemin du message Ouvre-moi Path Type Nombre N/A Type de chemin : 1 Chemin absolu 2 Chemin relatif au projet

Component > Attributes > Documents > Welcome

Ce dictionnaire décrit si un message d'introduction personnalisé doit être affiché ou si celui par défaut doit être utilisé.

Le message d'introduction ne sera affiché que si le composant n'est pas un sous-composant d'un metapackage.

<key>International</key> <dict> <key>Mode</key> <integer>0</integer> <key>Path</key> <string></string> <key>Path Type</key> <integer>1</integer> </dict>

Clé Type Valeur par défaut Description Mode Nombre 0 Statut : 0 Message d'introduction par défaut 1 Afficher le message personnalisé Path Chaîne de caractères "" Chemin du message d'introduction Path Type Nombre N/A Type de chemin : 1 Chemin absolu 2 Chemin relatif au projet

Component > Attributes > Plugins

Ce dictionnaire décrit les plugins qui seront utilisés pour personnaliser le processus d'installation.

Les Plugins ne sont pas utilisés par Installer.app sur les versions de Mac OS X antérieures à Mac OS X 10.4.

<dict> <key>PluginsList</key> <array> <dict> <key>Path</key> <string>Introduction</string> <key>Type</key> <integer>0</integer> </dict> <dict> <key>Path</key> <string>/This/is/a/path</string> <key>Path Type</key> <integer>2</integer> <key>Status</key> <true/> <key>Type</key> <integer>1</integer> </dict> <dict> <key>Path</key> <string>ReadMe</string> <key>Type</key> <integer>0</integer> </dict> <dict> <key>Path</key> <string>License</string> <key>Type</key> <integer>0</integer> </dict> <dict> <key>Path</key> <string>Target</string> <key>Type</key> <integer>0</integer> </dict> <dict> <key>Path</key> <string>PackageSelection</string> <key>Type</key> <integer>0</integer> </dict> <dict> <key>Path</key> <string>Install</string> <key>Type</key> <integer>0</integer> </dict> <dict> <key>Path</key> <string>FinishUp</string> <key>Type</key> <integer>0</integer> </dict> </array> </dict>

Clé Type Valeur par défaut Description Type Nombre 0 Type de plugin : 0 Plugin Standard 1 Plugin personnalisé Path Chaîne de caractères Chemin du plugin à ajouter Path Type Nombre N/A Type de chemin : 1 Chemin absolu 2 Chemin relatif au projet Status Nombre Vrai si le plugin doit être ajouté, faux autrement.

Component > Attributes > Scripts

Ce dictionnaire décrit les scripts qui vont être utilisés pour personnaliser le processus d'installation et les ressources additionnelles nécessaires à cela.

Les pré-requis d'installation ne sont supportés qu'à partir de Mac OS X 10.3.

Package

<dict> <key>Additional Resources</key> <dict> </dict> <key>Installation Scripts</key> <dict> </dict> <key>Requirements</key> <array> </array> </dict> /PRE>

Clé Type Valeur par défaut Description Additional Resources Dictionnaire Décrit ci-dessous Ressources additionnelles du composant Installation Scripts Dictionnaire Décrit ci-dessous Scripts à lancer durant l'installation Requirements Table Décrit ci-dessous Pré-requis du composant

Component > Attributes > Scripts > Additional Resources

Ce dictionnaire décrit les ressources additionnelles qui seront ajoutées dans le dossier Resources du composant.

C'est ici que vous devez ajouter les scripts VolumeCheck ou InstallationCheck si nécessaire.

<key>International</key> <array> <dict> <key>Path</key> <string>/Users/stephane/Desktop/SomeFile.txt</string> <key>Path Type</key> <integer>1</integer> <key>Status</key> <true/> </dict> </array>

Clé Type Valeur par défaut Description Path Chaîne de caractères Chemin du fichier ou dossier Path Type Nombre N/A Type de chemin : 1 Chemin absolu 2 Chemin relatif au projet Status Nombre Vrai si doit être ajouté, faux autrement.

Component > Attributes > Scripts > Installation Scripts

Ce dictionnaire décrit les scripts d'installation à ajouter au composant.

Les scripts InstallationCheck et VolumeCheck ne sont pas gérés par ce dictionnaire. Si vous souhaitez les utiliser, il faudra les ajouter en tant que ressources internationales additionnelles.

<key>IFInstallationScriptsPostflight</key> <dict> <key>Path</key> <string></string> <key>Path Type</key> <integer>1</integer> <key>Status</key> <false/> </dict> <key>IFInstallationScriptsPostinstall</key> <dict> <key>Path</key> <string></string> <key>Path Type</key> <integer>1</integer> <key>Status</key> <false/> </dict> <key>IFInstallationScriptsPostupgrade</key> <dict> <key>Path</key> <string></string> <key>Path Type</key> <integer>1</integer> <key>Status</key> <false/> </dict> <key>IFInstallationScriptsPreflight</key> <dict> <key>Path</key> <string></string> <key>Path Type</key> <integer>1</integer> <key>Status</key> <false/> </dict> <key>IFInstallationScriptsPreinstall</key> <dict> <key>Path</key> <string></string> <key>Path Type</key> <integer>1</integer> <key>Status</key> <false/> </dict> <key>IFInstallationScriptsPreupgrade</key> <dict> <key>Path</key> <string></string> <key>Path Type</key> <integer>1</integer> <key>Status</key> <false/> </dict>

Clé Type Valeur par défaut Description Path Chaîne de caractères "" Chemin du script Path Type Nombre N/A Type de chemin : 1 Chemin absolu 2 Chemin relatif au projet Status Nombre false Vrai si le script doit être utilisé, faux autrement

Component > Attributes > Scripts > Requirements

Ce dictionnaire décrit les pré-requis d'installation du composant.

Les pré-requis d'installation ne sont supportés qu'à partir de Mac OS X 10.3.

<dict> <key>AlertDialog</key> <dict> <key>International</key> <dict> <key>MessageKey</key> <string>Version is too old</string> <key>TitleKey</key> <string>Incorrect version</string> </dict> </dict> <key>LabelKey</key> <string>Sample requirement</string> <key>Level</key> <integer>0</integer> <key>SpecArgument</key> <string>fr.whitebox.pkg.iceberg</string> <key>SpecProperty</key> <string>IFMajorVersion</string> <key>SpecTag</key> <integer>4</integer> <key>SpecType</key> <string>package</string> <key>Status</key> <true/> <key>TestObject</key> <integer>10</integer> <key>TestOperator</key> <string>>=</string> </dict>

Clé Type Valeur par défaut Description AlertDialog Dictionnaire Dictionnaire de chaîne de messages MessageKey Chaîne de caractères "" Message du dialogue d'alerte TitleKey Chaîne de caractères "" Titre du dialogue d'alerte LabelKey Chaîne de caractères "untitled requirement" Brève description du pré-requis Level Nombre 0 Niveau de pré-requis: 0 requis 1 recommandé SpecArgument Chaîne de caractères "" Argument de la spécification SpecProperty Chaîne de caractères Proprié de la spécification SpecTag Chaîne de caractères 4 Tag de spécification : 4 package 2 gestalt 0 bundle 5 plist 1 file SpecType Chaîne de caractères "package" Type de spécification : package gestalt bundle plist file Status Nombre true Statu du pré-requis: vrai ou faux TestObject Chaîne de caractères "" Objet de référence TestOperator Chaîne de caractères >= Opérateur de comparaison

Component > Attributes > Settings

Ce dictionnaire décrit les règlages des composants.

Il y'a deux formats possibles selon qu'il s'agisse d'un package ou d'un metapackage. Les metapackages n'ont pas d'Options.

Package

<key>Description</key> <dict> </dict> <key>Display Information</key> <dict> </dict> <key>Options</key> <dict> </dict> <key>Version</key> <dict> </dict>

<key>Description</key>
<dict>
</dict>
<key>Display Information</key>
<dict>
</dict>
<key>Version</key>
<dict>
</dict>

Clé Type Valeur par défaut Description Description Dictionnaire Décrit ci-dessous Description du composant Display Information Dictionnaire Décrit ci-dessous Liste d'informations localisées Options Dictionnaire Décrit ci-dessous Options du package Version Dictionnaire Décrit ci-dessous version du composant

Component > Attributes > Settings > Description

Ce dictionnaire est utilisé pour construire les fichiers .info et Description.plist du composant.

Les informations IFPkgDescriptionVersion et IFPkgDescriptionDeleteWarning ne sont pas utilisées par le Programme d'installation.

<key>International</key> <dict> <key>IFPkgDescriptionDeleteWarning</key> <string></string> <key>IFPkgDescriptionDescription</key> <string></string> <key>IFPkgDescriptionTitle</key> <string>Iceberg</string> <key>IFPkgDescriptionVersion</key> <string>1.0</string> </dict>

Clé Type Valeur par défaut Description IFPkgDescriptionDeleteWarning Chaîne de caractères "" Non utilisée IFPkgDescriptionDescription Chaîne de caractères "" Brève description du composant affichée en mode d'installation personnalisée IFPkgDescriptionTitle Chaîne de caractères Nom du composant IFPkgDescriptionVersion Chaîne de caractères "1.0" Non utilisée

Component > Attributes > Settings > Display Information

Ce dictionnaire décrit les informations affichées par le Finder dans la fenêtre Information et dans les fenêtres du Finder.

N/A

<key>CFBundleGetInfoString</key> <string>Iceberg 1.0 Copyrights (c) 2004 Stéphane Sudre</string> <key>CFBundleIdentifier</key> <string>fr.whitebox.pkg.Iceberg</string> <key>CFBundleName</key> <string>Iceberg</string> <key>CFBundleShortVersionString</key> <string>1.0</string> <key>CFBundleIconFile</key> <string></string> <key>CFBundleIconFile Path Type</key> <integer><1/integer>

Clé Type Valeur par défaut Description CFBundleGetInfoString Chaîne de caractères "%%PROJECT_NAME%% 1.0 Copyrights (c) %%YEAR%%" chaîne d'information du Finder CFBundleIdentifier Chaîne de caractères "%%COMPANY_PACKAGE_IDENTIFIER%%.%%PROJECT_NAME%%" Identifiant de bundle CFBundleName Chaîne de caractères Component name Nom du bundle CFBundleShortVersionString Chaîne de caractères "1.0" Version du bundle CFBundleIconFile Chaîne de caractères "" Chemin vers le fichier icône (.icns) CFBundleIconFile Path Type Nombre N/A Type de chemin : 1 Chemin absolu 2 Chemin raltif au projet

Component > Attributes > Settings > Options

Ce dictionnaire décrit les options d'un package.

Certaines options ne sont pas supportées par Mac OS X 10.1. Iceberg fera de son mieux pour positionner les valeurs les plus adéquates pour le format 10.1.

<key>IFPkgFlagAllowBackRev</key> <false/> <key>IFPkgFlagAuthorizationAction</key> <integer>2</integer> <key>IFPkgFlagFollowLinks</key> <false/> <key>IFPkgFlagInstallFat</key> <false/> <key>IFPkgFlagIsRequired</key> <false/> <key>IFPkgFlagOverwritePermissions</key> <false/> <key>IFPkgFlagRelocatable</key> <false/> <key>IFPkgFlagRestartAction</key> <integer>0</integer> <key>IFPkgFlagRootVolumeOnly</key> <true/> <key>IFPkgFlagUpdateInstalledLanguages</key> <false/>

Clé Type Valeur par défaut Description IFPkgFlagAllowBackRev Nombre false Autoriser le retour en arrière. IFPkgFlagAuthorizationAction Nombre 0 Authorisation requise pour réaliser l'installation : 0 Aucune autorisation requise 1 Autorisation Administrateur 2 Autorisation root IFPkgFlagFollowLinks Nombre false Suivre les liens symboliques IFPkgFlagInstallFat Nombre false Installation Fat des binaires IFPkgFlagIsRequired Nombre false Requis. IFPkgFlagOverwritePermissions Nombre false Supplanter les permissions des répertoires IFPkgFlagRelocatable Nombre false Délocalisable IFPkgFlagRestartAction Nombre 0 Comportement aprè le succès de l'installation : 0 Pas de redémarrage 1 Redémarrage recommandé 2 Redémarrage requis 3 Extinction requise 4 Logout requis IFPkgFlagRootVolumeOnly Nombre false Volume de boot uniquement IFPkgFlagUpdateInstalledLanguages Nombre false Mettre à jour uniquement les langues installées

Component > Attributes > Settings > Version

Ce dictionnaire décrit la version majeures et mineure d'un composant.

N/A

<key>IFMajorVersion</key> <integer>1</integer> <key>IFMinorVersion</key> <integer>0</integer>

Clé Type Valeur par défaut Description IFMajorVersion Nombre 1 Version majeure IFMinorVersion Nombre 0 Version mineure