Esegui la migrazione a Manifest V3

Una guida per convertire le estensioni Manifest V2 in estensioni Manifest V3.

Questa sezione ti aiuta a eseguire l'upgrade di un'estensione da Manifest V2 a Manifest V3, la versione più recente della piattaforma Chrome Extensions. Il lavoro di migrazione è generalmente suddiviso nelle seguenti categorie. Per aiutarti a tenere traccia del tuo lavoro, abbiamo fornito un elenco di controllo che riassume i contenuti di questi documenti. Puoi accedere ai contenuti tramite l'elenco di controllo o immergerti nei contenuti. Entrambi i percorsi terminano con un'estensione aggiornata.

  • Aggiorna il file manifest: manifest.json deve essere specifico della versione 3. Le modifiche che possono essere apportate autonomamente sono descritte in questa sezione. Le modifiche del manifest relative al codice sono descritte insieme alle modifiche al codice supportate.
  • Migrazione a un service worker: un service worker sostituisce la pagina dello sfondo o dell'evento dell'estensione per garantire che il codice in background rimanga al di fuori del thread principale dove può compromettere le prestazioni. Questa modifica richiede anche lo spostamento di DOM, finestre e chiamate API di determinate estensioni nei documenti fuori schermo.
  • Aggiorna le chiamate API: alcune chiamate API devono essere sostituite con altri equivalenti più moderni.
  • Sostituisci il blocco dei listener di richieste web: il blocco o la modifica delle richieste di rete in Manifest V2 potrebbe ridurre significativamente le prestazioni e richiedere un accesso eccessivo ai dati utente sensibili. L'API Declarative Net Request consente alle estensioni di bloccare o modificare i contenuti web con meno autorizzazioni e senza ostacolare le prestazioni.
  • Miglioramento della sicurezza delle estensioni: Manifest V3 migliora la sicurezza delle estensioni in diversi modi. Oltre a un criterio di sicurezza avanzata dei contenuti, viene rimosso il supporto per il codice ospitato in remoto e l'esecuzione di stringhe arbitrarie.
  • Pubblica l'estensione: questa sezione descrive come eseguire un'implementazione graduale per garantire che l'estensione Manifest V3 funzioni come previsto, testndola prima con un pubblico limitato.

È disponibile anche uno strumento per la conversione dei file manifest delle estensioni. Non fa tutto al posto tuo, ma ti aiuterà a iniziare. Il file README del convertitore descrive cosa cambia lo strumento.

Mantenere l'insieme di funzionalità corrente

Per ridurre le probabilità di problemi o bug imprevisti, ti consigliamo di non aggiungere nuove funzionalità durante la migrazione. Ad esempio, l'aggiunta di una funzionalità che richiede nuove autorizzazioni può attivare un avviso di autorizzazione, che disattiverà l'estensione finché l'utente non accetta le nuove autorizzazioni. Consulta le Best practice per gli avvisi di autorizzazione per scoprire altri modi per aggiungere autorizzazioni senza visualizzare un avviso.

Manifest V3 è generalmente supportato in Chrome 88 o versioni successive. Durante l'aggiornamento delle chiamate API, potresti scoprire che le funzionalità sostitutive potrebbero non essere disponibili in Chrome fino alla versione 88. Le pagine di riferimento delle API contengono informazioni di supporto per i singoli membri dell'API. Se ti serve una di queste funzionalità, puoi specificare una versione minima di Chrome nel file manifest.

Nuove funzionalità della piattaforma di estensioni

Dal rilascio di Manifest V3, abbiamo continuato ad aggiungere nuove funzionalità, molte delle quali sono utilizzabili sia in Manifest V2 sia in Manifest V3. Non è obbligatorio utilizzarle durante la conversione; tuttavia, quando sostituiscono le funzionalità precedenti, è preferibile preferirle alle funzionalità che sostituiscono e aspettarti che vengano ritirate e rimosse.