mirror of
https://github.com/home-assistant/iOS.git
synced 2026-02-04 02:46:35 -06:00
<!-- 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 --> ## Screenshots <!-- If this is a user-facing change not in the frontend, please include screenshots in light and dark mode. --> <img width="2360" height="1640" alt="Simulator Screenshot - iPad Air 11-inch (M3) - 2026-01-21 at 13 27 07" src="https://github.com/user-attachments/assets/1f7aac7c-2b1b-4252-b81d-e2ca27c40700" /> ## 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. --> --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
307 lines
12 KiB
Swift
307 lines
12 KiB
Swift
import SFSafeSymbols
|
|
import Shared
|
|
import SwiftUI
|
|
|
|
struct ConnectionErrorDetailsView: View {
|
|
@Environment(\.dismiss) private var dismiss
|
|
@State private var showExportLogsShareSheet: Bool = false
|
|
@StateObject private var connectivityState = ConnectivityCheckState()
|
|
|
|
private let feedbackGenerator = UINotificationFeedbackGenerator()
|
|
let server: Server?
|
|
let error: Error
|
|
let showSettingsEntry: Bool
|
|
let expandMoreDetails: Bool
|
|
|
|
init(server: Server?, error: Error, showSettingsEntry: Bool = true, expandMoreDetails: Bool = false) {
|
|
self.server = server
|
|
self.error = error
|
|
self.showSettingsEntry = showSettingsEntry
|
|
self.expandMoreDetails = expandMoreDetails
|
|
}
|
|
|
|
var body: some View {
|
|
NavigationView {
|
|
ScrollView {
|
|
VStack(alignment: .leading) {
|
|
headerView
|
|
VStack(alignment: .leading) {
|
|
VStack(alignment: .leading, spacing: DesignSystem.Spaces.two) {
|
|
Text(verbatim: L10n.Connection.Error.FailedConnect.title)
|
|
.font(.title.bold())
|
|
Text(verbatim: L10n.Connection.Error.FailedConnect.subtitle)
|
|
if let urlError = error as? URLError,
|
|
let url = urlError.failingURL?.absoluteString,
|
|
let attributedString = try? AttributedString(markdown: "[\(url)](\(url))") {
|
|
VStack {
|
|
Text(verbatim: L10n.Connection.Error.FailedConnect.url)
|
|
.font(.footnote)
|
|
Text(attributedString)
|
|
.font(.body.bold())
|
|
.frame(maxWidth: .infinity, alignment: .center)
|
|
.multilineTextAlignment(.center)
|
|
}
|
|
.frame(maxWidth: 600)
|
|
.padding()
|
|
.background(Color(uiColor: .secondarySystemBackground))
|
|
.clipShape(RoundedRectangle(cornerRadius: DesignSystem.CornerRadius.oneAndHalf))
|
|
}
|
|
|
|
if let server, server.info.connection.canUseCloud,
|
|
let cloudText = try? AttributedString(
|
|
markdown: L10n.Connection.Error.FailedConnect.Cloud
|
|
.title
|
|
) {
|
|
if server.info.connection.useCloud {
|
|
Text(cloudText)
|
|
.font(.body.italic())
|
|
} else {
|
|
// Alert user when it has deactivated cloud usage in the App
|
|
Text(verbatim: L10n.Connection.Error.FailedConnect.CloudInactive.title)
|
|
}
|
|
}
|
|
}
|
|
if showSettingsEntry {
|
|
openSettingsButton
|
|
}
|
|
CollapsibleView(startExpanded: expandMoreDetails) {
|
|
Text(L10n.ConnectionError.MoreDetailsSection.title)
|
|
.font(.body.bold())
|
|
} expandedContent: {
|
|
VStack(alignment: .leading, spacing: DesignSystem.Spaces.three) {
|
|
advancedContent
|
|
troubleShootingView
|
|
}
|
|
}
|
|
.frame(maxWidth: 600)
|
|
.padding()
|
|
.background(Color(uiColor: .secondarySystemBackground))
|
|
.clipShape(RoundedRectangle(cornerRadius: DesignSystem.CornerRadius.oneAndHalf))
|
|
.padding(.top)
|
|
|
|
Rectangle()
|
|
.foregroundStyle(Color(uiColor: .label).opacity(0.5))
|
|
.frame(maxWidth: .infinity)
|
|
.frame(height: 1)
|
|
.padding(DesignSystem.Spaces.three)
|
|
copyToClipboardButton
|
|
exportLogsButton
|
|
documentationLink
|
|
discordLink
|
|
githubLink
|
|
}
|
|
.padding()
|
|
}
|
|
}
|
|
.ignoresSafeArea(edges: .top)
|
|
.toolbar {
|
|
ToolbarItem(placement: .topBarLeading) {
|
|
if showSettingsEntry {
|
|
Button(action: {
|
|
openSettings()
|
|
}, label: {
|
|
Image(uiImage: MaterialDesignIcons.cogOutlineIcon.image(
|
|
ofSize: .init(width: 28, height: 28),
|
|
color: .label
|
|
))
|
|
})
|
|
}
|
|
}
|
|
ToolbarItem(placement: .topBarTrailing) {
|
|
CloseButton(tint: .white) {
|
|
dismiss()
|
|
}
|
|
}
|
|
}
|
|
.sheet(isPresented: $showExportLogsShareSheet, content: {
|
|
ShareActivityView(activityItems: [Current.Log.archiveURL()])
|
|
})
|
|
}
|
|
.navigationViewStyle(.stack)
|
|
}
|
|
|
|
private func openSettings() {
|
|
Current.sceneManager.webViewWindowControllerPromise.then(\.webViewControllerPromise).done { controller in
|
|
controller.showSettingsViewController()
|
|
}
|
|
}
|
|
|
|
@ViewBuilder
|
|
private var troubleShootingView: some View {
|
|
if let url = extractURL() {
|
|
ConnectivityCheckView(
|
|
state: connectivityState,
|
|
url: url,
|
|
onRunChecks: {
|
|
runConnectivityChecks(url: url)
|
|
}
|
|
)
|
|
}
|
|
}
|
|
|
|
private func extractURL() -> URL? {
|
|
// Try to extract URL from error
|
|
if let urlError = error as? URLError, let url = urlError.failingURL {
|
|
return url
|
|
}
|
|
|
|
// Try to extract from server
|
|
if let server {
|
|
if let externalURL = server.info.connection.urlForTroubleshooting(type: .external) {
|
|
return externalURL
|
|
} else if let internalURL = server.info.connection.urlForTroubleshooting(type: .internal) {
|
|
return internalURL
|
|
}
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
private func runConnectivityChecks(url: URL) {
|
|
Task {
|
|
let checker = ConnectivityChecker(state: connectivityState)
|
|
await checker.runChecks(for: url)
|
|
}
|
|
}
|
|
|
|
private var headerView: some View {
|
|
VStack {
|
|
ZStack(alignment: .topTrailing) {
|
|
Image(uiImage: Asset.logo.image.withRenderingMode(.alwaysTemplate))
|
|
.resizable()
|
|
.aspectRatio(contentMode: .fit)
|
|
.foregroundStyle(.white)
|
|
.frame(width: 100, height: 100)
|
|
Image(systemSymbol: .wifiExclamationmark)
|
|
.foregroundStyle(.red)
|
|
.padding(DesignSystem.Spaces.one)
|
|
.background(.white)
|
|
.clipShape(RoundedRectangle(cornerRadius: 50))
|
|
.shadow(radius: 10)
|
|
.offset(y: 10)
|
|
}
|
|
}
|
|
.frame(maxWidth: .infinity)
|
|
.frame(minHeight: 140)
|
|
.padding()
|
|
.background(Color.haPrimary)
|
|
}
|
|
|
|
@ViewBuilder
|
|
private var advancedContent: some View {
|
|
VStack(alignment: .leading, spacing: DesignSystem.Spaces.two) {
|
|
makeRow(title: L10n.Connection.Error.Details.Label.description, body: error.localizedDescription)
|
|
makeRow(title: L10n.Connection.Error.Details.Label.domain, body: (error as NSError).domain)
|
|
makeRow(title: L10n.Connection.Error.Details.Label.code, body: "\((error as NSError).code)")
|
|
if let urlError = error as? URLError {
|
|
makeRow(title: L10n.urlLabel, body: urlError.failingURL?.absoluteString ?? "")
|
|
}
|
|
}
|
|
.padding(.vertical)
|
|
}
|
|
|
|
private func makeRow(title: String, body: String) -> some View {
|
|
VStack(alignment: .leading) {
|
|
Text(title)
|
|
.font(.headline.bold())
|
|
Text(body)
|
|
.textSelection(.enabled)
|
|
}
|
|
}
|
|
|
|
private var copyToClipboardButton: some View {
|
|
ActionLinkButton(
|
|
icon: Image(systemSymbol: .docOnDoc),
|
|
title: L10n.Connection.Error.Details.Button.clipboard,
|
|
tint: .haPrimary
|
|
) {
|
|
UIPasteboard.general
|
|
.string =
|
|
"""
|
|
\(L10n.Connection.Error.Details.Label.description): \n
|
|
\(error.localizedDescription) \n
|
|
\(L10n.Connection.Error.Details.Label.domain): \n
|
|
\((error as NSError).domain) \n
|
|
\(L10n.Connection.Error.Details.Label.code): \n
|
|
\((error as NSError).code) \n
|
|
\(L10n.urlLabel): \n
|
|
\((error as? URLError)?.failingURL?.absoluteString ?? "")
|
|
"""
|
|
feedbackGenerator.notificationOccurred(.success)
|
|
}
|
|
}
|
|
|
|
private var exportLogsButton: some View {
|
|
ActionLinkButton(
|
|
icon: Image(systemSymbol: .squareAndArrowUp),
|
|
title: Current.Log.exportTitle,
|
|
tint: .haPrimary
|
|
) {
|
|
if Current.isCatalyst, let logsURL = Current.Log.archiveURL() {
|
|
URLOpener.shared.open(logsURL, options: [:], completionHandler: nil)
|
|
} else {
|
|
showExportLogsShareSheet = true
|
|
feedbackGenerator.notificationOccurred(.success)
|
|
}
|
|
}
|
|
}
|
|
|
|
private var openSettingsButton: some View {
|
|
ActionLinkButton(
|
|
icon: Image(uiImage: MaterialDesignIcons.cogIcon.image(
|
|
ofSize: .init(width: 28, height: 28),
|
|
color: .label
|
|
)),
|
|
title: L10n.ConnectionError.OpenSettings.title,
|
|
tint: .haPrimary
|
|
) {
|
|
openSettings()
|
|
}
|
|
.padding(.top)
|
|
}
|
|
|
|
private var documentationLink: some View {
|
|
ExternalLinkButton(
|
|
icon: Image(systemSymbol: .docTextFill),
|
|
title: L10n.Connection.Error.Details.Button.doc,
|
|
url: ExternalLink.companionAppDocs,
|
|
tint: .haPrimary
|
|
)
|
|
}
|
|
|
|
private var discordLink: some View {
|
|
ExternalLinkButton(
|
|
icon: Image("discord.fill"),
|
|
title: L10n.Connection.Error.Details.Button.discord,
|
|
url: ExternalLink.discord,
|
|
tint: .purple
|
|
)
|
|
}
|
|
|
|
@ViewBuilder
|
|
private var githubLink: some View {
|
|
if let searchURL = ExternalLink.githubSearchIssue(domain: (error as NSError).domain) {
|
|
ExternalLinkButton(
|
|
icon: Image("github.fill"),
|
|
title: L10n.Connection.Error.Details.Button.searchGithub,
|
|
url: searchURL,
|
|
tint: .init(uiColor: .init(dynamicProvider: { trait in
|
|
trait.userInterfaceStyle == .dark ? .white : .black
|
|
}))
|
|
)
|
|
}
|
|
}
|
|
}
|
|
|
|
#Preview {
|
|
VStack {}
|
|
.background(Color.gray)
|
|
.sheet(isPresented: .constant(true)) {
|
|
ConnectionErrorDetailsView(server: ServerFixture.standard, error: SomeError.some)
|
|
}
|
|
}
|
|
|
|
enum SomeError: Error {
|
|
case some
|
|
}
|