Skip to content

FRadioPlayer 0.4.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 04 Oct 17:12
· 1 commit to main since this release
0.4.0
8fff8f5
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

FRadioPlayer 0.4.0 brings Swift 6 and main-actor isolation to the library, with fixes for seeking, interruptions, stale artwork, and audio-session setup.

Highlights

  • Swift 6, main-actor player: player state and observer callbacks are main-actor isolated. AVFoundation callbacks that arrive off-main cross to the main actor before changing state.
  • Playback intent is preserved: seeking and interruptions no longer override a user's pause or stop.
  • Audio-session ownership is configurable: apps that manage their own session can set FRadioPlayer.configuresAudioSession = false on the main actor, before the first access to shared. The default remains true.

Breaking changes

  • Xcode 16+ / Swift 6 toolchain required. The library builds in Swift 6 language mode; your app can stay in Swift 5 mode.
  • Call the player from the main actor, including in Swift 5 apps. Add @MainActor to your controller, or hop with Task { @MainActor in ... } from a nonisolated context.
  • Seeking while paused or stopped no longer starts playback. Call play() explicitly if your UI intends to resume after seeking.

Fixed

  • Seek completions run exactly once, asynchronously on the main actor, including without a loaded item, before duration is known, and when a seek is superseded. Seek positions retain subsecond precision.
  • Interruptions resume only playback that was active when the interruption began, when the system allows it, and when the user has not since paused or stopped.
  • Playback after a failed stream recovers on iOS 27 by omitting a redundant explicit asset timing option. Existing custom-header asset setup is preserved.
  • Late artwork from a previous station or track is discarded.
  • Failed loads report .error without a transient .loadingFinished notification.
  • Audio-session setup uses valid .playback category options, fixing the category error observed on a physical iPhone.
  • End-of-item, seek, and off-main KVO callbacks no longer mutate player state off the main actor. Late KVO from replaced items is ignored.

Testing

  • 56 macOS tests and 60 iOS tests cover API contracts, callback delivery, seeking, interruption intent, audio-session configuration, artwork, playback fixtures, and recovery.
  • Full local suites passed on macOS, iOS 26.5, and iOS 27. The Swift 5 demo and tvOS library SDK builds passed.
  • CI passed macOS tests, iOS simulator tests, the Swift 5 demo build, and the minimum Xcode 16 build. Simulator tests now wait for boot completion.
  • Simulator notification tests cover state handling; headset, AirPlay, Bluetooth, and CarPlay routing still require physical-device validation.

Demo app

  • Main-actor controller and explicit actor hops in remote-command handlers.
  • New app icon and Choice Classic Rock replaces the unavailable Classic Rock stream.

Requirements

iOS 14+, macOS 11+, tvOS 14+, Swift 6 toolchain / Xcode 16+. Platform minimums are unchanged.

If your dependency is pinned to 0.3.0 or restricted to the 0.3 minor series, update it to receive this release:

.package(url: "https://github.com/fethica/FRadioPlayer.git", from: "0.4.0")

See the 0.4.0 migration guide for controller isolation, observer callbacks, artwork providers, seeking, and audio-session ownership.

Full Changelog: 0.3.0...0.4.0

Assets 2
Loading