# Context pack: App desktop Source: https://nordvec.com/it/docs/guides/desktop Pack: https://nordvec.com/it/docs/packs/desktop This pack bundles one Nordvec guide with the guides it builds on and the guides it links to, in reading order, so an assistant reading it meets no reference it cannot follow. ## Contents 1. [App desktop](https://nordvec.com/it/docs/guides/desktop) (this guide) 2. [Installa, directory dei dati e log](https://nordvec.com/it/docs/guides/desktop/install-and-data) (linked from this guide) 3. [Problemi noti dell'app desktop](https://nordvec.com/it/docs/guides/desktop/known-issues) (linked from this guide) --- # App desktop Source: https://nordvec.com/it/docs/guides/desktop Installa l'app desktop di Nordvec, guarda cosa scrive sul disco e scopri perché rifiuta o salta un file. L'app desktop sincronizza le cartelle che scegli sul tuo computer in Nordvec. Queste pagine trattano cosa installa, dove conserva i suoi dati e il file di log, e cosa significa ogni messaggio che mostra. - [Installa, directory dei dati e log](https://nordvec.com/it/docs/guides/desktop/install-and-data): Cosa installa l'app desktop di Nordvec su Windows, macOS e Linux, ogni file che scrive sul disco e dove si trova il suo file di log. - [Problemi noti dell'app desktop](https://nordvec.com/it/docs/guides/desktop/known-issues): Perché l'app desktop di Nordvec rifiuta una cartella, salta un file, mantiene una rimozione o smette di sincronizzare, e cosa fare per ciascun caso. --- # Installa, directory dei dati e log Source: https://nordvec.com/it/docs/guides/desktop/install-and-data Cosa installa l'app desktop di Nordvec su Windows, macOS e Linux, ogni file che scrive sul disco e dove si trova il suo file di log. Questa pagina indica dove l'app desktop scrive su ogni sistema operativo, per tua documentazione personale o per una revisione IT. È generata dalla configurazione di build dell'app e dai nomi dei file che il suo codice scrive, quindi cambia quando questi vengono modificati. L'app è **Nordvec Desktop**, con ID applicazione `com.nordvec.desktop`. ## Windows [#windows] * **Installer:** un programma di installazione `.exe` per x64. * **Installa per:** l'installer chiede se installare solo per te o per tutti sul computer. Solo per te è preselezionato e non richiede diritti di amministratore. * **Cartella di installazione:** puoi sceglierla nell'installer. * **Disinstallare** rimuove la directory dei dati qui sotto insieme all'app. L'aggiornamento no. * **Directory dei dati:** `%APPDATA%\Nordvec Desktop` * **File di log:** `%APPDATA%\Nordvec Desktop\logs\nordvec-.log` ## macOS [#macos] * **Download:** un'immagine disco (`.dmg`) o un archivio `.zip`, per Mac con Apple silicon e Intel (un'unica build universale). * **Richiede:** macOS 13.0 o successivo. * **Rimuovere l'app** lascia intatta la directory dei dati qui sotto; eliminala per rimuovere i dati di sincronizzazione locali. * **Directory dei dati:** `~/Library/Application Support/Nordvec Desktop` * **File di log:** `~/Library/Application Support/Nordvec Desktop/logs/nordvec-.log` ## Linux [#linux] * **Download:** un AppImage per x64. Funziona come tuo utente, senza installazione a livello di sistema. * **Rimuovere l'app** lascia intatta la directory dei dati qui sotto; eliminala per rimuovere i dati di sincronizzazione locali. * **Portachiavi:** l'app necessita di un gnome-keyring o KWallet in esecuzione per crittografare i dati di sincronizzazione locali e non sincronizza senza uno di essi. * **Directory dei dati:** `~/.config/Nordvec Desktop` * **File di log:** `~/.config/Nordvec Desktop/logs/nordvec-.log` * Quando `XDG_CONFIG_HOME` è impostato, la directory dei dati è `$XDG_CONFIG_HOME/Nordvec Desktop` invece. ## Cosa contiene la directory dei dati [#cosa-contiene-la-directory-dei-dati] Tutto ciò che l'app conserva sul tuo computer si trova nella directory dei dati per il tuo sistema operativo, come indicato sopra. Ogni account connesso ha il proprio archivio di sincronizzazione. | Nome | Cosa contiene | | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `sync-state-.sqlite` | Lo store di sincronizzazione per un account connesso: cartelle monitorate, esclusioni, code di caricamento e rimozione e cosa è stato sincronizzato. Nomi e percorsi dei file al suo interno sono crittografati con una chiave protetta dal portachiavi del sistema operativo. | | `logs/nordvec-.log` | Il log dell'app per un giorno. Registra eventi, conteggi e codici di errore, e ogni riga indica la versione dell'app che l'ha scritta. È scritto per non contenere nomi di file, percorsi o contenuti dei file. | | `logs/nordvec-.1.log` | La parte precedente del log di un giorno, conservata quando il log giornaliero raggiunge il limite di dimensione. Al massimo uno al giorno. | | `window-state.json` | L'ultima dimensione e posizione della finestra. | | `ui-locale` | La lingua dell'ultima pagina mostrata dall'app, in modo che il menu della barra delle applicazioni e le notifiche la utilizzino. | | `update-health.json` | Quando l'app ha controllato per l'ultima volta gli aggiornamenti e se i controlli stanno fallendo. | | `whats-new-version` | L'ultima versione di cui l'app ha mostrato l'elenco delle modifiche, in modo che le modifiche di ogni aggiornamento siano mostrate una sola volta. | | `first-run-done` | Segna che il primo avvio è stato eseguito, quindi l'avvio all'accesso è attivato solo per una nuova installazione. | | `crash-ledger.json` | Quando l'app si è arrestata l'ultima volta a causa di un errore, solo come orari, in modo che un secondo arresto subito dopo la riapertura la mantenga chiusa invece di riaprirla. | Mentre l'archivio di sincronizzazione è aperto, SQLite mantiene i file `-wal`, `-shm`, `-journal` accanto a `sync-state-.sqlite`; appartengono all'archivio. L'app conserva anche i cookie e lo storage del sito della sessione connessa nella directory dei dati. Lo store dei cookie è crittografato con una chiave protetta dal keychain del sistema operativo. Su un computer che ha eseguito una build precedente, potresti trovare anche: | Nome | Cosa contiene | | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sync-state.json` | Stato scritto da una build precedente. Al momento dell'accesso, l'app lo consegna all'account che lo possiede e lo mantiene se non riesce a determinarne il proprietario. | | `logs/nordvec.log` | Il log scritto da una build precedente. Viene eliminato insieme ai log giornalieri una volta che è abbastanza vecchio. | | `logs/nordvec.log.old` | Il log precedente conservato da una build precedente, eliminato alle stesse condizioni. | | `sync-state-.json` | Stato per account scritto da una build precedente. Al momento dell'accesso, l'app lo copia nello store di sincronizzazione e lo rinomina una volta letta la copia. | | `sync-state-.json.imported` | Lo stesso stato precedente dopo che i suoi contenuti sono stati copiati nello store di sincronizzazione. Contiene nomi e percorsi dei file non crittografati e nulla lo legge di nuovo, quindi è sicuro eliminarlo. | ## File di log [#file-di-log] L'app scrive un file di log al giorno, `logs/nordvec-.log` nella directory dei dati, dove la data è il giorno sul tuo computer. Per aprire la loro cartella dall'app, scegli **Guida > Mostra file di log**. Quando il log di un giorno raggiunge 5 MB, le righe precedenti vengono spostate in `nordvec-.1.log`, quindi un giorno mantiene al massimo due file. L'app conserva gli ultimi 14 giorni, incluso oggi, e al massimo 50 MB di log in totale, eliminando prima i giorni più vecchi. Non elimina mai il log di oggi e elimina solo i file con questi nomi. Ogni riga indica la build che l'ha scritta, come `v= sha=` dopo l'orario e il livello. ## Quale versione hai [#quale-versione-hai] * Windows: scegli **Guida > Informazioni su Nordvec Desktop**. * macOS: scegli **Nordvec Desktop > Informazioni su Nordvec Desktop**. * Linux: scegli **Guida > Informazioni su Nordvec Desktop**. * Ad ogni avvio, viene scritta anche una riga che inizia con `app_ready version=` nel file di log, seguita dalla versione. ## Segnalazione di un problema [#segnalazione-di-un-problema] Controlla prima i [problemi noti](/docs/guides/desktop/known-issues). Per segnalare un bug, includi la versione dell'app e, se possibile, il file di log. L'app è scritta in modo da non registrare nomi di file, percorsi o contenuti dei file, ma leggi il log prima di condividerlo e rimuovi tutto ciò che non vuoi inviare. --- # Problemi noti dell'app desktop Source: https://nordvec.com/it/docs/guides/desktop/known-issues Perché l'app desktop di Nordvec rifiuta una cartella, salta un file, mantiene una rimozione o smette di sincronizzare, e cosa fare per ciascun caso. Ogni voce qui sotto è una decisione che l'app desktop prende intenzionalmente. Questa pagina è generata dai codici con cui l'app decide, quindi ogni codice di rifiuto che può segnalare è elencato qui con la sua causa e una soluzione alternativa. Se ciò che vedi non è presente, [segnalalo](/docs/guides/desktop/install-and-data#reporting-a-problem) con la versione della tua app e il file di log. ## Cartelle che l'app non aggiungerà [#cartelle-che-lapp-non-aggiungerà] L'app rifiuta queste cartelle quando le selezioni, e spiega il motivo. ### Non è possibile aggiungere un'intera unità [#non-è-possibile-aggiungere-unintera-unità] Cosa vedi: **Un'intera unità è troppo ampia per la sincronizzazione. Scegli una cartella al suo interno.** **Causa:** La radice di un'unità contiene molto più che documenti, e monitorarla costringerebbe ogni scansione e rimozione a percorrere l'intera unità. **Soluzione alternativa:** Aggiungi le cartelle su quell'unità che contengono i tuoi documenti, una alla volta. ### Non è possibile aggiungere la tua cartella home [#non-è-possibile-aggiungere-la-tua-cartella-home] Cosa vedi: **La cartella del tuo account contiene dati delle app e impostazioni oltre ai documenti, e il suo nome è il nome dell'account del computer. Scegli Documenti, Desktop o un'altra cartella al suo interno.** **Causa:** La tua cartella home contiene dati delle app, impostazioni e cache oltre ai documenti, quindi monitorarla li includerebbe tutti in Nordvec. Inoltre, il suo nome corrisponde al nome del tuo account computer. **Soluzione alternativa:** Aggiungi invece Documenti, Desktop o un'altra cartella all'interno della tua cartella home. ### Non è possibile aggiungere una cartella all'interno o intorno a una cartella monitorata [#non-è-possibile-aggiungere-una-cartella-allinterno-o-intorno-a-una-cartella-monitorata] Cosa vedi: **Questa cartella si sovrappone a una cartella che stai già monitorando.** **Causa:** Un file in due cartelle monitorate avrebbe due proprietari, e un insieme di esclusioni impostato su una cartella non si applicherebbe attraverso l'altra. **Soluzione alternativa:** I file in una cartella all'interno di una cartella monitorata sono già sincronizzati, quindi non c'è nulla da aggiungere. Per monitorare una cartella più ampia, smetti prima di monitorare quella più ristretta: i suoi documenti lasceranno Nordvec finché la cartella più ampia non li sincronizzerà di nuovo. ## File che non vengono sincronizzati [#file-che-non-vengono-sincronizzati] Questi file rimangono sul tuo computer e sono elencati nella pagina di sincronizzazione Desktop con il motivo, quindi le risposte non possono citarli. ### Il percorso di un file è troppo lungo [#il-percorso-di-un-file-è-troppo-lungo] Cosa vedi: **Il percorso è troppo lungo per questo sistema** **Causa:** Il percorso completo è più lungo di quanto il sistema operativo consenta all'app di leggere. **Soluzione alternativa:** Accorcia i nomi delle cartelle o dei file, o sposta la cartella più vicino alla radice dell'unità. Il file verrà sincronizzato una volta che il suo percorso sarà abbastanza corto. ### Non è stato possibile leggere un file [#non-è-stato-possibile-leggere-un-file] Cosa vedi: **Impossibile leggere questo file** **Causa:** Il sistema operativo ha rifiutato all'app l'accesso in lettura al file. **Soluzione alternativa:** Concedi al tuo account utente l'accesso in lettura al file. Su macOS, consenti Nordvec Desktop in Impostazioni di Sistema, Privacy e Sicurezza, File e Cartelle. L'app leggerà di nuovo il file quando cambia e ogni volta che l'app viene avviata. ### Un elemento non è un file ordinario [#un-elemento-non-è-un-file-ordinario] Cosa vedi: **Questo non è un file ordinario** **Causa:** Si tratta di un collegamento simbolico, un dispositivo, una pipe o un altro file speciale. L'app legge solo file ordinari, quindi un collegamento non potrà mai portarla a un file che non hai selezionato. **Soluzione alternativa:** Aggiungi la cartella che contiene il file reale invece del collegamento. ### Un file ha più di un nome sul disco [#un-file-ha-più-di-un-nome-sul-disco] Cosa vedi: **Questo file ha più di un nome sul disco** **Causa:** Il file è un hard link: gli stessi dati hanno un secondo nome, che può trovarsi al di fuori della cartella che hai scelto. L'app non può determinare a quale cartella appartengano i dati, quindi non li legge. Gli strumenti di backup che risparmiano spazio in questo modo producono tali file. **Soluzione alternativa:** Sostituisci il file con una copia semplice, che ha un solo nome. ### Un file porta fuori dalla cartella monitorata [#un-file-porta-fuori-dalla-cartella-monitorata] Cosa vedi: **Questo file porta fuori dalla cartella monitorata** **Causa:** Il percorso del file si risolve, tramite un collegamento o una giunzione, in una posizione al di fuori della cartella che hai scelto. **Soluzione alternativa:** Aggiungi la cartella in cui il file si trova realmente. ### Un file si trova all'interno di una cartella che hai escluso [#un-file-si-trova-allinterno-di-una-cartella-che-hai-escluso] Cosa vedi: **Questo file si trova all'interno di una cartella che hai escluso** **Causa:** Hai escluso una sottocartella di una cartella monitorata, e un file che selezioni al suo interno rimane escluso. **Soluzione alternativa:** Riattiva la sottocartella nella scheda della cartella nella pagina di sincronizzazione Desktop, e i suoi file verranno sincronizzati. ### Un file supera il limite di dimensione per il suo tipo [#un-file-supera-il-limite-di-dimensione-per-il-suo-tipo] Cosa vedi: **Questo file supera il limite di dimensione per il suo tipo** **Causa:** Ogni tipo di file ha un limite di dimensione, verificato prima che il file venga letto. Se una versione precedente più piccola era stata sincronizzata, la sua copia viene rimossa in modo che le risposte non citino mai contenuti che il file non ha più. **Soluzione alternativa:** Suddividi il file in file più piccoli, o salvalo in un formato più compatto. ### Un file è vuoto [#un-file-è-vuoto] Cosa vedi: **Questo file è vuoto, quindi non c'è nulla da cercare** **Causa:** Un file senza contenuto non ha nulla da cercare. Se una versione precedente aveva contenuto, la sua copia viene rimossa per lo stesso motivo di uno troppo grande. **Soluzione alternativa:** Non c'è nulla da fare: il file verrà sincronizzato una volta che avrà contenuto. ### Un tipo di file non può essere cercato [#un-tipo-di-file-non-può-essere-cercato] Cosa vedi: **Questo tipo di file non può essere cercato** **Causa:** L'estensione del file non è tra quelle che l'app sincronizza. **Soluzione alternativa:** Salva o esporta il file come uno dei tipi presenti nella tabella dei limiti di dimensione alla fine di questa pagina. ### Non è stato possibile aggiungere un file [#non-è-stato-possibile-aggiungere-un-file] Cosa vedi: **Non è stato possibile aggiungere questo file** **Causa:** La lettura del file è fallita per un motivo diverso da quelli sopra elencati, ad esempio perché è cambiato o era bloccato mentre l'app lo leggeva. **Soluzione alternativa:** Chiudi qualsiasi cosa abbia il file aperto. L'app leggerà di nuovo il file quando cambia e ogni volta che l'app viene avviata. Se lo stesso file continua a fallire, segnalalo allegando il file di log. ## Rimozioni in attesa di conferma [#rimozioni-in-attesa-di-conferma] Niente viene rimosso da Nordvec mentre l'app non può distinguere una cancellazione da una cartella che è solo irraggiungibile. ### Molti file cancellati contemporaneamente rimangono in Nordvec finché non li confermi [#molti-file-cancellati-contemporaneamente-rimangono-in-nordvec-finché-non-li-confermi] Cosa vedi: **Cancellazione di massa in attesa di revisione** **Causa:** Quando più del 25% dei file di una cartella scompare entro 7 giorni (in una cartella di almeno 20 file), l'app trattiene la loro rimozione da Nordvec invece di eseguirla, perché una cartella spostata o scollegata appare identica a una cancellazione. **Soluzione alternativa:** Conferma la rimozione nella scheda della cartella nella pagina di sincronizzazione Desktop, o rimetti a posto i file. Una rimozione trattenuta che non confermi verrà eseguita alla data indicata nella pagina. ### Una cartella che non può essere letta mantiene i suoi documenti in Nordvec [#una-cartella-che-non-può-essere-letta-mantiene-i-suoi-documenti-in-nordvec] Cosa vedi: **Manca una cartella sincronizzata** **Causa:** Quando una cartella monitorata non può essere letta affatto, ad esempio su un'unità disconnessa o una condivisione di rete, l'app la tratta come irraggiungibile piuttosto che vuota e non rimuove nulla. **Soluzione alternativa:** Ricollega l'unità e la sincronizzazione riprenderà. Per rimuovere i documenti della cartella da Nordvec, smetti di monitorare la cartella. ## Documenti che lasciano Nordvec [#documenti-che-lasciano-nordvec] Un documento in Nordvec segue il suo file sul tuo computer. Questi sono i due modi in cui uno viene rimosso. ### Un documento ha lasciato Nordvec dopo che il suo file è stato spostato, rinominato o cancellato [#un-documento-ha-lasciato-nordvec-dopo-che-il-suo-file-è-stato-spostato-rinominato-o-cancellato] **Causa:** Un documento è in Nordvec perché il suo file si trova in una cartella monitorata. Quando il file viene cancellato o spostato fuori dalla cartella, la sua copia viene rimossa. Un file rinominato o spostato è un nuovo percorso, quindi viene sincronizzato di nuovo come un nuovo documento. **Soluzione alternativa:** Rimetti a posto il file, o aspetta che il file spostato venga sincronizzato. Un file che torna sul disco prima che venga eseguita la sua rimozione mantiene il suo documento. ### Documenti hanno lasciato Nordvec dopo che hai smesso di monitorare o escluso una cartella [#documenti-hanno-lasciato-nordvec-dopo-che-hai-smesso-di-monitorare-o-escluso-una-cartella] **Causa:** Smettere di monitorare una cartella, o escluderne una sottocartella, rimuove i suoi documenti da Nordvec. I file sul tuo computer non vengono toccati. **Soluzione alternativa:** Aggiungi di nuovo la cartella, o rimuovi l'esclusione, e i suoi file verranno sincronizzati di nuovo. ## Quando la sincronizzazione è disattivata [#quando-la-sincronizzazione-è-disattivata] Ognuna di queste situazioni interrompe la sincronizzazione per l'account connesso finché non viene risolta, e l'app indica quale. ### La sincronizzazione è disattivata perché il computer non ha un keyring [#la-sincronizzazione-è-disattivata-perché-il-computer-non-ha-un-keyring] Cosa vedi: **Nordvec cripta i tuoi dati di sincronizzazione locale con una chiave proveniente dal keyring del tuo sistema, e questo computer non ne ha uno disponibile. Installa e sblocca un keyring (gnome-keyring o kwallet), poi accedi di nuovo.** **Causa:** L'app cripta i suoi dati di sincronizzazione locale con una chiave protetta dal keychain del sistema operativo, e non ricorre mai alla memorizzazione dei nomi dei file in chiaro. Su Linux senza un gnome-keyring o KWallet in esecuzione, non c'è un keychain per contenere la chiave. **Soluzione alternativa:** Installa e sblocca gnome-keyring o KWallet, poi accedi di nuovo. ### La sincronizzazione è disattivata perché una versione più recente ha scritto i dati locali [#la-sincronizzazione-è-disattivata-perché-una-versione-più-recente-ha-scritto-i-dati-locali] Cosa vedi: **I tuoi dati di sincronizzazione sono stati scritti da una versione più recente di Nordvec. Aggiorna l'app per riprendere la sincronizzazione.** **Causa:** I dati di sincronizzazione locale sono stati scritti da una versione più recente dell'app, solitamente perché una versione precedente è stata installata sopra di essa. **Soluzione alternativa:** Installa l'ultima versione. ### La sincronizzazione è disattivata perché i dati di sincronizzazione locali non possono essere letti [#la-sincronizzazione-è-disattivata-perché-i-dati-di-sincronizzazione-locali-non-possono-essere-letti] Cosa vedi: **Impossibile leggere lo stato di sincronizzazione locale. La sincronizzazione è in pausa; potrebbe essere necessaria la reinstallazione.** **Causa:** Lo store di sincronizzazione non è stato possibile aprirlo o leggerlo, ad esempio perché il file è danneggiato o la sua chiave non può essere sbloccata da questo account utente. **Soluzione alternativa:** Segnalalo allegando il file di log. Non eliminare prima la directory dei dati: potrebbe contenere rimozioni che non hanno ancora raggiunto Nordvec. ## Limiti di dimensione dei file [#limiti-di-dimensione-dei-file] L'app sincronizza questi tipi di file, ciascuno fino alla dimensione indicata. Un file più grande viene elencato come troppo grande, e un tipo non presente in questa tabella come uno che non può essere cercato. | Dimensione massima del file | Tipi di file | | --------------------------- | ------------------------------------------------------------------ | | 50 MB | `.csv`, `.docx`, `.htm`, `.html`, `.pdf`, `.pptx`, `.xls`, `.xlsx` | | 20 MB | `.json`, `.xml` | | 15 MB | `.gif`, `.jpeg`, `.jpg`, `.png`, `.svg`, `.webp` | | 10 MB | `.md`, `.txt` | | 5 MB | `.js`, `.jsx`, `.py`, `.sql`, `.ts`, `.tsx` |