UIKit应用Live Activity不显示,WidgetBundle需额外配置吗?
解决Live Activity不显示的关键配置步骤
必须添加Widget Extension目标:你的猜测完全正确,
TestWidgBundle不能直接放在主iOS目标中,必须单独创建Widget Extension目标。Live Activity依赖Widget Extension的专属运行环境,主App目标无法承载WidgetBundle和Live Activity的UI渲染逻辑。创建Widget Extension的标准流程:
- 在Xcode中选中主项目,点击左上角
+号,选择Widget Extension模板 - 勾选
Include Live Activities选项(模板会自动生成带ActivityAttributes和WidgetBundle的基础代码) - 将你已编写的
TestAttributes、TestWidg、TestWidgBundle代码迁移到这个新Extension目标中,或直接基于模板代码修改
- 在Xcode中选中主项目,点击左上角
验证目标关联与配置:
- 检查主App目标的
General标签,在Frameworks, Libraries, and Embedded Content中确认已添加Widget Extension的产物(格式为.appex),且嵌入方式设为Embed & Sign - 查看Widget Extension目标的
Info.plist:- 确认
NSExtension->NSExtensionAttributes->SupportsLiveActivities值为YES - 确认
NSExtensionPrincipalClass指向你的TestWidgBundle类,格式为$(PRODUCT_MODULE_NAME).TestWidgBundle
- 确认
- 检查主App目标的
代码与运行检查:
- 确保
TestAttributes正确遵循ActivityAttributes协议,且定义了合法的ContentState关联类型 - 启动Live Activity时,确认调用
Activity.request(attributes:contentState:)后返回的Activity实例状态为.active - 在Xcode控制台搜索
LiveActivity关键词,排查是否有初始化失败、权限缺失或配置错误的日志
- 确保
测试环境要求:
- 仅支持iOS 16.1及以上版本
- 必须使用物理设备测试(模拟器对Live Activity的支持存在局限性,部分场景无法正常显示)
- 确认设备系统设置中,你的App已开启通知权限及
Live Activities权限
内容的提问来源于stack exchange,提问作者Fattie
相关产品推荐
相关产品推荐

