A package containing all custom assets for CodeEdit. These are mostly custom SF Symbols.
import CodeEditSymbols let nsImage = NSImage.symbol(named: "name_of_the_symbol") // or using the static property: let nsImage1 = NSImage.name_of_the_symbol
import CodeEditSymbols let image = Image(symbol: "name_of_the_symbol") // or using the static property: let image1 = Image.name_of_the_symbol
To create a new asset, follow the guide on Apple's developer website.
Add the .svg you exported from SF Symbols.app to the Symbols.xcassets catalog.
Also add a static property to the Image and NSImage extension like so:
// Image Extension static let your_symbol_name: Image = .init(symbol: "your_symbol_name") // NSImage Extension static let your_symbol_name: NSImage = .symbol(named: "your_symbol_name")
Important: Make sure your symbol looks great in every font weight.
Also include snapshot tests for each symbol for Image as well as NSImage:
// MARK: YOUR_SYMBOL_NAME func testCreateNSImageYourSymbolName() { let image = NSImage.your_symbol_name let view = NSImageView(image: image) view.appearance = .init(named: .aqua) assertSnapshot(matching: view, as: .image, record: record) }
// MARK: YOUR_SYMBOL_NAME func testCreateImageYourSymbolName() { let image = Image.your_symbol_name let view: NSView = NSHostingController(rootView: image).view view.appearance = .init(named: .aqua) assertSnapshot(matching: view, as: .image(size: view.intrinsicContentSize)) }
Keep different variants of a symbol in the same parent folder and name them appropriately (see Apple's own symbols for reference).
You might have a symbol called lock and one where the symbol is inside a square where you would call that file lock.square. Also keep in mind to also provide a .fill variant if appropriate (lock.fill, lock.square.fill)
As of version 3 of SF Symbols it is possible to create multi-color, hierarchical and palette annotations inside the SF Symbols.app. Be sure to annotate it accordingly if appropriate.
