SPB Git

Repository Public

TransfersScreen.swift 13.4 KB 239 lines swift

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
Files main
Menu

Theme