Aggiorna le tue estensioni in vista delle prossime modifiche alla sincronizzazione dei preferiti

James Lee
James Lee

Data di pubblicazione: 17 giugno 2025

Lo scorso agosto abbiamo annunciato le prossime modifiche al modello di identità di Chrome sulle piattaforme Windows, Mac e Linux, in seguito a quelle già lanciate su iOS e Android. Lo scopo di queste modifiche è allineare Chrome alle attuali aspettative degli utenti in merito all'accesso. Gli utenti si aspettano sempre più di accedere per avere accesso ai propri contenuti, inclusi i preferiti, e di uscire per mantenerli al sicuro.

Nell'ambito dell'implementazione di questi aggiornamenti, stiamo introducendo modifiche al modo in cui Chrome memorizza i preferiti sul computer. I preferiti, ad esempio, archiviati localmente su un dispositivo rimarranno locali al momento dell'accesso; gli utenti possono scegliere facoltativamente di caricare questi dati sul proprio Account Google singolarmente o in blocco. Per consentire alle estensioni di supportarli, stiamo esponendo nuovi dati nell'API Chrome Extensions. Le seguenti informazioni sono pertinenti per tutti gli autori di estensioni di Chrome che utilizzano l'API chrome.bookmarks.

Panoramica

Oggi gli utenti hanno sempre un unico insieme di cartelle di primo livello, tra cui le cartelle "Barra dei preferiti" e "Altri preferiti". I dati in queste cartelle potrebbero essere sincronizzati o meno a seconda che l'utente abbia eseguito l'accesso con la sincronizzazione attivata.

Nell'ambito delle modifiche al modello di identità, Chrome separerà i preferiti sincronizzati e non sincronizzati in due sottoalberi distinti nell'albero dei preferiti. In alcuni casi in cui un utente non ha scelto di caricare tutti i suoi preferiti nel proprio account, può avere contemporaneamente cartelle di preferiti sincronizzate e non sincronizzate. Le estensioni che utilizzano l'API per i preferiti potrebbero dover essere aggiornate per visualizzare l'albero dei preferiti in modo chiaro per gli utenti.

Modifiche dettagliate alle API

Per gli utenti con un mix di preferiti sincronizzati e non sincronizzati, l'API Bookmarks potrebbe restituire una struttura ad albero simile alla seguente nell'API getTree:

  • id=A (name: "Barra dei preferiti", folderType: "bookmarks-bar", syncing: true)
    • …
  • id=B (name: "Altri segnalibri", folderType: "other", syncing: true)
    • …
  • id=C (name: "Barra dei preferiti", folderType: "bookmarks-bar", syncing: false)
    • …
  • id=D (name: "Altri segnalibri", folderType: "other", syncing: false)
    • …

Per consentire agli sviluppatori di estensioni di distinguere queste cartelle di primo livello, sono state aggiunte due nuove proprietà all'API:

  • folderType: consente alle estensioni di identificare le cartelle "speciali", come la barra dei preferiti. Tieni presente che name e id non devono essere utilizzati a questo scopo (name dipende dalle impostazioni internazionali e id non è fisso).
  • syncing: per consentire alle estensioni di distinguere le parti dell'albero che vengono sincronizzate da quelle che non vengono sincronizzate. Questo valore sarà true prima delle modifiche al modello di identità se l'utente ha eseguito l'accesso e ha attivato la sincronizzazione.

Aggiornamenti delle estensioni

Se una delle seguenti condizioni si verifica per la tua estensione, potresti dover apportare degli aggiornamenti:

  • Se la tua estensione mostra all'utente il risultato completo di getTree per impedire la visualizzazione di versioni con lo stesso nome, ad esempio la barra dei preferiti. Potresti voler aggiungere un suffisso al nome o fornire un altro trattamento dell'interfaccia utente.
  • Se la tua estensione tenta di trovare una corrispondenza con le cartelle permanenti Altri, Barra dei preferiti o Mobile tramite id o name. Questi metodi non erano già supportati.
  • Se la tua estensione presuppone che esista esattamente o al massimo un'istanza delle cartelle permanenti della barra dei preferiti, Altro o mobile

Test

Le nuove proprietà dell'API delle estensioni folderType e syncing sono documentate e disponibili nell'ultima release di Chrome Canary (versione 138.0.7196.0 o successive).

Gli utenti dei canali Chrome stabili hanno un unico spazio di archiviazione (ovvero al massimo uno per ogni tipo di cartella). A scopo di test, puoi abilitare la doppia archiviazione nel seguente modo:

  1. Attiva entrambi i seguenti flag in chrome://flags e riavvia Chrome
    • sync-enable-bookmarks-in-transport-mode
    • enable-bookmarks-selected-type-on-signin-for-testing
  2. Aggiungi un nuovo profilo Chrome (https://support.google.com/chrome/answer/2364824)
    • Non accedere: scegli "Continua senza un account".
  3. Se aggiungi pagine ai preferiti, queste verranno aggiunte allo spazio di archiviazione non sincronizzato.
  4. Ora accedi a Chrome:
    • Fai clic sull'immagine dell'avatar in alto a destra, accanto al menu con tre puntini.
    • Fai clic su "Accedi a Chrome" e segui le istruzioni.
    • Scegli "No, grazie" quando ti viene chiesto se vuoi attivare la sincronizzazione.
  5. Se aggiungi pagine ai preferiti, queste verranno aggiunte allo spazio di archiviazione della sincronizzazione (consentendoti di testare lo scenario di archiviazione doppia).

Sequenze temporali

Le modifiche per esporre i due spazi di archiviazione verranno implementate gradualmente e inizieranno a essere implementate per un sottoinsieme di utenti del canale Chrome Stable non prima della fine di giugno 2025, a partire da una piccola percentuale di utenti e poi in modo più ampio nelle settimane successive.