Add "Script" iOS 18 ControlWidget (#2952)

<!-- Thank you for submitting a Pull Request and helping to improve Home
Assistant. Please complete the following sections to help the processing
and review of your changes. Please do not delete anything from this
template. -->

## Summary
<!-- Provide a brief summary of the changes you have made and most
importantly what they aim to achieve -->
This PR also adds a dependency: `SFSafeSymbols` to safely iterate over
SFSymbols. For ControlWidget we can't use MaterialDesign icons, unless
they are converted into custom SFSymbols and embedded in the App but
this would increase a lot the App size

## Screenshots
<!-- If this is a user-facing change not in the frontend, please include
screenshots in light and dark mode. -->
![Simulator Screenshot - iPhone 15 Pro - 2024-08-29 at 04 17
08](https://github.com/user-attachments/assets/907603f3-a132-43d0-a8ed-1c138b545080)



## Link to pull request in Documentation repository
<!-- Pull requests that add, change or remove functionality must have a
corresponding pull request in the Companion App Documentation repository
(https://github.com/home-assistant/companion.home-assistant). Please add
the number of this pull request after the "#" -->
Documentation: home-assistant/companion.home-assistant#

## Any other notes
<!-- If there is any other information of note, like if this Pull
Request is part of a bigger change, please include it here. -->
This commit is contained in:
Bruno Pantaleão Gonçalves
2024-08-29 11:18:51 +02:00
committed by GitHub
parent bed6928a4a
commit d8c561d85d
12 changed files with 227 additions and 29 deletions

View File

@@ -0,0 +1,75 @@
import AppIntents
import Foundation
import Shared
import WidgetKit
@available(iOSApplicationExtension 18, *)
struct ControlScriptItem {
let intentScriptEntity: IntentScriptEntity
let icon: SFSymbolEntity
}
@available(iOSApplicationExtension 18, *)
struct ControlScriptsValueProvider: AppIntentControlValueProvider {
func currentValue(configuration: ControlScriptsConfiguration) async throws -> ControlScriptItem {
.init(
intentScriptEntity: configuration.script ?? placeholder(),
icon: configuration.icon ?? placeholderIcon()
)
}
func placeholder(for configuration: ControlScriptsConfiguration) -> ControlScriptItem {
.init(
intentScriptEntity: configuration.script ?? placeholder(),
icon: configuration.icon ?? placeholderIcon()
)
}
func previewValue(configuration: ControlScriptsConfiguration) -> ControlScriptItem {
.init(
intentScriptEntity: configuration.script ?? placeholder(),
icon: configuration.icon ?? placeholderIcon()
)
}
private func placeholder() -> IntentScriptEntity {
.init(
id: UUID().uuidString,
serverId: "",
serverName: "",
displayString: L10n.Widgets.Controls.Scripts.placeholderTitle,
iconName: ""
)
}
private func placeholderIcon() -> SFSymbolEntity {
.init(id: "applescript.fill")
}
}
@available(iOSApplicationExtension 18.0, *)
struct ControlScriptsConfiguration: ControlConfigurationIntent {
static var title: LocalizedStringResource = .init("widgets.scripts.description", defaultValue: "Run Scripts")
@Parameter(
title: "Script"
)
var script: IntentScriptEntity?
@Parameter(
title: "Icon"
)
var icon: SFSymbolEntity?
@Parameter(
title: LocalizedStringResource(
"app_intents.scripts.show_confirmation_dialog.title",
defaultValue: "Confirmation notification"
),
description: LocalizedStringResource(
"app_intents.scripts.show_confirmation_dialog.description",
defaultValue: "Shows confirmation notification after executed"
),
default: true
)
var showConfirmationDialog: Bool
}