The Ably LiveObjects plugin enables real-time collaborative data synchronization for the ably-cocoa SDK. LiveObjects provides a simple way to build collaborative applications with synchronized state across multiple clients in real-time. Built on Ably's core service, it abstracts complex details to enable efficient collaborative architectures.
Warning
This package is deprecated.
From ably-cocoa 1.3.0, the LiveObjects plugin is developed and released as the AblyLiveObjects product of the ably-cocoa package. No further releases will be published from this repository.
For installation and migration, see the LiveObjects section of the ably-cocoa README.
Everything you need to get started with Ably LiveObjects:
- Learn about Ably LiveObjects.
- Getting started with LiveObjects in Swift.
- Explore the example app to see LiveObjects in action.
Ably aims to support a wide range of platforms. If you experience any compatibility issues, open an issue in the repository or contact Ably support.
This plugin supports the following platforms:
| Platform | Support |
|---|---|
| iOS | >= 14.0 |
| macOS | >= 11.0 |
| tvOS | >= 14.0 |
Note
Xcode 16.3 or later is required.
This repository contains an example app, written using SwiftUI, which demonstrates how to use the plugin. The code for this app is in the Example directory.
In order to allow the app to use modern SwiftUI features, it supports the following OS versions:
- macOS 14 and above
- iOS 17 and above
- tvOS 17 and above
To run the app:
- Open the
AblyLiveObjects.xcworkspaceworkspace in Xcode. - Follow the instructions inside the
Secrets.example.swiftfile to add your Ably API key to the example app. - Run the
AblyLiveObjectsExampletarget. If you wish to run it on an iOS or tvOS device, you'll need to set up code signing.
New versions of the plugin now ship with ably-cocoa. This repository's final release is 0.4.1, and its CHANGELOG.md records the historical standalone releases. Every Ably release is also listed on changelog.ably.com.
Read the CONTRIBUTING.md guidelines to contribute to Ably or share feedback or request a new feature.
For help or technical support, visit Ably's support page. You can also view the community-reported GitHub issues or raise one yourself.