Risolvere i problemi di un link a una destinazione nell’app desktop

Usa il link canonico dosya://auth/callback per l’autenticazione e dosya://sync?path=… per una cartella di sincronizzazione locale. Le destinazioni non supportate non hanno un’alternativa nel browser: identifica prima il link con problemi.

Prima di iniziare

• Mantieni privato il link completo: un ritorno di autenticazione può contenere un token.
• Verifica che dosya sia installato. Per l’attività di sincronizzazione serve accedere; il ritorno di autenticazione fa invece parte dell’accesso stesso.

Procedura

1. Confronta il link con le forme canoniche dosya://auth/callback?token=…&state=… e dosya://sync?path=…. Il client gestisce destinazioni di autenticazione e sincronizzazione; usa queste forme documentate quando crei o riprovi un link.
2. Se non si avvia nulla, avvia dosya una volta e riprova. Le versioni installate registrano lo schema; Windows ripara anche la registrazione del client di protocollo all’avvio, mentre macOS usa open-url e Windows/Linux ricevono argomenti URL.
3. Per un ritorno di autenticazione, riavvia la procedura di accesso invece di riutilizzare un vecchio URL. Il ritorno richiede il parametro state monouso in attesa; uno stato mancante o non corrispondente viene rifiutato.
4. Dopo un ritorno valido, verifica che il client raggiunga la panoramica autenticata. Il cookie di sessione risultante viene impostato per 30 giorni; non incollare il token di ritorno in una segnalazione.
5. Per un link di sincronizzazione, verifica che path indichi una directory assoluta esistente. Il valore decodificato non deve superare 1.000 caratteri né contenere caratteri di controllo, NUL o segmenti ...
6. Riprova il link di sincronizzazione verificato e conferma che dosya apra /sync?localPath=…. I link all’avvio a freddo attendono il renderer. Se una destinazione non è supportata o è malformata, non c’è reindirizzamento alternativo al browser.

Risultato previsto

Un ritorno valido completa l’accesso in attesa; un link di sincronizzazione valido apre la pagina Sync con la directory locale verificata. Una codifica ripetuta del percorso viene decodificata al massimo cinque volte prima del rifiuto.

Se il sistema operativo apre un altro programma o non fa nulla dopo che dosya è stato avviato una volta, ripara o reinstalla il client installabile per quel sistema operativo; non esiste nell’app una procedura di recupero “apri nel browser”.

Guide correlate

• Usare l’area di notifica desktop
• Verificare gli aggiornamenti desktop