Elenco di controllo per la migrazione di Manifest V3

Monitora l'avanzamento della migrazione

Gli elenchi di controllo riportati di seguito possono aiutarti a tenere traccia del tuo lavoro di migrazione. Definiscono le attività che devono essere completate con link alle istruzioni. Il lavoro di migrazione è ampiamente suddiviso in cinque categorie, come descritto nel Riepilogo della migrazione.

Aggiorna il manifest

Il file manifest.json richiede un formato leggermente diverso per Manifest V3 rispetto a Manifest V2. In questa pagina vengono descritte le modifiche che interessano solo il file manifest.json. Tuttavia, molte delle modifiche apportate agli script e alle pagine richiedono anche la modifica del file manifest. Queste modifiche vengono trattate con le attività di migrazione che le richiedono.

• Cambia il numero di versione del manifest.
• Aggiorna le autorizzazioni dell'host.
• Aggiornare le risorse accessibili dal web.

Migrazione a un service worker

Un service worker sostituisce lo sfondo o la pagina degli eventi dell'estensione per garantire che il codice in background rimanga fuori dal thread principale. In questo modo le estensioni possono essere eseguite solo quando necessario, risparmiando risorse.

Prima di iniziare, leggi le differenze tra gli script in background e i service worker delle estensioni.

• Aggiornare il campo "in background" nel file manifest
• Spostare le chiamate DOM e della finestra in un documento fuori schermo
• Converti localStorage in chrome.storage.local
• Registrare i listener in modo sincrono
• Sostituisci le chiamate a XMLHttpRequest() con il valore globale fetch().
• Stati persistenti
• Convertire i timer in sveglie
• Mantenere attivo il service worker (in casi eccezionali)

Aggiorna chiamate API

Alcune funzionalità devono essere sostituite con versioni equivalenti a Manifest V3. Altre devono essere rimosse completamente.

• Sostituisci tabs.executeScript() con scripting.executeScript().
• Sostituisci tabs.insertCSS() e tabs.removeCSS() con scripting.insertCSS() e scripting.removeCSS().
• Sostituire le azioni del browser e le azioni sulla pagina con le azioni
• Sostituisci le funzioni che prevedono un contesto in background Manifest V2.
• Sostituire i callback con promesse
• Sostituire le API non supportate

Sostituisci il blocco dei listener di richieste web

Invece di leggere in modo programmatico le richieste di rete e modificarle (come hai fatto in Manifest V2), l'estensione specifica le regole che descrivono le azioni da eseguire quando è soddisfatto un determinato insieme di condizioni.

• Aggiorna autorizzazioni
• Creare regole di richiesta netta dichiarative

Dopo aver completato i passaggi precedenti, ti consigliamo di esaminare alcuni casi d'uso comuni:

• Bloccare un singolo URL
• Reindirizzamento-di-più-URL
• Bloccare i cookie

Migliorare la sicurezza delle estensioni

Sono necessarie modifiche per migliorare la sicurezza delle estensioni. Ciò include la rimozione del codice ospitato in remoto, che non è più supportato.

• Rimuovi l'esecuzione di stringhe arbitrarie.
• Rimuovere il codice ospitato in remoto
• Aggiorna i criteri di sicurezza dei contenuti.
• Rimuovere i valori dei criteri di sicurezza dei contenuti non supportati

Pubblicare l'estensione Manifest V3

Dopo la conversione alla versione 3 di Manifest, è il momento di rilasciare l'estensione sul Chrome Web Store. A seconda delle modifiche apportate, valuta l'implementazione graduale. Questo approccio ti consente di assicurarti che l'estensione funzioni come previsto con un pubblico limitato prima di rilasciarla per l'intera base utenti.

• Pubblica una versione di beta test.
• Implementa la release gradualmente.
• Pianifica i tempi di revisione.
• Ulteriori suggerimenti.