IOS小组件:让App支持多个小组件的实现方式

Posted popfisher

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了IOS小组件:让App支持多个小组件的实现方式相关的知识,希望对你有一定的参考价值。

引言

  本节作为小组件基础介绍的最后一个章节,前面都没有提到如何支持多个小组件,默认新建一个组件Target,就有大中小三个组件。如果你是为已经存在的App开发一个小组件功能,那么可能你不会需要那么多小组件。但是也有的App需要支持很多个小组件,也可能是无限个。

  要实现支持多个小组件,需要使用到WidgetBundle,自定义一个WidgetBundle并改变小组件的初始化入口。

默认小组件入口

@main
struct Widget1: Widget {
    // 小组件的唯一ID
    let kind: String = "Widget1"

    var body: some WidgetConfiguration {
        // 创建时不勾选 “Include Configuration Intent”,这里使用 StaticConfiguration
        StaticConfiguration(kind: kind, provider: Provider()) { entry in
            Widget1EntryView(entry: entry)  // 小组件UI
        }
        .supportedFamilies([.systemSmall, .systemMedium, .systemLarge])  // 配置该组件支持的尺寸,如果不配置,默认是大中小都支持
        .configurationDisplayName("组件标题")   // 在添加组件预览界面显示
        .description("组件描述")                 // 在添加组件预览界面显示
    }
}

通过WidgetBundle实现多个组件

//@main  这个注解去掉
struct Widget1: Widget {
    // 小组件的唯一ID
    let kind: String = "Widget1"

    var body: some WidgetConfiguration {
        // 创建时不勾选 “Include Configuration Intent”,这里使用 StaticConfiguration
        StaticConfiguration(kind: kind, provider: Provider()) { entry in
            Widget1EntryView(entry: entry)  // 小组件UI
        }
        // // 配置该组件支持的尺寸,如果不配置,默认是大中小都支持
        .supportedFamilies([.systemSmall, .systemMedium, .systemLarge])  
        .configurationDisplayName("组件标题")   // 在添加组件预览界面显示
        .description("组件描述")                 // 在添加组件预览界面显示
    }
}

@main   // 把自定的WidgetBundle作为小组件的初始化入口
struct CustomWidgetBundle: WidgetBundle {
    @WidgetBundleBuilder
    var body: some Widget {
        Widget1()
        Widget1()
        Widget1()
        Widget1()
        Widget1()
    }
}

实现N个小组件

方法一:使用多个WidgetBundle(每个WidgetBundle的body最多放5个Child)

@main   // 把自定的WidgetBundle作为小组件的初始化入口
struct CustomWidgetBundle: WidgetBundle {
    // 每个WidgetBundle的body最多放5个Child
    @WidgetBundleBuilder
    var body: some Widget {
        Widget1()
        Widget1()
        Widget1()
        Widget1()
        CustomWidgetBundle1().body
    }
}

struct CustomWidgetBundle1: WidgetBundle {
    @WidgetBundleBuilder
    var body: some Widget {
        Widget1()
        Widget1()
        Widget1()
        Widget1()
        CustomWidgetBundle2().body
    }
}

struct CustomWidgetBundle2: WidgetBundle {
    @WidgetBundleBuilder
    var body: some Widget {
        Widget1()
        Widget1()
        Widget1()
        Widget1()
        Widget1()
    }
}

  Widget1支持3个组件,上面的代码总共13 * 3 = 39个组件,我也不知道有没有上限。选择组件的时候,这些组件都会出现在预览列表

方法二:使用固定的Widget数量(大中小各一个),通过类型切换布局达到目的

@main   // 把自定的WidgetBundle作为小组件的初始化入口
struct CustomWidgetBundle: WidgetBundle {
    
    @WidgetBundleBuilder
    var body: some Widget {
        WidgetSmall()
        WidgetMedium()
        WidgetLarge()
    }
}

  通过外部切换组件类型达到实现多个组件的目的,原理这里不再赘述,可参考章节《 ios Widget(4-2):创建可配置小组件(动态修改配置数据)》。这里你可能遇到一个问题:编辑一个小号组件切换类型时,里面的数据需要全部是小号类型的组件,编辑中号大号时也需要对应各自的类型。希望学到这里,你能独自解决这个问题,如还不能解决,可留言。

结语

  小组件入门之旅结束了,希望通过本系列文章能起到抛砖引玉的效果,感谢读者。

以上是关于IOS小组件:让App支持多个小组件的实现方式的主要内容,如果未能解决你的问题,请参考以下文章

系统苹果 iOS 14发布:新增桌面小组件画中画APP资源库 | iOS14更新列表出炉,你的手机支持吗?

让小程序支持代码高亮

iOS14无需越狱,一键安装APP图标主题小组件。

苹果怎样不让图标二次跳转

微信小程序简易table组件实现

快使用Scriptable自己开发一个iPhone小组件吧