Una guida alla conversione delle 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 Estensioni di Chrome. Il lavoro di migrazione è suddiviso in grandi linee nelle seguenti categorie. Per aiutarti a monitorare il tuo lavoro, abbiamo fornito una checklist che riassume i contenuti di questi documenti. Puoi accedere ai contenuti utilizzando la checklist o esplorandoli. Entrambi i percorsi terminano con un'estensione di cui è stato eseguito l'upgrade.
- Aggiorna il manifest: il
manifest.jsondeve essere specifico per V3. Le modifiche che possono essere apportate autonomamente sono descritte in questa sezione. Le modifiche al manifest relative al codice sono descritte con le modifiche al codice che supportano. - Esegui la migrazione a un service worker: un service worker sostituisce la pagina di sfondo o degli eventi dell'estensione per garantire che il codice in background rimanga fuori dal thread principale, dove può influire sulle prestazioni. Questa modifica richiede anche lo spostamento di chiamate API DOM, finestra e di alcune estensioni in documenti offscreen.
- Chiamate API di aggiornamento: alcune chiamate API devono essere sostituite con equivalenti più moderni.
- Sostituisci i listener di richieste web di blocco: bloccare o modificare le 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 compromettere le prestazioni.
- Migliorare la sicurezza delle estensioni: Manifest V3 migliora la sicurezza delle estensioni in diversi modi. Oltre a una Content Security Policy migliorata, il supporto viene rimosso per il codice ospitato in remoto e l'esecuzione di stringhe arbitrarie.
- Pubblica l'estensione: questa sezione descrive come rilasciare l'estensione Manifest V3 in più fasi per assicurarti che funzioni come previsto testandola prima con un pubblico limitato.
Abbiamo anche uno strumento di conversione del manifest delle estensioni. Non fa tutto al posto tuo, ma ti aiuta a iniziare. Il file README del convertitore descrive le modifiche apportate dallo strumento.
Mantenere l'attuale insieme di funzionalità
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 potrebbe attivare un avviso relativo alle autorizzazioni, che disattiverà l'estensione finché l'utente non accetta le nuove autorizzazioni. Consulta Best practice per gli avvisi relativi alle autorizzazioni per scoprire altri modi per aggiungere autorizzazioni senza visualizzare un avviso.
Manifest V3 è supportato in generale in Chrome 88 o versioni successive. Quando aggiorni le chiamate API, potresti scoprire che le funzionalità di sostituzione potrebbero non essere state implementate in Chrome fino alla versione 88. Le pagine di riferimento dell'API contengono informazioni di assistenza per i singoli membri dell'API. Se scopri di aver bisogno di 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 che in Manifest V3. Non è obbligatorio utilizzarli durante la conversione, ma quando sostituiscono funzionalità precedenti, è consigliabile preferirli alle funzionalità che sostituiscono e prevedere che le funzionalità sostituite verranno ritirate e rimosse.