What's Changed

• Add SF Symbols versions 6.3, 6.4, and 7.0 by @F1248 in #144
• 2025 Cleanup by @StevenSorial in #147
• Add support for SwiftUI Element Tab by @timbms in #146

New Contributors

• @F1248 made their first contribution in #144
• @timbms made their first contribution in #146

Full Changelog: 6.2.0...7.0.0

Added

• Add support for SF Symbols 6.2 (By Steven Sorial)
• Add support for SF Symbols 6 (By Rod Brown)
• Added more convenience initializers.

Changed

• None

Fixed

• None

Added

• Add support for SF Symbols 5.3 (By Steven Sorial)

Changed

• Class SFSymbol, Subclasses SymbolWithNLocalization, and protocol SymbolLocalization are now conforming to the Sendable protocol in preparation for Swift 6. (By Thomas Durand)

Fixed

• None

Full Changelog: 5.2.0...5.3.0

Added

• Add support for SF Symbols 4.2, 5.0, 5.1, and 5.2 (By Steven Sorial)
• Add new localizations languages (Central Khmer and Burmese) (By Steven Sorial)
• Add support for visionOS (By Steven Sorial)

Changed

• Remove Traditional Chinese localization option which was removed by Apple (By Steven Sorial)
• Raise minimum platforms to iOS 12.0 / tvOS 12.0 / macOS 10.14 / watchOS 5.0 (By Steven Sorial)
• Remove deprecated methods and properties (By Steven Sorial)

Fixed

• None

Full Changelog: 4.1.1...5.2.0

Added

• None

Changed

• Changed SwiftUI's Label initializer to take an optional SFSymbol (By Steven Sorial)

Fixed

• None

Added

• Add support for SF Symbols 4.1 (By Steven Sorial)
• Add SwiftLint suggestion to README.md (By David Furman)

Changed

• None

Fixed

• None

With this release, SFSafeSymbols now supports the latest 4.0 SF Symbols! 🎉

Here's the full changelog:

Added

• Add support for SF Symbols 4.0 (By Frederick Pietschmann)
• Add new UIImage.init(systemSymbol:variableValue:configuration:), NSImage.init(systemSymbol:variableValue:accessibilityDescription:) and SwiftUI.Image.init(systemSymbol:variableValue:) interfaces. (By Steven Magdy)
• Add new UIImage.init(systemSymbol:compatibleWith:) interface. (By Steven Magdy)

Changed

• Retain dynamic localization information when serializing / deserializing an SFSymbol. (By Steven Magdy)
• Deprecate UIButton.systemButton(with:target:selector: and button.setImage(:for:) interfaces. (By Steven Magdy)

Fixed

• Remove misleading optionality of NSImage.init(systemSymbol:accessibilityDescription:) interface. (By Steven Magdy)

Fixed

• Added missing 3.3 layerset information.

Fixed

• Fix version numbering to adhere to the semantic versioning guide. (By Frederick Pietschmann)

The 3.3 release is finally out, adding support for SF Symbols 3. 🚀 It also includes many other notable changes, including some changes that will speed up the release process for upcoming releases (see full changelog below; for some niche features there are also breaking changes).

A big thank you to everyone who made this release possible – with valuable contributions to the codebase or fruitful participation in discussions. 💙

Added

• Add support for SF Symbols 1.1, 2.2, 3.0, 3.1, 3.2, and 3.3 (By Steven Magdy)
• Add support for explicit symbol localization. (By David Knothe)
• Add documentation for available layersets & improve documentation in general. (By Frederick Pietschmann)

Changed

• Deprecate allCases: [SFSymbol] in favor of new allSymbols: Set<SFSymbol>. (By Steven Magdy)
• Transfer repository to new location: https://github.com/SFSafeSymbols/SFSafeSymbols & simplify contributions to this repository. (By Frederick Pietschmann)
• Change the type of SFSymbol from enum to class, using static let ... instead of case for individual symbols. This allows for specification of custom symbols as static lets in extensions to SFSymbol and fixes an issue that prevented rawValue initialization of symbols. (By Steven Magdy)
• Improve internal code generation to allow for quick adjustments to new SF Symbols versions. (By ddddxxx)
• Drop dedicated SFSafeSymbols-Dynamic product in the Package.swift in favour of a new unified SFSafeSymbols product with automatic selection between static / dynamic linking. (By Steven Magdy)
• Lower watchOS deployment target to watchOS 4.0. (By Steven Magdy)
• Refactor unit tests. (By Martin Wright and Frederick Pietschmann)

Fixed

• Fix macOS availability. (By Steven Magdy)
• Fix unavailable 1.0 symbols by introducing a new 1.1 version. (By Steven Magdy)