Crée une archive auto-extractible sous forme d'un exécutable en 32 bits (.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 <Variable zipArchive>.Cré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 : Erreur pendant la conversion de l'archive en archive auto-extractible.
- 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
<Variable zipArchive>.Ouvre 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 <Variable zipArchive>.Ouvre.
- 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
<Variable zipArchive>.CréeExe sur une archive, cette archive ne se ferme pas. Il est nécessaire d'utiliser la fonction
<Variable zipArchive>.Ferme pour fermer l'archive originale.
Traduction de l'interface de l'auto-extracteur (paramètre <Traduction de l'auto-extraction>)
Par défaut, l'auto-extracteur est livré en trois langues : français, anglais et espagnol. La langue de l'auto-extracteur s'adapte en fonction de la langue de l'exécutable ou de la langue spécifiée par la fonction
Nation.
L'interface de l'auto-extracteur peut 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 <Variable zipArchive>.CréeExe. |
| /TIT=<Titre> | <Titre> correspond au titre de la fenêtre d'auto-extraction. |
| /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. |