robbiehanson /XMPPFramework

An XMPP Framework in Objective-C for Mac and iOS

★ 5,873⑂ 2,049👁 363⑃ 245● 997▤ 4
Objective-CNOASSERTIONCreated 2011-03-31
下载:Version 4.1.0Version-4.1.0 ↓4.1.02020-12-31
-1
日增长
5,873
stars
2,049
forks
363
watchers
245
prs
997
issues
4
releases

README

!XMPPFramework

 XMPPFramework
    


An XMPP Framework in Objective-C for the Mac and iOS development community.

 Abstract
XMPPFramework provides a core implementation of RFC-3920 (the XMPP standard), along with the tools needed to read & write XML. It comes with multiple popular extensions (XEP's), all built atop a modular architecture, allowing you to plug-in any code needed for the job. Additionally the framework is massively parallel and thread-safe. Structured using GCD, this framework performs well regardless of whether it's being run on an old iPhone, or on a 12-core Mac Pro. (And it won't block the main thread... at all)

 Install

The minimum deployment target is iOS 8.0 / macOS 10.9 / tvOS 9.0.

 Migration from 3.7 to 4.0

There have been a number of changes to the public API of XMPPFramework in an attempt to improve the ergnomics and safety when used with Swift. Most Objective-C projects should require no changes, with a few minor exceptions. Many (simple) changes will be required for pure Swift projects, mostly due to the new nullability annotations. The process is still not complete so please submit issues and help if possible to minimize future breaking changes.

 Swift Support in XMPPFrameworkSwift.framework and XMPPFramework/Swift subspec
 Modern Objective-C Syntax: Nullability annotations and generics.
 Most of Core, Authentication, Categories, and Utilities have been audited. Additional help is needed for Extensions.
 XMPPJID bareJID is now imported into Swift as bareJID instead of bare to prevent conflict with bare String. Also applies to domainJID.
 XMPPPresence intShow has been renamed showValue and is now an XMPPPresenceShow enum instead of int. This will be a warning in 4.0 but will be removed in 4.1.
 The XMPPMessage chatState string value is now imported into Swift as a native Swift String enum when using the Swift extensions. A new chatStateValue property is provided for accessing the raw String value in both Swift and Obj-C.
 Readonly properties are used instead of getter methods where applicable. Getter naming overrides for properties have been removed to reflect Apple's approach.
 The following modules still need an audit. If you use these modules please help out and contribute some time to audit them and submit a pull request, otherwise their API may contain breaking changes in future releases.

	 XEP-0191 Blocking
	 XEP-0199 Ping
	 XEP-0202 Time
	 XEP-0136 Archiving
	 XEP-0115 Capabilities (CoreDataStorage unaudited)
	 XEP-0045 MUC (Storage unaudited)
	 XEP-0054 vCardTemp (CoreDataStorage unaudited)
	 XEP-0016 Privacy
	 XEP-0012 Last Activity
	 XEP-0009 RPC
	 Roster (Storage unaudited)
	 XMPPGoogleSharedStatus
	 FileTransfer
	 CoreDataStorage
	 BandwidthMonitor

 Swift Support

XMPPFramework is now accepting contributions written in Swift, with some limitations. Swift code must be isolated in the Swift/ folder, and none of the existing or future Obj-C code may depend upon it. All public APIs written in Swift must 

Top issues

Latest release

Version 4.1.0 4.1.0 2020-12-31
New Features:
 Add Swift Package Manager support 1177

Bug Fixes:
 Correct nullability for lastDisconnect 1076
 Fixes "Block implicity retains 'self'" warnings 1078
 Fixing the iPhone sample code for Xcode 10 1096
 Added publish options for device and boundle nodes 1117
 Fix crashes in XMPPvCardTempEmail and XMPPvCardTempTel initialize 1162

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON