1. 基本介绍

iOS 14 中新增了 WidgetExtension，用来取代之前的 TodayExtension。相比以前的 Widget 这一次的小组件不可谓是坑不多，特别是集成在之前毕竟庞杂的工程中，奇奇怪怪的报错和不兼容就出来了。网上帖子更多的还是新建一个工程，然后走一遍流程，这个不难理解，这里我把我在项目工程中集成 WidgetExtension 遇到的坑给大家捋一捋。

另外和以前的 Widget 最大的不同就是，Widget Extension 只支持 SwiftUI。

PS：最近一直在写 flutter 文章，有兴趣的可以关注专题我的 Flutter 专题。

2. WidgetExtension 创建

打开 File -> New -> Target -> Widget Extension。然后创建一个，注意名字最好不要用 Widget，后边第6条会讲这地方的坑。

WidgetExtension create.png

WidgetExtension named.png

3. iOS 14 报错

看的教程可能一切顺利，但是可能你打开页面就是这样的一片夕阳红，这里就是工程环境问题了。

Error iOS 14.png

'Timeline' is only available in application extensions for iOS 14.0 or newer
'WidgetConfiguration' is only available in application extensions for iOS 14.0 or newer
'init(_:style:)' is only available in application extensions for iOS 14.0 or newer
'IntentConfiguration' is only available in application extensions for iOS 14.0 or newer
'init(kind:intent:provider:content:)' is only available in application extensions for iOS 14.0 or newer
'configurationDisplayName' is only available in application extensions for iOS 14.0 or newer

解决方案如下，将 PROJECT 的 iOS Development Target 改为 14.0。注意是工程，不是 TARGETS。

Resolve iOS 14.png

4. New Builder 报错

SwiftUI 的预览功能报错，这个需要更改 Build System，算是常见错误了。

NeedXCBuildError: New build system required

The new build system is required for using Xcode previews

Error New Builder.png

打开 File -> Project Setting / WorkSpace Setting -> Build System -> New Build System。

Resolve Project Setting.png

Resolve Build System.png

5. Class Prefix 报错

这个真的是最最最最最恶心的报错了，找了一整天，也没啥头绪的，理论上和这个 Widget Extension 没有半毛钱关系的东西竟然能跑不起来。

当然如果自己工程没有 Class Prefix 自然不用关心这个，也不会出现报错。

Error Prefix.png

Type 'Provider' does not conform to protocol 'IntentTimelineProvider'
Do you want to add protocol stubs?

Cannot find type 'ConfigurationIntent' in scope

Cannot find type 'ConfigurationIntent' in scope

删除 Class Prefix 就行了。

Resolve Prefix.png

6. Widget 重名报错

前边有提到尽量不要用 Widget 作为 Widget Extension 的命名，在这里会有一个简单的报错，生成的 demo 中，<你的命名> : Widget 会有这么一个类，如果你使用 Widget 命名，就会和父类重名，然后报错。

Error Widget.png

'Widget' is annotated with @main and must provide a main static function of type () -> Void or () throws -> Void.

Inheritance from non-protocol type 'Widget'

解决方案就给 struct 改个名字就好了，文件名不用改的。

Resolve.png

7. 运行 Widget Extension

Build Success.png

8. 自定义 Widget Extension

放在一起篇幅就比较长了，自定义 UI 就另开一篇来讲解了，这里先上几张效果图。

Widget Large Midium.png

Widget Small.png

iOS 14 小组件（1）：WidgetExtension 创建及报错详解