Use SF Symbols system image for static UIApplicationShortcutItem

Question

When specifying home screen quick actions, UIApplicationShortcutItems, in your Info.plist, is there a way to use a system image from SF Symbols?

The docs noting the available iOS keys doesn't specify a key to do this, besides specifying one of the predefined enum cases from UIApplicationShortcutItemIconType such as UIApplicationShortcutIconTypeSearch.

It is possible to use a system image when creating dynamic quick actions via a new initializer UIApplicationShortcutIcon.init(systemImageName: String). Is there a Info.plist key that allows this for static quick actions?

You could try to get the stock application into your computer, either by extracting them from the `ipsw` update file or with a jailbroken device, and explore their `Info.plist` files to see if any of them are using SF Symbols. — EmilioPelaez, Dec 09 '19 at 15:59

score 14 · Accepted Answer · answered May 18 '20 at 21:33

14

Use UIApplicationShortcutItemIconSymbolName instead of UIApplicationShortcutItemIconFile in your Info.plist.

answered May 18 '20 at 21:33

Ryan Ashcraft

364
2
6

Is this documented anywhere? Hesitant to use it. – Daniel Storm May 21 '20 at 00:28
1

It's documented here: https://developer.apple.com/documentation/uikit/menus_and_shortcuts/add_home_screen_quick_actions – Vadoff Nov 21 '20 at 00:39

score 10 · Answer 2 · edited Jun 20 '20 at 09:12

10

Seems like there is no way to directly use those. But since there are not much symbols that you need to use statically at the same time, here is the solution:

Select the symbol you need and export it from SF Symbols.app:

Import it in the Assets.xcassets:

Use it's name for the key UIApplicationShortcutItemIconFile:

Result

I hope Apple add direct support for SF Symbols soon.

edited Jun 20 '20 at 09:12

Community

1
1

answered Dec 12 '19 at 09:49

Mojtaba Hosseini

47,708
12
157
176

Besides the manual effort, the only concern I'd add is that Apple may change (or modify) the images in the future. Depending on the image, this would be very good or very bad, but worth considering before you do this. – benc May 15 '20 at 22:15

score 1 · Answer 3 · answered Dec 12 '19 at 06:47

I read the docs and tried several methods to get this working but the conclusion I reached is that this won't be possible for two main reasons:

SF Symbols are only available for native use on devices running iOS 13 or older.
Info.plist file can specify a platform and device type but you can't specify an OS version.

In Apple's documents it's also stated that:

You can use SF Symbols in apps running in iOS 13 and later, watchOS 6 and later, and tvOS 13 and later. To browse the full set of symbols, download the SF Symbols app.

This means that you are able to use these symbols but with a standard way. Here is what you can do:

Download the SF Symbols app from here.
Export the symbols you'd like to use as SVG files.
Add exported SVG files to your assets.
Use the asset name for the value of UIApplicationShortcutItemIconFile key.

This may not be the method you'd have hoped but it's a valid solution for using SF Symbols as shortcut icons so I hope this works for you.

Use SF Symbols system image for static UIApplicationShortcutItem

3 Answers3

Result

Linked