PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • 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-extraction (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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
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.
// Ouverture de l'archive "MonArchive"
MonArchive est un zipArchive
 
ResOuvreArchive = zipOuvre(MonArchive, "D:\Sauvegardes\Sauvegarde.WDZ")
SI ResOuvreArchive = 0 ALORS
// Création d'une archive auto-extractible
ResExeArchive = zipCréeExe(MonArchive, "C:\Répertoires\Archive.EXE")
...
FIN
 
Syntaxe
<Résultat> = zipCréeExe(<Archive> , <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> : Chaîne de caractères (avec guillemets) ou variable de type zipArchive
Nom de l'archive à manipuler.
Ce nom peut correspondre :
  • soit au nom d'une archive défini avec la fonction zipOuvre ou la fonction zipCrée.
  • Versions 15 et supérieures
    soit au nom d'une variable de type zipArchive.
    Nouveauté 15
    soit au nom d'une variable de type zipArchive.
    soit au nom d'une variable de type zipArchive.
<Chemin de l'exécutable> : Chaîne de caractères (avec guillemets)
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 :
Versions 18 et supérieures
zipAdministrateur
Nouveauté 18
zipAdministrateur
zipAdministrateur
Force 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.
zipAvecIHML'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 (avec guillemets)
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 (Icoône exécutable par défaut).
<Répertoire d'extraction par défaut> : Chaîne de caractères optionnelle (avec guillemets)
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 (avec guillemets)
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 ne peut être réalisée que 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).
=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 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>
/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 : wd240zip.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire