Trail: Home > Developer's Guide >

Creating a .cwz archive

A .cwz archive is actually just a .zip archive with a different extension. The recommended way to create an archive is through the Mac OS X Finder:

  1. Select your application in the Finder.
  2. Activate the "Create Archive of ..." function in the menu or context menu.
  3. Edit the file name of the resulting archive to end in ".cwz" instead of ".zip".
  4. In the confirmation dialog box, click "Use .cwz".

A .cwz archive should only contain a single bundle. If your software package consists of multiple bundles, you should either store them inside of each other (e.g. if you have an application and a preference pane), or make multiple archives (e.g. if there are several applications). The archive must not contain any surrounding folders, just the bundle itself.

You can rename the archive to anything you like. However, it is strongly recommended to name it like the application and to include the version number in the archive name. That allows your users to quickly identify the archive in their download or archive folders.

Note that while the Finder will preserve all properties of the files and folders packaged, there are some that Cowry currently doesn't restore on extraction. Cowry handles symlinks and execute permission bits. It currently does not handle resource forks, type and creator codes, other Mac attributes, and custom icons. If your application relies on any of these, you should wait for a future release that will support those features.