Swift Package that provides a consistent API for various data sources offered by macOS, iOS, watchOS, and tvOS.
MIT License
⚠️ GatheredKit it currently in a pre-release beta. The API is unstable, although the only large planned breaking fix is to introduce structured concurrency for thread safety.
GatheredKit a consistent protocol-oriented API for various data sources offered by macOS, iOS, watchOS, and tvOS.
The code originated from Gathered, hence the name and logo. Prior to version 2.0 Gathered used a closed-source version of GatheredKit. Version 2.0 is currently in beta and can accessed via TestFlight.
Documentation is available online. This documentation is compiled against iOS. This doesn't quite cover all symbols in the project so please checkout the project to view documentation for other platforms.
@Published
@available
to mark properties as unavailable on some platformsGatheredKit
, enabling support for recording and remote sources of unknown typesMeasurement
values for all applicable types
The core library, GatheredKit
, provides the protocols used by the other libraries, along with various convenience types such as BasicProperty
.
The remaining libraries each provide one or more data sources. This is done to allow the a subset of the data sources to be included, which aids with documentation, discovery, and prevents accidentally include APIs that require extra permissions, such as accessing the IDFA.
Each of these libraries roughly correlates to one of Apple's frameworks.
GatheredKitCamera
GatheredKitCamera
provides access to cameras, both built-in and external. The CameraProvider
can be used to query for connected cameras. It wraps the AVFoundation
framework.
GatheredKitDevice
GatheredKitDevice
provides various sources relating to the current device.
On iOS this wraps the UIKit
framework, specifically UIDevice
.
GatheredKitLocation
GatheredKitLocation
provides the Location
data source, which is used to access location-based information provided by the GPS and associated sensors. It relies on the Core Location framework.
GatheredKitMotion
GatheredKitMotion
provides data sources that utilise the CoreMotion
framework, such as an Accelerometer
, Gyroscope
, and Magnetometer
.
GatheredKitProcessInfo
GatheredKitProcessInfo
provides information relating to the computer the process is running on.
GatheredKitScreen
GatheredKitScreen
provides access to the screens associated with the device.
Below are the sources that are available in the Gathered app but have not yet been added to this open source project.
To install via SwiftPM add the package to the dependencies section and as the dependency of a target:
let package = Package(
...
dependencies: [
.package(url: "https://github.com/JosephDuffy/GatheredKit.git", branch: "main"),
],
targets: [
.target(name: "MyApp", dependencies: ["GatheredKit"]),
],
...
)
The project is released under the MIT license. View the LICENSE file for the full license.