Attributs de l'installation

4.8 Attributs de l'installation

4.8.1 Attributs généraux

Les commandes ci-dessous vous toutes ajuster des attributs de l'installation. Ces attributs contrôlent l'apparence et les fonctions de l'installation, ceci incluant autant les pages affichées durant l'installation que les textes affichés dans chaque partie de chaque page, le nom de l'installation, l'icône utilisée, le répertoire d'installation par défaut, le fichier généré, et bien plus. Notez que ces attributs peuvent être définis n'importe ou dans le fichier, exception faite dans une Fonction ou bien dans une Section. A l'exception de InstallDir, aucun de ces attributs n'autorisent l'utilisation de variables autres que $\r et $\n dans leur valeurs.

Les valeurs par défaut sont en gras

4.8.1.1 AddBrandingImage

(gauche|droite|haut|bas) (largeur|hauteur) [décalage]

Ajoute une image de marque en haut, en bas, à gauche, à droite dans l'installation. Sa taille est fixée suivant la largeur/hauteur spécifiée, la largeur/hauteur de l'installation et la police utilisée. La taille finale ne sera pas toujours celle que vous aurez demandée. Jetez un œil au résultat pour connaitre la taille utilisée. Comme cela dépend de la police, vous devriez utiliser SetFont avant AddBrandingImage. La valeur par défaut du décalage est 2.

AddBrandingImage n'ajoute qu'une marque pour une image. Pour éfinir l'image elle même au démarrage, utilisez SetBrandingImage.

AddBrandingImage left 100
AddBrandingImage right 50
AddBrandingImage top 20

4.8.1.2 AllowRootDirInstall

true|false

Contrôle si les installations sont autorisées dans le répertoire racine d'un lecteur, ou directement dans un dossier réseau. Définissez-le en 'true' (vrai) pour modifier le comportement par défaut (sans risque), qui empêche les utilisateurs de sélectionner C:\ ou \\serveur\partage comme dossier d'installation (et plus tard, de désinstallation). Pour personnaliser plus en détails la page de sélection du répertoire, voir .onVerifyInstDir.

4.8.1.3 AutoCloseWindow

true|false

Définit si oui ou non la fenêtre d'installation se ferme automatiquement à la fin de l'installation. Peut être 'false' (faux) ou 'true' (vrai). C'est modifiable dans une section en utilisant SetAutoClose.

4.8.1.4 BGFont

[type_police [hauteur [largeur] [/ITALIC] [/UNDERLINE] [/STRIKE]]]

Spécifie la police utilisée pour afficher le texte en arrière-plan. Pour définir la couleur utilisez BGGradient. Si aucun paramètre n'est spécifié, la police par défaut sera utilisée. La police par défaut est Times New Roman gras et italique.

4.8.1.5 BGGradient

[off|(couleur_haut couleur_bas [couleur_texte|notext])]

