Repository Public
1// SP Drive iOS2// File: Features/Transfers/TransfersScreen.swift3// Description: The transfer queue as the user sees it: running, paused, failed and finished uploads and downloads, with pause, resume and cancel.4//5// Author: Simon-Pierre Boucher6// Contact: contact@spboucher.ai7import SwiftUI89struct TransfersScreen: View {10 @Environment(AppModel.self) private var model11 /// Bytes done of the running transfers, fresher than what the store holds (polled while the screen is visible).12 @State private var live: [String: Int64] = [:]13 @State private var cancelCandidate: TransferRecord?1415 var body: some View {16 let _ = model.transfersVersion17 let all = model.store.transfers()18 let active = all.filter(\.isActive)19 let paused = all.filter { $0.state == .paused }20 let failed = all.filter { $0.state == .failed }21 let finished = all.filter { $0.state == .done || $0.state == .cancelled }.sorted { $0.updatedAt > $1.updatedAt }22 let runningIDs = all.filter { $0.state == .running }.map(\.id)2324 Group {25 if all.isEmpty {26 EmptyState(symbol: "arrow.up.arrow.down.circle", title: "Aucun transfert",27 message: "Les envois et les téléchargements apparaissent ici pendant qu’ils voyagent, avec leur progression.")28 .accessibilityIdentifier("transfers.empty")29 } else {30 List {31 if !model.network.online {32 Section {33 Label("Les transferts reprendront au retour du réseau", systemImage: "wifi.slash")34 .font(.subheadline)35 .foregroundStyle(.orange)36 .accessibilityIdentifier("transfers.offlineBanner")37 }38 } else if let hold = model.dominantHold {39 // the policy holds part of the queue: say why, and offer the way out when there is one40 Section {41 VStack(alignment: .leading, spacing: 8) {42 Label(hold.label, systemImage: hold.symbol).font(.subheadline.weight(.semibold)).foregroundStyle(SPDTheme.Palette.warning).accessibilityIdentifier("transfers.holdBanner")43 Text(hold.explanation).font(.footnote).foregroundStyle(.secondary).fixedSize(horizontal: false, vertical: true)44 if hold == .waitingForWiFi {45 Button { Task { await model.engine.allowOnCellular() } } label: { Label("Utiliser les données cellulaires cette fois", systemImage: "antenna.radiowaves.left.and.right") }46 .buttonStyle(.bordered)47 .accessibilityIdentifier("transfers.allowCellular")48 }49 }50 }51 }52 section("En cours", active)53 section("En pause", paused)54 section("Échecs", failed)55 section("Terminés", finished)56 Section {57 } footer: {58 Text("Les transferts continuent quand SP Drive est en arrière-plan, mais c’est iOS qui décide du moment (batterie, réseau, utilisation de l’appareil). Garde l’app ouverte pour un transfert urgent.")59 }60 }61 .listStyle(.insetGrouped)62 .accessibilityIdentifier("transfers.list")63 }64 }65 .navigationTitle("Transferts")66 .toolbar {67 ToolbarItem(placement: .topBarTrailing) {68 Menu {69 Button { Task { await model.engine.resumeAll() } } label: { Label("Tout reprendre", systemImage: "play.fill") }70 .disabled(paused.isEmpty && failed.isEmpty)71 .accessibilityIdentifier("transfers.resumeAll")72 Button { Task { await model.engine.clearFinished() } } label: { Label("Effacer les terminés", systemImage: "checkmark.circle") }73 .disabled(finished.isEmpty)74 .accessibilityIdentifier("transfers.clearFinished")75 } label: {76 Label("Actions", systemImage: "ellipsis.circle")77 }78 .accessibilityIdentifier("transfers.menu")79 }80 }81 .confirmationDialog(cancelTitle, isPresented: cancelDialogShown, titleVisibility: .visible, presenting: cancelCandidate) { t in82 Button("Annuler l’envoi", role: .destructive) { Task { await model.engine.cancel(t.id) } }83 .accessibilityIdentifier("transfers.confirmCancel")84 Button("Continuer l’envoi", role: .cancel) {}85 } message: { t in86 Text(t.itemID.hasPrefix(DriveItem.localPrefix)87 ? "« \(t.name) » n’est pas encore sur le Drive. Si tu annules, ce fichier est retiré de la file d’envoi et de SP Drive sur cet appareil : il ne sera pas envoyé. L’original, là où tu l’as pris, n’est pas touché."88 : "La nouvelle version de « \(t.name) » ne sera pas envoyée. Ta copie modifiée reste sur cet appareil ; la version du Drive ne change pas.")89 }90 // about twice a second, and only while this screen shows running transfers91 .task(id: runningIDs) {92 guard !runningIDs.isEmpty else { live = [:]; return }93 while !Task.isCancelled {94 var fresh: [String: Int64] = [:]95 for id in runningIDs { if let done = await model.engine.progress(of: id) { fresh[id] = done } }96 if fresh != live { live = fresh }97 try? await Task.sleep(for: .milliseconds(500))98 }99 }100 }101102 private var cancelTitle: String { "Annuler cet envoi ?" }103 private var cancelDialogShown: Binding<Bool> {104 Binding(get: { cancelCandidate != nil }, set: { if !$0 { cancelCandidate = nil } })105 }106107 @ViewBuilder108 private func section(_ title: String, _ list: [TransferRecord]) -> some View {109 if !list.isEmpty {110 Section("\(title) (\(list.count))") {111 ForEach(list) { t in112 TransferRow(transfer: t, liveDone: live[t.id], online: model.network.online, hold: model.transferHolds[t.id])113 .swipeActions(edge: .trailing, allowsFullSwipe: false) {114 if t.state != .done && t.state != .cancelled {115 Button(role: .destructive) { requestCancel(t) } label: { Label("Annuler", systemImage: "xmark") }116 }117 }118 .swipeActions(edge: .leading, allowsFullSwipe: true) {119 if t.isActive {120 Button { Task { await model.engine.pause(t.id) } } label: { Label("Pause", systemImage: "pause.fill") }.tint(.orange)121 } else if t.state == .paused || t.state == .failed {122 Button { Task { await model.engine.resume(t.id) } } label: { Label(t.state == .failed ? "Réessayer" : "Reprendre", systemImage: t.state == .failed ? "arrow.clockwise" : "play.fill") }.tint(.green)123 }124 }125 .contextMenu {126 if t.isActive {127 Button { Task { await model.engine.pause(t.id) } } label: { Label("Mettre en pause", systemImage: "pause.fill") }128 }129 if t.state == .paused {130 Button { Task { await model.engine.resume(t.id) } } label: { Label("Reprendre", systemImage: "play.fill") }131 }132 if t.state == .failed {133 Button { Task { await model.engine.resume(t.id) } } label: { Label("Réessayer", systemImage: "arrow.clockwise") }134 }135 if t.state != .done && t.state != .cancelled {136 Button(role: .destructive) { requestCancel(t) } label: { Label(t.kind == .upload ? "Annuler l’envoi" : "Annuler le téléchargement", systemImage: "xmark") }137 }138 }139 .accessibilityIdentifier("transfers.row.\(t.id)")140 }141 }142 }143 }144145 /// Cancelling a download loses nothing; cancelling an upload is confirmed first.146 private func requestCancel(_ t: TransferRecord) {147 if t.kind == .upload { cancelCandidate = t } else { Task { await model.engine.cancel(t.id) } }148 }149}150151private struct TransferRow: View {152 let transfer: TransferRecord153 let liveDone: Int64?154 let online: Bool155 var hold: TransferPolicy.Hold?156157 private var done: Int64 {158 if transfer.state == .done { return transfer.size }159 return min(max(liveDone ?? transfer.done, 0), max(transfer.size, 0))160 }161 private var fraction: Double {162 if transfer.state == .done { return 1 }163 return transfer.size > 0 ? min(1, Double(done) / Double(transfer.size)) : 0164 }165 private var isUpload: Bool { transfer.kind == .upload }166167 var body: some View {168 HStack(alignment: .top, spacing: 12) {169 KindIcon(kind: FileKind(extension: (transfer.name as NSString).pathExtension.lowercased()))170 VStack(alignment: .leading, spacing: 4) {171 HStack(spacing: 6) {172 Image(systemName: isUpload ? "arrow.up" : "arrow.down")173 .font(.caption.weight(.bold))174 .foregroundStyle(.secondary)175 .accessibilityHidden(true)176 Text(transfer.name).font(.body).lineLimit(2)177 }178 if transfer.state == .running || transfer.state == .queued || transfer.state == .paused || transfer.state == .failed {179 ProgressView(value: fraction)180 .tint(transfer.state == .failed ? .red : transfer.state == .paused ? .orange : Color("AccentColor"))181 .accessibilityHidden(true)182 }183 Text(amountText).font(.caption).foregroundStyle(.secondary).monospacedDigit()184 Text(stateText)185 .font(.caption)186 .foregroundStyle(transfer.state == .failed ? AnyShapeStyle(.red) : AnyShapeStyle(.secondary))187 .fixedSize(horizontal: false, vertical: true)188 }189 }190 .padding(.vertical, 2)191 .accessibilityElement(children: .combine)192 .accessibilityLabel("\(isUpload ? "Envoi" : "Téléchargement") de \(transfer.name)")193 .accessibilityValue("\(amountText). \(stateText)")194 }195196 private var amountText: String {197 switch transfer.state {198 case .done: transfer.size.byteString199 default: "\(done.byteString) sur \(transfer.size.byteString)"200 }201 }202203 private var stateText: String {204 switch transfer.state {205 case .running: return isUpload ? "Envoi en cours · \(Int(fraction * 100)) %" : "Téléchargement en cours · \(Int(fraction * 100)) %"206 case .queued:207 if !online { return "En attente du réseau" }208 if let hold { return hold.label }209 return transfer.attempts > 0 ? "Nouvel essai dans un instant" : "En attente"210 case .paused: return "En pause"211 case .failed: return TransferFailure.reason(code: transfer.errorCode, upload: isUpload)212 case .done: return (isUpload ? "Envoyé" : "Téléchargé") + " · \(transfer.updatedAt.shortRelative)"213 case .cancelled: return "Annulé · \(transfer.updatedAt.shortRelative)"214 }215 }216}217218/// Plain-language reasons for the error codes the engine stores on a failed transfer.219enum TransferFailure {220 static func reason(code: String?, upload: Bool) -> String {221 switch code {222 case "network": "Le réseau a lâché trop souvent. Réessaie quand la connexion est stable."223 case "quota": "Ton Drive est plein : libère de l’espace sur le Drive, puis réessaie."224 case "too_large": "Ce fichier dépasse la taille maximale acceptée par le Drive."225 case "infected": "L’antivirus du Drive a signalé ce fichier : il ne peut pas être transféré."226 case "conflict": "Le fichier a changé sur le Drive entre-temps. Rien n’a été écrasé : choisis quoi garder dans « Conflits et problèmes »."227 case "checksum": "Le contenu reçu ne correspond pas à l’original (vérification d’intégrité). Réessaie."228 case "not_found": upload ? "Le fichier ou son dossier n’existe plus sur le Drive." : "Ce fichier n’existe plus sur le Drive."229 case "missing_file": "Le fichier à envoyer est introuvable sur cet appareil."230 case "disk": "Impossible d’écrire sur cet appareil. Vérifie l’espace libre, puis réessaie."231 case "unauthenticated": "Ta session a pris fin. Reconnecte-toi, puis réessaie."232 case "name_conflict": "Un élément du même nom existe déjà à cet endroit sur le Drive."233 case "server": "Le serveur a refusé le transfert. Réessaie plus tard."234 case .some(let other) where !other.isEmpty: "Le transfert a échoué (\(other)). Réessaie plus tard."235 default: "Le transfert a échoué. Réessaie plus tard."236 }237 }238}239