No UserDefaults in framework

This release removes calls to UserDefaults used in the framework to persist a device identifier string across app launches. It now requires setting up analytics reporting sessions from host apps with a device identifier string. This change should remove any need to report use of "required reason" API to Apple (with respect to Simple Analytics) in order to meet Apple's requirements for such reporting as of Fall 2023.

JSON content-type

Explicitly sets the content-type of the URL request to JSON when posting analytics data, fixing a problem with some back-end clients.

macOS submitted completion

This release includes the new submissionCompletionCallback property in the AppAnalytics class for macOS targets that lets your Mac apps receive a callback when analytics submission is complete (or fails). This can be useful when you want to submit analytics data before terminating the app, as demonstrated in the SimpleAnalyticsDemo-AppKit project included in the repo. In addition, it fixes demo projects so that they should run out of the box without any additional setup.

Xcode 13 fix

Fixes an issue with compiling in Xcode 13.x.

In order to manage background tasks in iOS, the framework now requires passing in a reference to the shared UIApplication property when configuring the framework. See the documentation for more details, and any of the iOS sample projects for an example of implementation.

Usage documentation and SimpleAnalytics Reader

Enhanced the README file with better documentation of usage within an app, and a reference to the open-source desktop app for displaying collected data, SimpleAnalytics Reader.

Fixed 'backend' documentation

Added missing columns to the comment describing the database structure for the example PHP script.

Counters timestamp

• Added timestamp field to "counter" recording types
• Updated the example PHP script to include them in backend storage

Objective-C

• Added support for using the package in Objective-C based projects
• Added an Objective-C demo project

App version and more demos

• Added an "app version" field to the output
• Added demo AppKit- and UIKit-based demo apps for those not using SwiftUI
• Pushed the package's minimum macOS system version support back to 10.12

macOS system version

Simplified the macOC system version string to parallel the iOS system version string