Crée une archive auto-extractible sous forme d'un exécutable (.EXE). Lors du lancement de cet exécutable, les fichiers de l'archive sont automatiquement décompressés sur le poste en cours.
Remarques
Condition d'utilisation
La création d'une archive auto-extractible peut être réalisée uniquement si :
- L'archive existe (la création d'une archive s'effectue avec la fonction zipCrée).
- L'archive est accessible en lecture et en écriture.
- L'archive est mono-partie.
Attention :
- Archives au format "CAB" : Cette fonction n'est pas disponible.
- Archives au format "RAR" : Cette fonction n'est pas disponible.
- Archives au format "7z" : Cette fonction n'est pas disponible.
- Archives au format "TAR" et "TARGZ" : Cette fonction n'est pas disponible.
Codes d'erreur
Les codes d'erreur retournés sont les suivants :
- 10 : Pas assez de place pour créer l'exécutable ou l'utilisateur n'a pas les droits en écriture sur l'archive originale (.WDZ).
- 11 : L'icône n'a pas été trouvée ou l'icône n'est pas au bon format.
- 12 : Pas assez de place pour créer l'exécutable, ou l'utilisateur n'a pas les droits en lecture sur l'archive originale (.WDZ).
Le message correspondant au code d'erreur peut être connu grâce à la fonction
zipMsgErreur.
Chemin mémorisé des fichiers de l'archive
Lors de l'extraction des fichiers d'une archive auto-extractible, le chemin mémorisé des fichiers n'est pas conservé. Seuls le nom et l'extension des fichiers sont conservés.
Archive auto-extractible
Une archive auto-extractible provenant d'une archive WINDEV peut être ouverte avec la fonction
zipOuvre et manipulée comme toute autre archive.
Il n'est pas possible de reconstruire l'archive originale (.WDZ ou .ZIP) à partir d'une archive auto-extractible.
Il n'est pas possible de mettre de mot de passe sur une archive auto-extractible.
Attention :
- Une archive auto-extractible au format standard ZIP ne peut pas être ouverte avec la fonction zipOuvre.
- Si l'archive auto-extractible contient des sous-répertoires vides et non vides, lors de la décompression de l'archive, seuls les répertoires qui contiennent un fichier sont recréés.
Fermeture de l'archive
Après utilisation de la fonction
zipCréeExe sur une archive, cette archive ne se ferme pas. Il est nécessaire d'utiliser la fonction
zipFerme pour fermer l'archive originale.
Traduction de l'interface de l'auto-extraction (paramètre <Traduction de l'auto-extraction>)
L'interface de l'auto -extracteur peur utiliser une langue différente de la langue par défaut (le français).
Pour cela, il suffit de créer un fichier .INI contenant les informations suivantes :
[GENERAL]
NATIONDEFAUT=1
[WDAUTOEX01]
R000=Archive Autoextractible PC SOFT
R001=Extraire le contenu de l'archive dans le répertoire :
R002=Conserver l'arborescence
R003=Extraire
R004=Fermer
Par exemple pour obtenir une interface en anglais :
[GENERAL]
NATIONDEFAUT=1
[WDAUTOEX01]
R000=Self-Extracting PC SOFT archive
R001=Extract the content of the archive in the directory:
R002=Keep the tree structure
R003=Extract
R004=Close
Attention : Les trois premières lignes de ce fichier ne doivent pas être modifiées.
Dans les lignes suivantes, indiquez la traduction voulue.
Le paramètre <Traduction de l'auto-extraction> doit correspondre au chemin du fichier .INI contenant la traduction de l'interface.
L'exécutable se situe sur un support duquel les fichiers archivés ne peuvent pas être extraits
Il est possible que l'exécutable se situe sur un support (un CD par exemple) duquel les fichiers archivés ne peuvent pas être extraits. Il est alors nécessaire de lancer l'exécutable en précisant dans la ligne de commande :
Le paramètre <Répertoire> indique l'endroit duquel les fichiers archivés doivent être extraits. Si le paramètre <Répertoire> contient des espaces, il est nécessaire d'encadrer la chaîne de caractères par des guillemets.
Ce paramètre est prioritaire sur le paramètre <Répertoire de l'extraction>.
L'archive auto-extractible contient des fichiers exécutables
Si le dernier fichier archivé est un fichier exécutable (.EXE), ce fichier sera lancé automatiquement après l'extraction de tous les fichiers de l'archive.
Paramètres de la ligne de commande d'une archive auto-extractible
Les paramètres suivants sont disponibles pour lancer une archive auto-extractible en ligne de commande :
| |
| /REP=<Répertoire> | Permet d'indiquer l'endroit duquel les fichiers archivés doivent être extraits. Si <Répertoire> contient des espaces, il est nécessaire d'encadrer la chaîne de caractères par des guillemets. Attention : Ce paramètre est prioritaire sur le paramètre <Répertoire de l'extraction> spécifié avec la fonction zipCréeExe. |
| /TIT=<Titre> | <Titre> correspond au titre de la fenêtre d'auto-extraction. |
 Versions 24 et supérieures/PID=<Num PID>  Nouveauté 24/PID=<Num PID> | Permet d'attendre la fin du processus <Num PID> avant de lancer l'extraction. |
| /SILENT | Permet de lancer l'extraction sans jauge ni dialogue. |
| /WAIT | Si l'archive auto-extractible lance un exécutable, l'amorce restera lancée aussi jusqu'à la fin de l’exécutable. |
| /RELANCE | Extraction avec les droits d'administrateur. |