Android™

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.

Android™

// Important: Don't forget to include the call to System.loadLibrary
// as shown at the bottom of this code sample.
package com.test;

import android.app.Activity;
import com.chilkatsoft.*;

import android.widget.TextView;
import android.os.Bundle;

public class SimpleActivity extends Activity {

  private static final String TAG = "Chilkat";

  // Called when the activity is first created.
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    boolean success = false;

    CkZip zip = new CkZip();

    //  Create a new ZIP archive.
    success = zip.NewZip("MyProject.zip");
    if (success == false) {
        Log.i(TAG, zip.lastErrorText());
        return;
        }

    //  Prepend "MyProject/" to all subsequently added ZIP entries.
    //  
    //  This causes all files to extract beneath a top-level
    //  directory named "MyProject".
    zip.put_PathPrefix("MyProject/");

    //  Recursively add project files.
    //  
    //  Because saveExtraPath = false, the stored ZIP paths
    //  will normally begin with:
    //  
    //      src/
    //      docs/
    //  
    //  But because PathPrefix = "MyProject/",
    //  the final ZIP paths become:
    //  
    //      MyProject/src/
    //      MyProject/docs/
    //  
    boolean recurse = true;
    success = zip.AppendFiles("c:/MyProject/*",recurse);

    if (success == false) {
        Log.i(TAG, zip.lastErrorText());
        return;
        }

    //  Write the ZIP archive and close it.
    success = zip.WriteZipAndClose();
    if (success == false) {
        Log.i(TAG, zip.lastErrorText());
        return;
        }

    Log.i(TAG, "ZIP archive created successfully.");

  }

  static {
      System.loadLibrary("chilkat");

      // Note: If the incorrect library name is passed to System.loadLibrary,
      // then you will see the following error message at application startup:
      //"The application <your-application-name> has stopped unexpectedly. Please try again."
  }
}