酷我音乐iOS小组件适配开发实践

struct GameStatusEntry: TimelineEntry {
    var date: Date
    var gameStatus: String
}

@available(iOS 14.0, macOS 11.0, watchOS 9.0, *)
@available(tvOS, unavailable)
public struct StaticConfiguration<Content> : WidgetConfiguration where Content : View {

    /// The content and behavior of this widget.
    public var body: some WidgetConfiguration { get }

    /// The type of widget configuration representing the body of
    /// this configuration.
    ///
    /// When you create a custom widget, Swift infers this type from your
    /// implementation of the required `body` property.
    public typealias Body = some WidgetConfiguration
}

@available(iOS 14.0, macOS 11.0, watchOS 9.0, *)
@available(tvOS, unavailable)
public struct IntentConfiguration<Intent, Content> : WidgetConfiguration where Intent : INIntent, Content : View {

    /// The content and behavior of this widget.
    public var body: some WidgetConfiguration { get }

    /// The type of widget configuration representing the body of
    /// this configuration.
    ///
    /// When you create a custom widget, Swift infers this type from your
    /// implementation of the required `body` property.
    public typealias Body = some WidgetConfiguration
}

@available(iOS 17.0, macOS 14.0, watchOS 10.0, *)
@available(tvOS, unavailable)
public struct AppIntentConfiguration<Intent, Content> : WidgetConfiguration where Intent : WidgetConfigurationIntent, Content : View {

    /// The content and behavior of this widget.
    public var body: some WidgetConfiguration { get }

    /// The type of widget configuration representing the body of
    /// this configuration.
    ///
    /// When you create a custom widget, Swift infers this type from your
    /// implementation of the required `body` property.
    public typealias Body = some WidgetConfiguration
}

KWTestLargeWidgetView(entry: entry)
    .containerBackground(.fill.tertiary, for: .widget)

import WidgetKit
import SwiftUI

@available(iOSApplicationExtension 16.0, *)
@main
struct WidgetLauncher {
    // Combine widgets in this way to prevent crashes.
    static func main() {
        if #available(iOSApplicationExtension 17.0, *) {
            WidgetsBundle17.main()
        } else {
            WidgetsBundle16.main()
        }
    }
}

struct WidgetsBundle16: WidgetBundle {
    var body: some Widget {
        KWxxxxWidget1()
        ...
    }
}

@available(iOSApplicationExtension 17.0, *)
struct WidgetsBundle17: WidgetBundle {
    var body: some Widget {
        KWxxxxWidget1()
        ...
    }
}

var body: some WidgetConfiguration {
    AppIntentConfiguration(kind: kind, intent: KWAppWidgetTestConfigurationIntent.self, provider: Provider()) { entry in
        KWTestLargeWidgetView(entry: entry)
            .containerBackground(.fill.tertiary, for: .widget) //适配容器背景
    }
    .contentMarginsDisabled() //https://developer.apple.com/videos/play/wwdc2023/10027/ 去掉安全区域边界
    .configurationDisplayName("复古磁带机")
    .description("让音乐以经典形态呈现")
}

@Environment(\.widgetContentMargins) var margins: EdgeInsets //如果适配边界请使用这个

Button(action: {

}, label: {
    Image("123")
        .frame(minWidth: 90, minHeight:90)
        .aspectRatio(contentMode: .fill)
        .tint(.clear)
        .padding(0)
})
//.buttonStyle(BorderlessButtonStyle()) //打开这行代码改成不需要边框样式按钮

Button(intent: KWAppWidgetConfigurationLikeIntent(info: itemInfo!)) {
    Image(itemInfo!.didCollected ? "kw_widget_tape_large_like" : "kw_widget_tape_large_unlike")
        .resizable()
        .aspectRatio(contentMode: .fill)
        .frame(minWidth: itemSize, maxWidth: .infinity, minHeight:itemSize, maxHeight:.infinity)
}
.frame(width: itemSize, height: itemSize)
.tint(.clear)
.padding(.trailing, space)
.buttonStyle(BorderlessButtonStyle())

