app-intents-whats-new-27

用途：本技能用于查阅 Apple 在 iOS 26（2025）与 iOS 27（2026）及各平台对应版本中为 App Intents 引入的新 API、行为与废弃项。在编写或修改涉及这些新增/变更 API 的代码前，应先读取对应的 references/*.md 参考文件，避免凭训练记忆误判可用版本或选错相近 API。文档中每个 API 都标注了精确的 @available 版本；当部署目标早于该版本时，应使用 @available / if #available 进行版本门控，而不是放弃该功能。用户若笼统询问 App Intents 的新变化，应从这些参考文件汇总作答。与特定版本无关的通用最佳实践（实体 id 稳定性、查询设计、错误本地化、短语规则、捐赠、@Dependency 位置、AppEnum 原始值稳定性等）应改用同系列的 app-intents-specialist 技能。约束：只使用公开 API，不得建议或输出非公开及下划线前缀符号；每个类型、初始化器与参数都必须真实存在于当前公开 App Intents API 中，不得为让代码片段通过编译而虚构 API；实体 id 方案、AppEnum 原始值、AppShortcut 短语和意图类型名属于公开契约，新增安全，重命名/删除/重新编号属于行为变更需明确提示。SDK 26.0（2025）覆盖：执行模式（supportedModes / IntentModes、迁移弃用的 openAppWhenRun、前台续接、UndoableIntent，以及 iOS 26.4 的 CancellableIntent 和 27.0 新增的 LongRunningIntent 等）；交互式片段（SnippetIntent 与 Button(intent:)/Toggle）；requestChoice 多选确认；Visual Intelligence（IntentValueQuery + SemanticContentDescriptor）；屏幕实体解析（appEntityIdentifier / AppEntityAnnotatable）；Spotlight 索引（@Property / @ComputedProperty / @DeferredProperty、IndexedEntityQuery、relatedAppEntityIdentifier）；@ComputedProperty 与 @DeferredProperty；Apple Intelligence schema 采用（@AppIntent(schema:) 等，@AssistantIntent 系列已弃用）。SDK 27.0（2026）覆盖：相关性与上下文（RelevantEntities.shared.updateEntities）；跨设备身份与归属（SyncableEntity、EntityOwnership）；SystemShortcut（仅 iPhone/iPad）；AppIntentsTesting 单元测试框架；EntityCollection；@UnionValue 作为 Shortcuts 参数。以上为公开资料整理，具体细节以对应参考文件为准。