如何为iOS应用快捷方式设置自定义图标及添加应用内快捷方式？

要给通过AppIntent和AppShortcutsProvider实现的Spotlight快捷方式设置自定义图标，核心是使用AppShortcutsIcon.custom()初始化方法，配合正确配置的图标资源，以下是具体步骤：

1. 准备自定义图标资源 #

• 在Xcode的Assets.xcassets中新建Image Set，命名为你想要的标识（比如NewNoteIcon）。
• 为该Image Set添加不同尺寸的图标文件，适配不同场景：
  • 29pt（@2x:58pt、@3x:87pt）：用于Spotlight搜索结果等小尺寸场景
  • 40pt（@2x:80pt、@3x:120pt）：用于快捷方式推荐等中等尺寸场景
  • 图标需为透明背景的PNG格式，圆角建议设置为20%（系统会自动适配，但提前做好能避免显示异常）

2. 在自定义Intent中设置自定义图标 #

在你的AppIntent子类中，重写shortcutIcon属性，使用AppShortcutsIcon.custom()指定图标名称：

import AppIntents

struct NewNoteIntent: AppIntent {
    static let title: LocalizedStringResource = "新建备忘录"
    static let description = IntentDescription("快速创建一条新备忘录")

    // 设置自定义快捷方式图标
    static var shortcutIcon: AppShortcutsIcon {
        AppShortcutsIcon.custom(name: "NewNoteIcon")
    }

    func perform() async throws -> some IntentResult {
        // 执行新建备忘录的逻辑
        return .result()
    }
}

3. 在AppShortcutsProvider中关联Intent #

确保你的AppShortcutsProvider实现中包含该Intent，系统会自动将图标应用到Spotlight等场景：

struct AppShortcuts: AppShortcutsProvider {
    static var appShortcuts: [AppShortcut] {
        AppShortcut(
            intent: NewNoteIntent(),
            phrases: ["打开\(applicationName)新建备忘录", "\(applicationName)创建备忘录"],
            shortTitle: "新建备忘录",
            systemImageName: "note.text" // 自定义图标加载失败时的 fallback 图标
        )
    }
}

常见问题排查 #

• 图标名称拼写错误：确保AppShortcutsIcon.custom(name:)中的名称和Assets里的Image Set名称完全一致，区分大小写。
• 资源未正确导入：检查Image Set中的每个尺寸是否都添加了对应分辨率的图片，且文件未被排除在编译资源外。
• iOS版本限制：AppShortcutsIcon.custom()仅支持iOS 16.0及以上版本，若需兼容更低版本，需做版本适配。
• 缓存问题：修改图标后，可能需要重启设备或重新安装应用才能看到更新后的图标（Xcode的Build & Run有时无法刷新快捷方式缓存）

内容的提问来源于stack exchange，提问作者Younes Ans