Delphi DLL

Create a ZIP Archive with a Top-Level Directory Using PathPrefix

This example demonstrates how to use the PathPrefix property to ensure that all files in a ZIP archive are stored beneath a common top-level directory.

The example recursively adds files from:

c:/zipTest/directory_name

And stores them in the ZIP archive beneath:

directory_name/

For example, the local filesystem file:

c:/zipTest/directory_name/hello.txt

Will be stored in the ZIP archive as:

directory_name/hello.txt

This is useful when creating ZIP archives that should extract into a single parent directory rather than directly into the current extraction location.

The example also demonstrates that methods such as AppendFiles initially add references to filesystem files, and that the actual file reading and compression occur later when WriteZipAndClose is called.

Delphi DLL

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Zip;

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Boolean;
zip: HCkZip;
recurse: Boolean;

begin
success := False;

zip := CkZip_Create();

// Initialize the Zip object and set the output filename.
// The .zip file is not created until WriteZip or WriteZipAndClose is called.
success := CkZip_NewZip(zip,'qa_output/test.zip');
if (success = False) then
  begin
    Memo1.Lines.Add(CkZip__lastErrorText(zip));
    Exit;
  end;

// Prepend "directory_name/" to each ZIP entry added after this point.
// 
// For example, a file found at:
// 
//     c:/zipTest/directory_name/hello.txt
// 
// Will be stored in the ZIP as:
// 
//     directory_name/hello.txt
// 
// This is useful when you want the files to unzip beneath a specific
// top-level directory.
CkZip_putPathPrefix(zip,'directory_name/');

// Recursively add references to all files beneath:
// 
//     c:/zipTest/directory_name
// 
// AppendFiles does not immediately read or compress the files.
// It adds references to files in the local filesystem.
// The referenced files are read and compressed when WriteZipAndClose is called.
recurse := True;

success := CkZip_AppendFiles(zip,'c:/zipTest/directory_name/*',recurse);
if (success = False) then
  begin
    Memo1.Lines.Add(CkZip__lastErrorText(zip));
    Exit;
  end;

// Write the ZIP archive and close it.
success := CkZip_WriteZipAndClose(zip);
if (success = False) then
  begin
    Memo1.Lines.Add(CkZip__lastErrorText(zip));
    Exit;
  end;

Memo1.Lines.Add('Success.');

CkZip_Dispose(zip);

end;