Skip to content

Latest commit

 

History

History
37 lines (25 loc) · 2.74 KB

README.md

File metadata and controls

37 lines (25 loc) · 2.74 KB
Raw

ZipKit

ZipKit is an Objective-C framework for reading and writing Zip archives in macOS and iOS apps. It supports:

  • the standard PKZip format;
  • files larger than 4GB in size using PKZip's zip64 extensions (ZKFileArchive only);
  • optionally, resource forks in a manner compatible with macOS's Archive Utility (in the macOS targets only);
  • clean interruption, so archiving can be cancelled by the invoking object (e.g., a NSOperation or NSThread).

It was developed by Karl Moskowski and released under the BSD license. If you find ZipKit to be useful, please let me know.

Requirements

ZipKit requires Xcode 4.6 or higher. It works on OS X 10.8 Mountain Lion, and iOS 6.0 or higher. (If you're using older versions, make sure you git checkout 1.0.0. The project at that tag supports garbage collection and manual memory management.) The Xcode project contains three targets: a macOS framework, a macOS static library, and an iOS static library.

Using ZipKit

  1. If you're using git for your project, first add ZipKit as a submodule to your project. If you're not using git, clone ZipKit into your project's directory. (If you're using another VCS, you might want to ignore the ZipKit sub-project, or at least its .git/ directory.)
  2. Open your .xcodeproj and drag ZipKit Framework.xcodeproj from the Finder to Xcode's Project Navigator for your project. The Frameworks group is a good place for it.
  3. In the Project Navigator for your project, disclose ZipKit's Products and note the one you want to use in your project.
  4. In the Project Navigator, select your project at the top, then:
    • add the relevant ZipKit product to your target's Linked Frameworks and Libraries section, and add it to the your target's Target Dependencies under Build Phases;
    • add libz.dylib to your target's Linked Frameworks;
    • add ./ZipKit/ to your "Header Search Paths" setting
  5. If you're using one of ZipKit's static library targets in your project, add -ObjC to your target's Other Linker Flags. You may have to add -all_load as well. (Objective-C categories aren't properly linked by default when using static libraries.)

Open ZipKit.xcworkspace in Xcode and see the included Demo Projects for guidance.

License

ZipKit is released under the BSD license. It's in COPYING.TXT in the project. Acknowledge ZipKit (and other FOSS projects you use) in your app's About or Settings view or window. (If your iOS app doesn't have either, you can add a Settings Bundle; see the ZipKit Touch demo.)

Credits

  • Thanks to Jaka Jančar for original implementation of manual memory management & iOS support.
  • MacFUSE's GMAppleDouble used with appreciation.