struct KWAppWidgetConfigurationLikeIntent: AudioPlaybackIntent {
    static var title: LocalizedStringResource = "收藏或取消收藏当前歌曲"
    static var description = IntentDescription("酷我音乐")
    var info: KWWidgetItemInfo
    init() {
        self.info = KWWidgetItemInfo.defaultInfo()
    }
    init(info: KWWidgetItemInfo) {
        self.info = info
    }
    func perform() async throws -> some IntentResult {
        try await KWWidgetAppIntentHandle.handleWidgetAppIntentFavorite() //注意这行代码
        return .result()
    }
}

KWWidgetAppIntentHandle.handleWidgetAppIntentFavorite()

@available(iOSApplicationExtension 17.0, *)
struct KWAppWidgetConfigurationLikeIntent: AudioPlaybackIntent {
    static var title: LocalizedStringResource = "收藏或取消收藏当前歌曲"
    static var description = IntentDescription("酷我音乐")

    func perform() async throws -> some IntentResult {
          //... 这里直接调用收藏代码  
        return .result()
    }
}

@available(iOSApplicationExtension 17.0, *)
struct KWAppWidgetConfigurationIntent: WidgetConfigurationIntent {
    static var title: LocalizedStringResource = "酷我音乐"
    static var description = IntentDescription("酷我音乐小组件.")
    static var openAppWhenRun: Bool = true  //app启动 默认拉端
    static var isDiscoverable: Bool = false //不在指令app中显示
    func perform() async throws -> some IntentResult {
        return .result()
    }   
}

/// Determines whether this App Intent is discoverable by system features, such as Shortcuts and Spotlight.
/// App Intents must be discoverable to be used with App Shortcuts. App Intents that are not discoverable
/// can be used only when directly specified by the developer, such as when tied to a button in a SwiftUI app or
/// a Widget. `true` by default.
@available(macOS 14.0, iOS 17.0, watchOS 10.0, tvOS 17.0, *)
static var isDiscoverable: Bool { get }

HStack(alignment: .bottom) {
    Image(itemInfo!.didCollected ? "kw_widget_absorption_color_like" : "kw_widget_absorption_color_unlike")
        .resizable()
        .aspectRatio(contentMode: .fit)
        .frame(minWidth: itemSize.width, maxWidth: .infinity, minHeight:itemSize.height, maxHeight:.infinity)
        .widgetURL(URL(string: "sunyazhou://collectOrNot"))
        .border(.red)
    Image(itemInfo!.isPlay ? "kw_widget_absorption_color_play" : "kw_widget_absorption_color_pause")
        .resizable()
        .aspectRatio(contentMode: .fit)
        .frame(minWidth: itemSize.width, maxWidth: .infinity, minHeight:itemSize.height, maxHeight:.infinity)
        .widgetURL(URL(string: "sunyazhou://playOrPause"))
        .border(.cyan)
    Image("kw_widget_absorption_color_next")
        .resizable()
        .aspectRatio(contentMode: .fit)
        .frame(minWidth: itemSize.width, maxWidth: .infinity, minHeight:itemSize.height, maxHeight:.infinity)
        .widgetURL(URL(string: "sunyazhou://playNext"))
        .border(.blue)
}

@available(iOS 14.0, macOS 11.0, watchOS 9.0, *)
@available(tvOS, unavailable)
extension View {

    /// Sets the URL to open in the containing app when the user clicks the widget.
    /// - Parameter url: The URL to open in the containing app.
    /// - Returns: A view that opens the specified URL when the user clicks
    ///   the widget.
    ///
这行    /// Widgets support one `widgetURL` modifier in their view hierarchy.
这行    /// If multiple views have `widgetURL` modifiers, the behavior is
这行    /// undefined.
    public func widgetURL(_ url: URL?) -> some View

}

