KissXML provides a drop-in replacement for Apple's NSXML class culster in environments without NSXML (e.g. iOS).
It is implemented atop the defacto libxml2 C library, which comes pre-installed on Mac & iOS. But it shields you from all the nasty low-level C pointers and malloc's, and provides an easy-to-use Objective-C library.
It is designed for speed and reliability, so it's read-access thread-safe and will "just-work". That is, KissXML provides an API that follows "what-you-would-expect" rules from an Objective-C library. So feel free to do things like parallel processing of an xml document using blocks. It will "just work" so you can get back to designing the rest of your app.
KissXML is a mature library used in thousands of products. It's also used in other libraries, such as XMPPFramework (an objective-c library for real-time xml streaming). It's even used in hospital applications.
KissXML was inspired by the TouchXML project, but was created to add full support for generating XML as well as supporting the entire NSXML API.
The minimum deployment target is iOS 8.0 / macOS 10.9 / tvOS 9.0 / watchOS 2.0.
The easiest way to install KissXML
is using Swift Package Manager, simply add the following to your Package.swift
:
dependencies: [
.package(url: "https://github.com/robbiehanson/KissXML.git", .upToNextMajor(from: "x.x.x"))
]
Make sure to replace
x.x.x
with the appropriate version number.
To install KissXML
using CocoaPods, add the following to your Podfile
:
use_frameworks!
pod 'KissXML'
After pod install
open your .xcworkspace
and import:
// Swift
import KissXML
// Objective-C on iOS 8+ with `use_frameworks!`
@import KissXML;
The KissXML.xcodeproj
project contains framework targets for iOS, macOS, tvOS, and watchOS.
Get started using KissXML
Learn more about KissXML
Can't find the answer to your question in any of the [wiki](https://github.com/robbiehanson/KissXML/wiki) articles? Try the **[mailing list](http://groups.google.com/group/kissxml)**.
Love the project? Wanna buy me a ☕️ ? (or a 🍺 😀 ):
- 5.2.0 - Feb 2 2017 - Swift 3 and Carthage support. Requires iOS 8 or higher, removes static library support.
- 5.1.2 - Jul 8 2016 - Better Swift generated interface cross-compatibility with NSXML by matching NSXML headers more closely, specifically by changing many set/get methods to properties.
- 5.1.1 - Jul 7 2016 - Fixes issue when integrated as a static library. Min iOS version is back to 6.0. Moved DDXML->NSXML Swift mappings to
SwiftNSXML
subspec. Added test for static library integration. - 5.1.0 - Jul 6 2016 - Removed need for
libxml_module
subspec by removing references to libxml in public headers. Added Obj-C generics and nullability support to match NSXML API. Added watchOS support. Minimum iOS version is now 8.0. - 5.0.3 - Feb 1 2016 - Removed
DDXML_NS_DECLARATIONS_ENABLED
to allow for better Swift compatibility. AddedDDXML.swift
with mappings between NSXML classes and constants and DDXML. - 5.0.2 - Jan 26 2016 - Enable Swift support via
libxml/module.modulemap
andDDXML_LIBXML_MODULE_ENABLED
macro. You can use theKissXML/libxml_module
CocoaPods subspec to enable this feature. - 5.0.1 - Jan 21 2016 - Run tests on iOS and Mac targets.