All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
7.2.0 - 2019-10-18
- Added support for Swift Package Manager (@JonathanDowning).
- Fixed a compilation warning caused by incorrect parameter names in documentation comments (@funkyboy).
7.1.0 - 2019-10-03
- Added new
bind
functions which accept a callback that receives aPusherEvent
. APusherEvent
represents an event received from the websocket and has properties containing the event name, channel name and data. In addition,PusherEvent
has a new property,userId
, which allows you to verify the ID of the user who triggered a client event on a presence channel. You can read more about this feature in the docs. All the oldbind
functions are still available for backwards compatibility. Thedata
property ofPusherEvent
is not automatically parsed from JSON and you can decide to parse that as required. The parsing behaviour is unchanged for data passed to callbacks bound by the oldbind
functions.
- Updated the deployment targets so they are consistent regardless of whether you import the library using CocoaPods or Carthage.
7.0.0 - 2019-04-16
- Updated to Swift 4.2.
- Updated dependencies to newer versions, but pinned dependencies before any Swift 5 versions for compatibility with older versions of Xcode (@cowgp).
- Removed push notifications beta (replaced by Pusher Beams which has its own libraries).
- Removed TaskQueue dependency (used by push notifications beta).
- Fixed issues compiling the library with Swift 5/Xcode 10.2.
- Fixed issue related to the capturing of self in Reachability callbacks (@PorterHoskins).
- Fixed unreliable tests.
6.1.0 - 2018-05-18
- Reverted to using upstream version of Starscream instead of fork.
6.0.0 - 2018-04-04
- Client will now send a ping to the server if there has been a period of inactivity on the socket. This should help detect some disconnections that previously weren't being noticed.
- All dependencies are now defined to be brought in using the appropriate package manager (Carthage or CocoaPods)
- Reconnection strategy has been changed to now attempt reconnecting indefinitely, with an exponential backoff but a maximum interval of 120 seconds between reconnection attempts.
- Removed the deprecated
AuthRequestBuilderProtocol
function:func requestFor(socketID: String, channel: PusherChannel) -> NSMutableURLRequest?
reconnectingWhenNetworkBecomesReachable
connection state
5.1.1 - 2018-01-22
- Updated Starscream and CryptoSwift based code. Starscream is at roughly 3.0.4 and CryptoSwift at roughly 0.8.1.
5.1.0 - 2017-11-23
setSubscriptions
method.
- Swift 4 support.
- Updated CryptoSwift-based code.
- Swift 3.2 support (requires Xcode 9+).
- Updated Starscream dependency (commit SHA 789264eef). Fixes #115.
- Added
Authorizer
protocol that permits a new authorization method for channels requiring it (private and presence channels).
- Reverted change introduced in 4.0.2 that set up a custom callback queue for the underlying websocket
- Added the ability to provide auth values on channel subscriptions
- Updated Starscream dependency to latest version (commit SHA ee993322c)
- Encode channel names to be consistent with other libraries
- Fixed
members
property not being set beforesubscription_succeeded
event callbacks were called for presence channels (@ichibod)
- Fixed memory leak issues with
PusherConnection
andPusherDelegate
(@anlaital) - Deprecated
requestFor
inAuthRequestBuilderProtocol
that returnsNSMutableURLRequest?
- Added
requestFor
inAuthRequestBuilderProtocol
that takes achannelName
String
instead of aPusherChannel
instance, and returnsURLRequest?
(@Noobish1)
- Made code required for push notifications available on macOS platform (i.e. push notifications work on macOS!) (@jameshfisher)
- Removed
PusherConnectionDelegate
and moved all delegate functions into unifiedPusherDelegate
- Renamed most delegate functions:
didRegisterForPushNotifications(clientId: String)
->registeredForPushNotifications(clientId: String)
didSubscribeToInterest(named name: String)
->subscribedToInterest(name: String)
didUnsubscribeFromInterest(named name: String)
->unsubscribedFromInterest(name: String)
connectionStateDidChange?(from: oldState, to: newState)
->changedConnectionState(from old: ConnectionState, to new: ConnectionState)
subscriptionDidSucceed?(channelName: channelName)
->subscribedToChannel(name: String)
subscriptionDidFail?(channelName: channelName, response: response, data: data, error: error)
->failedToSubscribeToChannel(name: String, response: URLResponse?, data: String?, error: NSError?)
- Added macOS Example Swift project that contains an example macOS app to demo push notifications (requires setting up with your own Pusher app)
- Update CryptoSwift and Starscream dependencies
- Made
NativePusher
not be a singleton anymore - Fixed
taskQueue
crash (#96)
- Authentication requests that result in any status code other that 200 or 201 are now treated as failures (previously any 2xx status code was treated as a success)
- Add a
findPresence
function to thePusherPresenceChannel
class - Make docs for working with presence channels much clearer
- Fix bug in NativePusher where subscription modification requests would fail but not call the appropriate branch of the
guard
statement - Add
PusherDelegate
, which includes optional functions related to Push Notification-related events - Added TaskQueue and refactored how subscribe / unsubscribe events are sent to the Push Notifications service (to make it thread-safe)
- Added tests for NativePusher-related code paths
- Update to work with Swift 3
- Rewrote all tests using XCTest
- Remove all need for Podfile / Cartfile when building PusherSwift locally
- Combine different builds into single target
- Merge in native notification code into main branch (push-notifications branch)
- Consolidate connection-related handlers / callbacks into
PusherConnectionDelegate
- Make
requestFor
inAuthRequestBuilderProtocol
able to fail - Rename
PresencePusherChannel
->PusherPresenceChannel
- Rename
PresenceChannelMember
->PusherPresenceChannelMember
- Rename
internal
authMethod
enum case toinline
- Add Obj-C compatibility
- Add iOS Obj-C example app
- Add
subscribeToPresenceChannel
method
- Fix potential forceful unwrapping of a nil in debug logging when reconnecting (thanks to @psycotica0 for the spot)
- Made the
Pusher
initializer take an instance of aPusherClientOptions
struct (@Noobish1) - Authenticating channels can now be achieved by: specifying an auth endpoint, providing an auth request builder (which conforms to the
AuthRequestBuilder
protocol), or by providing your app's secret (not for production) (@Noobish1) - Made the code Swiftier in general, e.g.
PusherChannelType
enum (@Noobish1) - More robust reconnect (#66 - thanks to @psycotica0 for review)
- Added two new connection state cases:
Reconnecting
andReconnectingWhenNetworkBecomesReachable
- Added
reconnectAttemptsMax
andmaxReconnectGapInSeconds
for tweaking specifics of reconnection logic - Receiving Pusher-related errors by binding to the event name
pusher:error
on the client now works
- Add
onMemberAdded
,onMemberRemoved
,findMember
, andme
functions to PusherPresenceChannel class - Bring CryptoSwift, Starscream and Reachability dependencies inside the PusherSwift library
- Update Quick and Nimble dependencies to remove warnings for Swift compatibility
- Use cocoapods version 1.0.0 on Travis
- Split up
PusherSwift.swift
andPusherSwiftTests.swift
into components - Add inline documentation throughout codebase
- Added
debugLogger
option to client - Handling of
pusher:error
messages now works as it should have done all along - Building with Carthage now now longer requires a
pod install
to make it work - Fix bug in
ConnectionStateChangeDelegate
- Pass authorization errors to client (@psycotica0)
- Use cocoapods version 1.0.0.beta.6 to make builds work on Travis
- Use Xcode 7.3 image and updated simulators on Travis
- Update CryptoSwift to 0.3.1 and Starscream to 1.1.3 (largely for Swift 2.2 compatibility)
- Add ConnectionStateChangeDelegate and associated docs & tests
- Use cocoapods version 1.0.0.beta.5 to make builds work on Travis
- Update CryptoSwift to 0.2.3
- Update Starscream to 1.1.2
- Add
cluster
option to client initialiser options dictionary - Fix autoreconnect bugs (@bdolman)
- Make
pusher:subscription_succeeded
event accessible (@bdolman)
- Make
unsentEvents
an array instead of a dictionary (fixes #29)
- Fix building for Carthage
- Update
TARGETED_DEVICE_FAMILY
for tvOS target to be correct (3
)
- Remove Pods directory from repo
- Change iOS deployment target to 8.0
- Use cocoapods version 1.0.0.beta.2 to make builds work on Travis
- Add platform-specific builds for iOS, tvOS, OSX
- Add build and test schemes for platform-specific builds
- Update Starscream to 1.1.1
- POST auth parameter with HTTP Body (@ngs)
- Add support for tvOS as platform (@goose2460)
- Update CryptoSwift to 0.2.2 (@goose2460)
- Update ReachabilitySwift to 2.3.3 (@goose2460)
- Rename
Sources
back toSource
- Fixed build errors with Carthage
- Rename
Source
toSources
in order to work with Swift Package Manager (in principle) - Make headers for PusherSwift and PusherSwiftTests targets public