Spécifie si l'on utilise ou pas une fenêtre dégradée en arrière-plan. Si l'option est en 'off' (désactivée), l'installation n'affichera pas d'arrière-plan, si aucun paramètre n'est spécifié, un dégradé noir vers bleu est utilisé, sinon, les couleur_haut et couleur_bas serviront à constituer le dégradé. Couleur_haut et couleur_bas sont spécifié sous forme RRGGBB (en hexadécimal, comme en HTML, en enlevant le '#' précédant, depuis que # peut être utilisé pour les commentaires). 'couleur_texte' peut être spécifié de la même manière, ou 'notext' (sans texte) peut être spécifié pour désactiver le gros texte mis sur arrière-plan.

4.8.1.6 BrandingText

/TRIM(LEFT|RIGHT|CENTER) texte

Définit le texte affiché (par défaut, 'Nullsoft Install System vX.XX fr') en bas de la fenêtre d'installation. Si vous spécifiez une chaîne vide (""), la valeur par défaut sera utilisée (mais pouvez utiliser " " pour obtenir une chaîne vide). Si cela vous importe peu, laissez la valeur par défaut, afin que tout le monde sache pourquoi l'installation tue. héhé. Utilisez /TRIMLEFT, /TRIMRIGHT ou /TRIMCENTER pour adapter la taille du contrôle à celle de la chaîne.

4.8.1.7 Caption

titre

S'il est utilisé en dehors d'un bloc PageEx, il définit le texte dans la barre de titre de l'installation. Par défaut, il s'agit de 'Installation de Nom', ou Nom est définie par la commande Name. Il est possible de la redéfinir en 'MonApp Installation' ou n'importe quoi. Si vous spécifiez une chaîne vide (""), la valeur par défaut sera utilisée (mais pouvez utiliser " " pour obtenir une chaîne vide).

S'il est utilisé dans un bloc PageEx, il définit le sous-titre de la page courante.

4.8.1.8 ChangeUI

fenêtre fichier_ui.exe

Remplace la fenêtre (IDD_LICENSE, IDD_DIR, IDD_SELCOM, IDD_INST, IDD_INSTFILES, IDD_UNINST ou IDD_VERIFY) par une fenêtre possédant le même ID de ressource dans fichier_ui.exe. Vous pouvez aussi spécifier 'all' comme fenêtre, si vous désirez modifier toutes les fenêtres en une seule fois depuis le même fichier UI. Vous trouverez quelques exemples d'UIs dans le répertoire Contrib\UIs du dossier d'installation de NSIS.

IDD_LICENSE doit contenir IDC_EDIT1 (contrôle RICHEDIT).
IDD_DIR doit contenir IDC_DIR (zone d'édition), IDC_BROWSE (bouton) and IDC_CHECK1 (case à cocher).
IDD_SELCOM doit contenir IDC_TREE1 (contrôle SysTreeView32), et IDC_COMBO1 (liste déroulante).
IDD_INST doit contenir IDC_BACK (bouton), IDC_CHILDRECT (contrôle statique de la taille des dialogues), IDC_VERSTR (statique), IDOK (bouton), and IDCANCEL (bouton). Si un contrôle image (statique avec SS_BITMAP style) est trouvé dans ce dialogue il sera utilisé comme défaut pour SetBrandingImage.
IDD_INSTFILES doit contenir IDC_LIST1 (contrôle SysListView32), IDC_PROGRESS (contrôle msctls_progress32), et IDC_SHOWDETAILS (bouton).
IDD_UNINST doit contenir IDC_EDIT1 (zone d'édition).
IDD_VERIFY doit contenir IDC_STR (static).

ChangeUI all "${NSISDIR}\Contrib\UIs\sdbarker_tiny.exe"

4.8.1.9 CheckBitmap

image.bmp

Défini l'image qui définira chaque état dans l'arborescence des composants.

Cette image doit avoir une taille de 96x16 pixels, pas plus de 8bpp (256 couleurs) et contenir six images en 16x16 pour les différents états (dans l'ordre : masque de sélection, non cochée, cochée, grisée, décochée & lecture-seule, cochée & lecture-seule). Utilisez du magenta comme couleur de masque (cette zone sera transparente).

4.8.1.10 CompletedText

texte_terminer

Remplace le texte par défaut ("Terminer") qui est affiché à la fin de l'installation si le paramètre est spécifié. Sinon, la valeur par défaut est utilisée.

4.8.1.11 ComponentText

[texte] [sous-texte] [sous-texte2]

Utilisé pour modifier le texte par défaut dans la page des composants.

Texte : Texte au dessus des contrôles, à droite de l'icône d'installation.

Sous-texte : Texte près de la sélection du type d'installation.

Sous-texte2 : Texte à gauche de la liste des composants, en dessous des types d'installation.

Le texte par défaut sera utilisé si la chaîne spécifiée est vide ("").

4.8.1.12 CRCCheck

on|off|force

Spécifie si ou pas l'installation doit effectuer un CRC (contrôle d'erreur) sur elle-même avant d'autoriser l'installation. Les options correctes sont 'on' (actif), 'force' (forcer) et 'off' (inactif). Notez que si l'utilisateur utilise /NCRC (sauf si vous utilisez 'force') en ligne de commande lors de l’exécution, le CRC ne s'effectuera pas, et l'utilisateur sera autorisé à utiliser une installation (potentiellement) corrompue.

4.8.1.13 DetailsButtonText

texte_afficher_détails

Remplace le texte du bouton "Détails", si le paramètre est spécifié (sinon, la valeur par défaut est utilisée).

4.8.1.14 DirText

[texte] [sous-texte] [texte_bouton_parcourir] [texte_fenetre_parcourir]

Utilisé pour modifier les textes par défaut sur la page de sélection du répertoire d'installation.

Texte : Texte au-dessus des contrôles, à droite de l'icône d'installation.

Sous-texte : Texte dans la zone de sélection du répertoire.

bouton_parcourir : Texte du bouton "Parcourir...".

texte_fenetre_parcourir : Texte dans la fenêtre "Sélectionner un dossier", apparaissant après avoir cliqué sur le bouton "Parcourir".

Le texte par défaut sera utilisé si la chaîne spécifiée est vide ("").

4.8.1.15 DirVar

variable_utilisateur(répertoire entrée/sortie)

Spécifie quelle variable doit être utilisée pour contenir le répertoire sélectionné. Cette variable doit aussi contenir la valeur par défaut. Cela vous permet de créer facilement deux pages de sélection de répertoires, sans vous demander de gérer la variable $INSTDIR dans tous les sens. Cela ne peut être utilisé que dans une PageEx, ainsi que pour les pages directory et uninstConfirm.

Var ANOTHER_DIR
PageEx directory
  DirVar $ANOTHER_DIR
PageExEnd

Section
  SetOutPath $INSTDIR
  File "a file.dat"
  SetOutPath $ANOTHER_DIR
  File "another file.dat"
SectionEnd

4.8.1.16 DirVerify

auto|leave

Si `DirVerify leave' est utilisé, le bouton Suivant ne sera pas désactivé si le répertoire d'installation n'est pas valide ou bien qu'il n'y a pas suffisamment d'espace libre disponible. Un flag que vous pourrez lire dans la fonction leave en utilisant GetInstDirError sera par contre défini.

PageEx directory
  DirVerify leave
  PageCallbacks "" "" dirLeave
PageExEnd

4.8.1.17 FileErrorText

texte_erreur_fichier

Remplace le texte par défaut, apparaissant lorsque survient une erreur d'écriture dans un fichier. Cette chaîne peut contenir une référence à $0, qui sera le nom du fichier ($0 est temporairement modifié en cette valeur). Exemple: "Tu veux écrire dans le fichier $0 ? $\r$\nTiens, bouffe !".

4.8.1.18 Icon

[path\]icone.ico

Définit l'icône de l'installation. Chaque icône dans le fichier sera inclus dans l'installation. Notez que si vous utilisez des icônes différentes pour l'installation et la désinstallation, les tailles des fichiers et les structures des icônes doivent correspondre ; Dans le cas contraire, la génération échouera.

4.8.1.19 InstallButtonText

texte_bouton_installer

Modifie le texte du bouton qui affiche normalement "Installer". Si aucun paramètre n'est spécifié, le texte par défaut sera utilisé.

4.8.1.20 InstallColors

/windows | (avant-plan arrière-plan)

Défini les couleurs à utiliser pour l'écran d'information (par défaut : 00FF00 000000. Utilisez le modèle RRGGBB (en hexadécimal, comme en HTML, en enlevant le '#' de tête, puisque # peut être utilisé pour les commentaires). Notez que si "/windows" est spécifié comme seul paramètre, les couleurs des fenêtres par défaut seront utilisées.

4.8.1.21 InstallDir

rep_install_defaut

Définit le répertoire d'installation par défaut. Voir la section Variables pour les variables pouvant être utilisée pour faire cette chaîne (et spécialement $PROGRAMFILES). Notez que la partie de cette chaîne suivant le dernier \ sera utilisé si l'utilisateur sélectionne 'Parcourir', et peut être ajouté dans la chaîne au moment de l'installation (pour le désactiver, terminez le nom du répertoire par un \ (ce qui requiert un paramètre entier entre guillemets)). Si cela n'a aucun sens pour vous, jouez un peu avec le bouton Parcourir pour voir !

4.8.1.22 InstallDirRegKey

clé_racine sous-clé clé

Cet attribut indique à l'installation de vérifier l'existence d'une chaîne en registre, et l'utiliser comme répertoire d'installation si celle ci est valide. Si l'attribut est présent, il écrasera l'attribut InstallDir si la clé de la base de registre est valide, sinon, il laissera la valeur d’InstallDir par défaut. Lors de la vérification dans le registre, cette commande enlèvera automatiquement les guillemets. Si la chaîne se termine par ".exe", il enlèvera automatiquement le nom de fichier dans la chaîne(ex. si la chaîne est "C:\program files\poop\poop.exe", il se servira de "C:\program files\poop"). Pour une configuration plus avancée du répertoire d'installation, définissez $INSTDIR dans .onInit.

Les chaines de Langue et variables ne peuvent pas être utilisées avec InstallDirRegKey.

InstallDirRegKey HKLM Software\NSIS ""
InstallDirRegKey HKLM Software\ACME\Thingy InstallLocation

4.8.1.23 InstProgressFlags

[flag [...]]

Les valeurs correctes pour le flag sont "smooth" (adoucir la barre de progression) ou "colored" (colorer la barre de progression avec les couleurs définies par InstallColors). Exemples: "InstProgressFlags" (avec le look de la vielle école Windows), "InstProgressFlags smooth" (nouveau look doux), "InstProgressFlags smooth colored" (un look doux et coloré). Note: ni "smooth", ni "colored" ne fonctionnent avec XPStyle lorsque l'installation fonctionne sous Windows XP avec un thème moderne.

4.8.1.24 InstType

nom_type_install | /NOCUSTOM | /CUSTOMSTRING=texte | /COMPONENTSONLYONCUSTOM

Ajoute une type d'installation dans la liste, ou désactive le type d'installation "Personnalisée". Il peut y avoir jusqu'à 32 types, chacun avec son propre nom. Au lieu d'avoir des noms "définis en dur", vous pouvez utiliser des variables utilisateurs qui seront défini à l'exécution. Cela vous permet de modifier InstType dynamiquement. Un autre moyen de modifier InstType à l'exécution est la commande InstTypeSetText. La différence est que avec InstTypeSetText, vous n'avez pas besoin d'utiliser vos précisues variables utilisateurs. Le premier type est celui par défaut (généralement 'Normale'). Chaque type est numéroté, en commençant par 1. Voir SectionIn pour plus d'informations sur comment ces nombres sont utilisés. Si l'option /NOCUSTOM est spécifiée, alors le type "Personnalisée" sera désactivé, et l'utilisateur devra choisir l'un des types prédéfinis. Ainsi, si l'option /CUSTOMSTRING est spécifié, le paramètre écrasera le texte "Personnalisée". De même, si l'option /COMPONENTSONLYONCUSTOM est spécifiée, la liste des composants ne sera affichée que si le type "Personnalisée" est sélectionné.

4.8.1.25 LicenseBkColor

couleur | /gray | /windows

Définit la couleur d'arrière-plan de la licence. La couleur spécifiée est de la forme RRVVBB (en hexadécimal, ou en HTML avec le '#' de tête en moins, puisque # peut être utilisé pour les commentaires). La valeur par défaut es '/gray'. Vous pouvez aussi utiliser la couleur définie par Windows en utilisant '/windows'.

4.8.1.26 LicenseData

donnees_licence.(txt|rtf)

Spécifie un fichier texte ou RTF qui contiendra la licence que lira l'utilisateur. Omettez-le pour ne pas afficher la licence. Notez que le fichier doit être au format diabolique "Texte MSDOS" (\r\n, super!). Pour définir une licence multilingue, utilisez LicenseLangString.

Si vous créez votre fichier de licence au format RTF, il est recommandé que vous l'éditiez avec WordPad, et non avec MS Word. L'utilisation de WordPad vous permettra d'avoir des fichiers plus légers.

4.8.1.27 LicenseForceSelection

(checkbox [texte_accepter] | radiobuttons [texte_accepter] [décliner] | off)

Spécifie si la licence affichée doit être explicitement acceptée ou pas. Cela peut être fait, soit par l'intermédiaire d'une case à cocher, soit par des boutons radio. Par défaut, le "bouton suivant" est désactivé et ne sera activé que si la case est cochée, ou que le bouton de droite est sélectionné. Si désactivé est spécifié, le "bouton suivant" est activé par défaut.

LicenseForceSelection checkbox
LicenseForceSelection checkbox "j'accepte"
LicenseForceSelection radiobuttons
LicenseForceSelection radiobuttons "j'accepte"
LicenseForceSelection radiobuttons "j'accepte" "je refuse"
LicenseForceSelection radiobuttons "" "je refuse"
LicenseForceSelection off

4.8.1.28 LicenseText

[ texte [texte_bouton]]

Utilisé pour modifier les textes par défaut de la page de la licence.

Texte : Texte au-dessus des contrôles, à droite de l'icône d'installation.

Texte_bouton : Texte du bouton "J'accepte".

Le texte par défaut sera utilisé si la chaîne spécifiée est vide ("").

4.8.1.29 MiscButtonText

[texte_bouton_retour [texte_bouton_suivant] [texte_bouton_annuler] [texte_bouton_fermer]]

Remplace les chaînes par défaut des quatre boutons (< Retour, Suivant >, Annuler et Fermer). Si vous spécifiez une chaîne vide (""), la valeur par défaut sera utilisée (vous pouvez utiliser " " pour obtenir une chaîne vide).

4.8.1.30 Name

nom  [nom_avec_double_et_commerciaux]

Défini le nom de l'installation. Le nom est souvent simplement le nom du produit, tel que 'MonApp' ou 'CrapulSoft MonApp'. Si vous avez plusieurs et commerciaux (&) dans le nom, définissez le second paramètre avec le même nom, avec des et commerciaux doublés. Par exemple, si votre nom de produit est "Mur & Paix", utilisez:

 Name "Mur & Paix" "Mur && Paix"

Si vous avez des et commerciaux dans le nom et utilisez un LangString pour le nom, vous devrez en créer un second avec des et commerciaux doublés à utiliser en second paramètre.

4.8.1.31 OutFile

[chemin\]installation.exe

Spécifie le fichier qui sera utilisé par MakeNSIS pour y créer l'installation. Il s'agit juste du fichier dans lequel MakeNSIS va écrire, sans affecter l'installation en elle-même.

4.8.1.32 RequestExecutionLevel

none|user|highest|admin

Spécifie le niveau d'exécution demandé pour Windows Vista. La valeur est embarquée dans le manifeste xml et dit à Vista, et probablement aux futures versions de Windows, quelles privilèges l'installateur ou le désinstallateur requière. user demande le niveau utilisateur actuel sans privilèges administratifs. highest demandera le plus haut niveau d'exécution disponible pour l'utilisateur courant et fera que Windows demandera à l'utilisateur de vérifier l'élévation des privilèges. La demande pourra nécessiter un mot de passe. admin demande le niveau administrateur et fera que Windows demandera un mot de passe pour vérifier l'élèvement des privilèges. Spécifier none, qui est le défaut, laissera le manifeste vide et laisera Windows décider quel niveau d'exécution est requis. Windows Vista identifie automatiquement les installateurs NSIS et décide que les privilèges administrateur sont requis. De ce fait, none et admin ont virtuellement le même effet.

Il est recommandé, au moins par Microsoft, que toute application soit marquée avec le niveau d'exécution requis. Les installateurs non marqués sont sujet au mode compatibilité. Le contournement de ce mode inclut le déplacement automatique des raccourcis créés dans le menu démarrer de l'utilisateur vers le menu démarrer de tous les utilisateurs. Les installateurs qui ne requièrent pas d'installer quoi que ce soit dans les dossiers système ou d'écrire dans le registre local machine (HKLM) devraient spécifier le niveau d'exécution user.

Plus d'informations sur ce sujet peuvent être trouvées sur MSDN. Mot clé "UAC", "requested execution level", "vista manifest" et "vista security".

4.8.1.33 SetFont

[/LANG=lang_id] police taille

Définit la police de l'installation. Souvenez-vous que la police choisit devra être présente sur la machine utilisée. N'utilisez pas de police rares que vous êtes les seuls à posséder.

Utilisez le paramètre /LANG si vous souhaitez définir une police différente pour chaque langue. Par exemple:

 SetFont /LANG=${LANG_ENGLISH} "Police anglaise" 9
 SetFont /LANG=${LANG_FRENCH} "Police française" 10

Il y a deux LangStrings nommés ^Font et ^FontSize qui contiennent la police et la taille pour chaque langue.

4.8.1.34 ShowInstDetails

hide|show|nevershow

Définie si les détails de l'installation sont montrés ou pas. Peut être 'hide' (caché), par défaut, pour cacher les détails, autorisant l'utilisateur à pouvoir les afficher, 'show' (affiché) pour les afficher, ou bien 'nevershow' (toujours cachés), pour empêcher l'utilisateur à les voir. Notez que les sections peuvent écraser ce paramètre à l'aide de SetDetailsView.

4.8.1.35 ShowUninstDetails

hide|show|nevershow

Définit si les détails de la désinstallation sont montrés ou pas. Peut être 'hide' (caché), par défaut, pour cacher les détails, autorisant l'utilisateur à pouvoir les afficher, 'show' (affiché) pour les afficher, ou bien 'nevershow' (toujours cachés), pour empêcher l'utilisateur à les voir. Notez que les sections peuvent écraser ce paramètre à l'aide de SetDetailsView.

4.8.1.36 SilentInstall

normal|silent|silentlog

Spécifie si oui ou non l'installation sera silencieuse. Dans le cas de 'silent' (silencieux) ou de 'silentlog' (silencieux, avec journal), toutes les sections possédant le flag SF_SELECTED seront installées silencieusement (vous pouvez définir ce flag en utilisant SectionSetFlags), sans écran de sortie (les boites de dialogues seront tout de même affichées en cas d'erreur, et le script peut toujours afficher ce qu'il voudra). Notez que si cela est défini en 'normal' et que l'utilisateur lance l'installation avec un /S (respectez la casse) en ligne de commandes, cela reviendra au même que s'il avait utilisé SilentInstall 'silent'. Note : voir aussi LogSet

Voir section 4.12 pour plus d'informations.

4.8.1.37 SilentUnInstall

normal|silent

Spécifie si oui ou non la désinstallation sera silencieuse. Dans le cas de 'silent' (silencieux) ou de 'silentlog' (silencieux, avec journal), toutes les sections seront désinstallées automatiquement, sans écran de sortie (les boites de dialogues seront tout de même affichées en cas d'erreur, et le script peut toujours afficher ce qu'il voudra). Notez que si cela est défini en 'normal' et que l'utilisateur lance la désinstallation avec un /S en ligne de commande, cela reviendra au même que s'il avait utilisé SilentInstall 'silent'. Note : voir aussi LogSet.

Voir section 4.12 pour plus d'informations.

4.8.1.38 SpaceTexts

[texte_requis [texte_dispo]]

Si les paramètres sont spécifiés, cela écrase les valeurs par défaut ("Espace requis: " et "Espace disponible: "). Si "none" est spécifié, aucun texte ne sera affiché.

4.8.1.39 SubCaption

[numero_page sous-titre]

Ecrase les sous-titres de chaque page d'installation (0=": Acceptation de la licence",1=": Options d'installation",2=": Répertoire d'installation", 3=": Installation des fichiers", 4=": Terminé"). Si vous spécifiez une chaîne vide (""), le texte par défaut sera utilisé (vous pouvez par contre spécifier " " pour obtenir une chaîne vide).

Vous pouvez aussi définir un sous-titre (ou écraser celui par défaut) en utilisant Caption dans un bloc PageEx.

4.8.1.40 UninstallButtonText

texte_bouton

Modifie le texte du bouton qui affiche normalement "Désinstaller". Si aucun paramètre n'est spécifié, le texte par défaut sera utilisé. Voir aussi WriteUninstaller (en remplacement d’UninstallEXEName).

4.8.1.41 UninstallCaption

titre

Définit ce qu'afficheront les barres de titre pendant la désinstallation. Par défaut, ce sera 'Désinstallation de Nom', ou Nom est spécifié par la commande Name. Vous pouvez aussi le remplacer par 'Pour virer mon appli' ou n'importe quoi d'autre. Si vous spécifiez une chaîne vide (""), la valeur par défaut sera utilisée (vous pouvez utiliser " " pour obtenir une chaîne vide).

4.8.1.42 UninstallIcon

[chemin\]icone.ico

Définit l'icône de la désinstallation. Ce fichier icône doit avoir la même structure que le fichier icône de l'installation.

4.8.1.43 UninstallSubCaption

numero_page sous-titre

Ecrase les sous-titres de chaque page de la désinstallation (0=": Confirmation",1=": Désinstallation des fichiers",2=": Terminé"). Si vous spécifiez une chaîne vide (""), la valeur par défaut sera utilisée (vous pouvez utiliser " " pour obtenir une chaîne vide).

Vous pouvez aussi définir un sous-titre (ou écraser celui par défaut) en utilisant Caption dans un bloc PageEx.

4.8.1.44 UninstallText

texte [sous-texte]

Spécifie les textes sur la première page de la désinstallation.

Texte: Teste sous les contrôles

Sous-texte: Texte à côté de l'emplacement de désinstallation

4.8.1.45 WindowIcon

on|off

Défini si oui ou nom l'icône de l'installation est affichée

4.8.1.46 XPStyle

on|off

Défini si un manifeste XP sera ou pas ajouté à l'installation. Un manifeste XP permet aux contrôles de l'installation d'utiliser le nouveau style d'XP lorsque l'utilisateur fonctionne sous Windows XP. Ceci affecte aussi la désinstallation.

4.8.2 Options de compilation

Les commandes suivantes modifient la façon de le compilateur génère le code compresse les données. Ces commandes sont valides n’ importe où dans le script, et affectent chaque ligne après la commande (à moins d'être écrasé par un autre appel à la commande). Elles ne peuvent pas être sautées avec les instruction de contrôle de flux.

Par exemple, dans le script suivant, blah.dat ne sera jamais remplacé.

${If} $0 == 0
  SetOverwrite on
${Else}
  SetOverwrite off
${EndIf}
File blah.dat # overwrite est toujours off ici!

A la place le code suivant devrait être utilisé.

${If} $0 == 0
  SetOverwrite on
  File blah.dat
${Else}
  SetOverwrite off
  File blah.dat
${EndIf}

4.8.2.1 AllowSkipFiles

on|off

Cette commande spécifie si l'utilisateur peut être capable ou pas de sauter un fichier. Un utilisateur a la possibilité de sauter un fichier si SetOverwrite on est utilisé (par défaut) and et que l'installation ne peut pas ouvrir un fichier en écriture lorsqu'il essaye d'extraire un fichier (voir la commande File). Si off est utilisé, la bouton Ignorer qui permet à l'utilisateur de sauter le fichier ne sera pas affiché et l'utilisateur n'aura la possibilité que d'abandonner l'installation (bouton Annuler) ou bien de réessayer d'ouvrir le fichier en écriture (bouton Réessayer). Si on est utilisé, l'utilisateur aura la possibilité de sauter le fichier (le flag d'erreur sera levé - voir SetOverwrite).

4.8.2.2 FileBufSize

taille_tampon_en_mo

Cette commande définit la taille des tampons de fichiers internes du compilateur. Cette commande vous autorise à contrôler l'utilisation mémoire du compilateur en limitant la part d'un fichier donné sera chargé en mémoire à la fois. Puisque le compilateur nécessite à la fois une entrée et une sortie, le double de la taille mémoire spécifiée pourra être utilisé pour les tampons de fichiers. Cette commande ne limite pas le tampon de compression qui peuvent utiliser plusieurs autres Mo, et ne limite pas non plus les autres tampons internes du compilateur, qui eux doivent au plus atteindre 1 Mo. Spécifier une petite valeur peut décroitre les performances. Spécifier un nombre important peut paralyser les ressources systèmes et forcer le compilateur à annuler le processus de compilation. La valeur par défaut est 32Mo.

4.8.2.3 SetCompress

auto|force|off

Cette commande défini l'option de compression utilisée par l'installation pour déterminé si oui ou non les données sont compressées. Typiquement, l'option SetCompress sera effective sur les commandes suivantes, et le dernier SetCompress contenu dans un fichier déterminera aussi si oui ou non la section d'information de l'installation est compressée. Si l'option est en 'auto' (auto), alors les fichiers sont compressés si la taille compressée est inférieure à la taille décompressée. Si l'option est en 'force' (forcer), alors la compression est utilisée tout le temps. Si l'option est en 'off' (désactivée), alors la compression n'est pas utilisée (ce qui peut être plus rapide).

Notez que cette option n'a aucun effet lorsqu'une compression solide est utilisée, ce qui est paramétré par défaut pour BZIP2 et LZMA.

4.8.2.4 SetCompressor

[/SOLID] [/FINAL] zlib|bzip2|lzma

Cette commande définit l'algorithme de compression utilisé pour compresser les fichiers/données de l'installation.

Trois méthodes de compression sont proposées : ZLIB, BZIP2 et LZMA.

ZLib (par défaut) utilise une compression de "dégonflage" qui est très simple et efficace. Avec le niveau de compression par défaut, il utilise environ 300 Ko de mémoire.

BZIP2 donne souvent un meilleur ratio de compression que ZLIB, mais est un peu plus lent et utilise plus de mémoire. Avec le niveau de compression par défaut, il utilise environ 4 Mo de mémoire.

LZMA est une nouvelle méthode de compression donnant de très bons ratios de compression. La vitesse de décompression est élevée (10-20 Mo/s avec un processeur cadencé à 2 GHz), mais la vitesse de compression est plus basse. La taille mémoire utilisée lors de la décompression est la taille du dictionnaire plus quelques Kos, et est par défaut de 8 Mo.

Si /FINAL est utilisé, les appels suivants de SetCompressor seront ignorés.

Si /SOLID est utilisé, toutes les données de l'installateur sont compressées en un bloc. Ceci augmente le taux de compression.

4.8.2.5 SetCompressorDictSize

taille_dict_mo

Définit la taille du dictionnaire en Mo utilisé par le compresseur LZMA (par défaut de 8 Mo).

4.8.2.6 SetDatablockOptimize

on|off

Cette commande demande au compilateur d'optimiser ou pas les blocs de données. L'optimisation des blocs de données font que le compilateur va vérifier si une donnée qui va être ajoutée dans le bloc de données n'est pas déjà présente, et si tel est le cas, va simplement la référencer, contrairement à ajouter (peut diminuer la taille de quelques bits). Il est recommandé de laisser cette option activée.

4.8.2.7 SetDateSave

on|off

Cette commande définit l'heure/date du fichier utilisée par la commande File pour déterminer si l'on doit garder ou pas la dernière heure/date écrite dans le fichier. Les paramètres correctes sont 'on' (activé) et 'off' (désactivé). 'on' est la valeur par défaut.

4.8.2.8 SetOverwrite

on|off|try|ifnewer|ifdiff|lastused

Cette commande défini l'option d'écrasement, utilisée par la commande File pour déterminer si le fichier peut écraser un fichier déjà existant. Si l'option est en 'on' (activée), les fichiers seront écrasés (valeur par défaut). Si l'option est en 'off' (désactivée), les fichiers déjà présents ne seront pas écrasés. Si l'option est en 'try' (essayer), les fichiers sont, si possible, écrasés (ce qui signifie que s'il est impossible d'écraser le fichier, il est passé, sans aucune interaction de l'utilisateur). Si l'option est en 'ifnewer' (si nouveau), alors les fichiers ne sont remplacés que dans le cas ou le fichier existant est plus ancien que le fichier installé. Si l'option est à 'ifdiff', alors les fichiers ne sont écrasés que si le fichier existant est plus vieux ou plus récent que le nouveau fichier. Notez qu'en mode 'ifnewer' ou 'ifdiff', la date du fichier de destination est défini sans tenir compte de la commande SetDateSave)

SetOverwrite off
File program.cfg # fichier de config que l'on ne veut pas remplacer
SetOverwrite on

4.8.2.9 SetPluginUnload

manual|alwaysoff

Cette commande lève le flag de libération des plug-ins après un CallInstDLL et un appel de plug-in. (dll::fonct). Le paramétrer à toujours_désactivé/alwaysoff fera qu'il se comportera comme si vous aviez ajouté /NOUNLOAD à chaque CallInstDLL et appel de plug-in. Le mettre en manuel/manual ne le déchargera pas que si vous avez spécifié /NOUNLOAD.

4.8.3 Informations de version

4.8.3.1 VIAddVersionKey

 [/LANG=id_langue] clé valeur

Ajoute un champ dans l'onglet Version de la fenêtre Propriétés du fichier. Cela peut être soit un champ fournit par le système, soit un champ personnalisé. Les champs suivants sont fournis par le système :

ProductName
Comments
CompanyName
LegalCopyright
FileDescription
FileVersion
ProductVersion
InternalName
LegalTrademarks
OriginalFilename
PrivateBuild
SpecialBuild

Les noms de ces champs sont traduits sur le système cible, alors que les champs utilisateurs resteront introduits.

VIAddVersionKey /LANG=${LANG_FRENCH} "ProductName" "Application Test"
VIAddVersionKey /LANG=${LANG_FRENCH} "Comments" "Un commentaire test"
VIAddVersionKey /LANG=${LANG_FRENCH} "CompanyName" "Fausse compagnie"
VIAddVersionKey /LANG=${LANG_FRENCH} "LegalTrademarks" "Application test est une marque déposée de Fausse compagnie"
VIAddVersionKey /LANG=${LANG_FRENCH} "LegalCopyright" "© Fausse compagnie"
VIAddVersionKey /LANG=${LANG_FRENCH} "FileDescription" "Application Test"
VIAddVersionKey /LANG=${LANG_FRENCH} "FileVersion" "1.2.3"

4.8.3.2 VIProductVersion

[chaine_version_X.X.X.X]

Ajoute la version du produit en haut de la liste des Informations de version.

VIProductVersion "1.2.3.4"

Précédent | Sommaire | Suivant