Tcl

Add a Common Root Directory to ZIP Entries Using PathPrefix

See more Zip Examples

This example demonstrates how to use the PathPrefix property to prepend a common directory path to all entries added to a ZIP archive.

The PathPrefix value is prepended to the stored ZIP paths for subsequently added entries.

This is useful when:

• Creating ZIP archives that extract beneath a single root directory
• Packaging applications or projects into a named top-level folder
• Avoiding extraction directly into the current directory
• Organizing ZIP contents beneath a common parent directory

Suppose the local filesystem contains:

c:/MyProject/src/main.cpp
c:/MyProject/src/util.cpp
c:/MyProject/docs/readme.txt

And suppose the following code is executed:

zip.PathPrefix = "MyProject/";

Then the ZIP archive will contain:

MyProject/src/main.cpp
MyProject/src/util.cpp
MyProject/docs/readme.txt

Without a PathPrefix, the ZIP archive would instead contain:

src/main.cpp
src/util.cpp
docs/readme.txt

The PathPrefix is applied only to entries added after the property is set.

Tcl

load ./chilkat.dll

set success 0

set zip [new_CkZip]

# Create a new ZIP archive.
set success [CkZip_NewZip $zip "MyProject.zip"]
if {$success == 0} then {
    puts [CkZip_lastErrorText $zip]
    delete_CkZip $zip
    exit
}

# Prepend "MyProject/" to all subsequently added ZIP entries.
# 
# This causes all files to extract beneath a top-level
# directory named "MyProject".
CkZip_put_PathPrefix $zip "MyProject/"

# Recursively add project files.
# 
# Because saveExtraPath = 0, the stored ZIP paths
# will normally begin with:
# 
#     src/
#     docs/
# 
# But because PathPrefix = "MyProject/",
# the final ZIP paths become:
# 
#     MyProject/src/
#     MyProject/docs/
# 
set recurse 1
set success [CkZip_AppendFiles $zip "c:/MyProject/*" $recurse]

if {$success == 0} then {
    puts [CkZip_lastErrorText $zip]
    delete_CkZip $zip
    exit
}

# Write the ZIP archive and close it.
set success [CkZip_WriteZipAndClose $zip]
if {$success == 0} then {
    puts [CkZip_lastErrorText $zip]
    delete_CkZip $zip
    exit
}

puts "ZIP archive created successfully."

delete_CkZip $zip