HStack(alignment: .bottom) {
    Link(destination: URL(string: "sunyazhou://collectOrNot")!) {
        Image(itemInfo!.didCollected ? "kw_widget_absorption_color_like" : "kw_widget_absorption_color_unlike")
            .resizable()
            .aspectRatio(contentMode: .fit)
            .frame(minWidth: itemSize.width, maxWidth: .infinity, minHeight:itemSize.height, maxHeight:.infinity)
            .border(.red)
    }
    Link(destination: URL(string: "sunyazhou://playOrPause")!) {
        Image(itemInfo!.isPlay ? "kw_widget_absorption_color_play" : "kw_widget_absorption_color_pause")
            .resizable()
            .aspectRatio(contentMode: .fit)
            .frame(minWidth: itemSize.width, maxWidth: .infinity, minHeight:itemSize.height, maxHeight:.infinity)
            .border(.cyan)
    }
    Link(destination: URL(string: "sunyazhou://playNext")!) {
        Image("kw_widget_absorption_color_next")
            .resizable()
            .aspectRatio(contentMode: .fit)
            .frame(minWidth: itemSize.width, maxWidth: .infinity, minHeight:itemSize.height, maxHeight:.infinity)
            .border(.blue)
    }
}

Text(entry.info.currLine) //首行高亮
    .font(.system(size: 20).bold())
    .foregroundColor(.white)
    .lineLimit(2)
    .truncationMode(.tail)
    .id(entry.info.currLine)
    .transition(.push(from: .bottom)) //先设置从下向上推的转场动效
    .animation(.easeInOut(duration: 0.6), value: entry.info.currLine) //配合动画修改器

@objc
class func reloadAllSystemWidgets() {
    NSObject.cancelPreviousPerformRequests(withTarget: self, selector: #selector(delayReloadAllSystemWidgets), object: nil)
    self.perform(#selector(delayReloadAllSystemWidgets), with: nil, afterDelay: 0.2)
}

/// 根据kind标识刷新控件
@objc
private class func delayReloadAllSystemWidgets() {
    WidgetCenter.shared.reloadTimelines(ofKind: "com.sunyazhou.widget1")
    ....
}

@available(iOS 14.0, macOS 11.0, watchOS 9.0, *)
@available(tvOS, unavailable)
extension WidgetBundleBuilder {

    public static func buildBlock<C0, C1, C2, C3, C4, C5, C6, C7, C8, C9>(_ c0: C0, _ c1: C1, _ c2: C2, _ c3: C3, _ c4: C4, _ c5: C5, _ c6: C6, _ c7: C7, _ c8: C8, _ c9: C9) -> some Widget where C0 : Widget, C1 : Widget, C2 : Widget, C3 : Widget, C4 : Widget, C5 : Widget, C6 : Widget, C7 : Widget, C8 : Widget, C9 : Widget

}

import WidgetKit
import SwiftUI

@main
struct KWWidgetBundle: WidgetBundle {
    var body: some Widget {
        DesktopComponent()
    }

    func KWWidget() -> some Widget {
        if #available(iOS 17.0, *) {
            return WidgetBundleBuilder.buildBlock(WidgetsBundleA().body,
                                                  WidgetsBundleB().body,
                                                  WidgetsBundleC().body) //可以最多使用10个
            //...
        }
        if #available(iOS 16.1, *) {
            return WidgetBundleBuilder.buildBlock(WidgetsBundleD().body,
                                                  WidgetsBundleE().body,
                                                  WidgetsBundleF().body) //可以最多使用10个
            //...
        }
    }
}

@available(iOS 17.0, *)
struct WidgetsBundleA: WidgetBundle {
    var body: some Widget {
        KWPlayMusicWidget1()
        KWPlayMusicWidget2()
        //...
        //不能超过10个
    }
}

@available(iOS 16.1, *)
struct KWPlayMusicWidget1: Widget {
    let kind: String = "sunyazhou.com1"

    var body: some WidgetConfiguration {
        //...这里写组件内部的堆叠视图
    }
}


struct KWPlayMusicWidget2: Widget {
    let kind: String = "sunyazhou.com2"

    var body: some WidgetConfiguration {
        //...这里写组件内部的堆叠视图
    }
}

/// If the app is not in the foreground, consider the intent anyways.
static var openAppWhenRun: Bool { get }