DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des archives
  • Condition d'utilisation
  • Codes d'erreur
  • Chemin mémorisé des fichiers de l'archive
  • Archive auto-extractible
  • Fermeture de l'archive
  • Traduction de l'interface de l'auto-extracteur (paramètre )
  • L'exécutable se situe sur un support duquel les fichiers archivés ne peuvent pas être extraits
  • L'archive auto-extractible contient des fichiers exécutables
  • Paramètres de la ligne de commande d'une archive auto-extractible
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
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.
Exemple
// Déclaration des variables
MonArchive est un zipArchive
 
// Ouverture de l'archive "MonArchive"
ResOuvreArchive = MonArchive.Ouvre("D:\Sauvegardes\Sauvegarde.WDZ")
SI ResOuvreArchive = 0 ALORS
// Création d'une archive auto-extractible
ResExeArchive = MonArchive.CréeExe("C:\Répertoires\Archive.EXE")
...
FIN
Syntaxe
<Résultat> = <Archive>.CréeExe(<Chemin de l'exécutable> [, <Options d'extraction> [, <Icône de l'exécutable> [, <Répertoire d'extraction par défaut> [, <Traduction de l'auto-extraction>]]]])
<Résultat> : Entier
  • 0 si l'exécutable a été créé,
  • Un code d'erreur (valeur supérieure à 0) dans le cas contraire. Pour plus de détails sur ces codes d'erreur, consultez les Remarques.
<Archive> : Variable de type zipArchive
Nom d'une variable de type zipArchive correspondant à l'archive à manipuler.
<Chemin de l'exécutable> : Chaîne de caractères
Chemin de l'exécutable à créer (260 caractères maximum). Ce chemin peut être un chemin relatif au répertoire en cours ou un chemin complet.
L'extension .EXE est obligatoire.
<Options d'extraction> : Constante optionnelle
Options d'extraction à utiliser :
zipAdministrateurForce l'exécutable créé à se lancer en tant qu'administrateur. Ce mode permet d'éviter la virtualisation des fichiers à partir de Windows Vista.
zipArborescenceLes fichiers de l'archive seront extraits en respectant l'arborescence des répertoires contenus dans l'archive.
zipAvecUIL'auto-extraction affichera une boîte de dialogue permettant à l'utilisateur de choisir le répertoire de destination.
zipChoixArborescenceL'auto-extraction affichera la case à cocher "Respecter l'arborescence" dans la boîte de dialogue.
zipRepCourantTous les fichiers de l'archive seront extraits dans le répertoire en cours.
zipRepDéfautUtilise le répertoire spécifié par défaut (paramètre <Répertoire d'extraction par défaut>).
zipRepTemporaire
(Valeur par défaut)
Les fichiers de l'archive seront extraits dans le répertoire temporaire de la machine sur laquelle l'exécutable est lancé. Tous les fichiers sont extraits au même endroit.
<Icône de l'exécutable> : Chaîne de caractères optionnelle
Chemin du fichier icône représentant l'exécutable créé. Ce chemin peut correspondre à un chemin relatif au chemin en cours ou à un chemin complet.
Si ce paramètre n'est pas précisé, une icône par défaut sera attribuée à l'exécutable.
<Répertoire d'extraction par défaut> : Chaîne de caractères optionnelle
Répertoire proposé par défaut par la fenêtre de décompression (si la constante zipAvecIHM est proposée). Si l'interface de l'extraction n'est pas proposée, ce répertoire sera utilisé par défaut pour extraire les fichiers de l'archive.
<Traduction de l'auto-extraction> : Chaîne de caractères optionnelle
Chemin complet du fichier au format INI contenant la traduction des messages de l'auto-extracteur. Le format de ce fichier est détaillé dans les Notes.
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).
Interface de l'auto-extracteur
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 :
/REP=<Répertoire>
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.
/SILENTPermet de lancer l'extraction sans jauge ni dialogue.
/WAITSi l'archive auto-extractible lance un exécutable, l'amorce restera lancée aussi jusqu'à la fin de l'exécutable.
/RELANCEExtraction avec les droits d'administrateur.
Composante : wd290zip.dll
Version minimum requise
  • Version 24
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 19/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale