Linee guida sugli avvisi di autorizzazione

Le estensioni di Chrome migliorano l'esperienza dell'utente sul browser. A tale scopo, utilizza le API di Chrome che richiedono determinate autorizzazioni. Alcune autorizzazioni sono meno invasive e non mostrano un avviso. Altre autorizzazioni attivano un avviso che gli utenti devono consentire. Questa pagina fornisce linee guida per utilizzare gli avvisi di autorizzazione. Gli avvisi specifici sono indicati nella sezione Autorizzazioni nell'autorizzazione a cui si applicano.

Figura 1: finestra di dialogo degli avvisi sulle autorizzazioni visualizzata al momento dell'installazione.

Quando viene aggiunta una nuova autorizzazione che attiva un avviso, l'estensione viene disattivata finché l'utente non accetta la nuova autorizzazione. Per scoprire come testare questo comportamento, consulta Aggiornamento delle autorizzazioni.

Figura 2: un'estensione che viene disattivata finché l'utente non accetta la nuova autorizzazione.

Alcune autorizzazioni potrebbero non mostrare avvisi se associate ad altre autorizzazioni. Ad esempio, l'avviso "tabs" non viene mostrato se l'estensione richiede anche la "<all_urls>".

Best practice

Gli avvisi di autorizzazione descrivono le funzionalità concesse da un'API, ma alcuni sono più difficili da comprendere rispetto ad altri. Gli utenti sono più propensi a installare estensioni che seguono queste linee guida:

Richiedi le autorizzazioni pertinenti

Le estensioni sono necessarie per soddisfare un singolo scopo e rispettare il criterio relativo all'uso delle autorizzazioni. Assicurati di richiedere solo autorizzazioni che supportano la funzionalità principale dell'estensione.

Utilizza autorizzazioni facoltative

Migliora l'esperienza di onboarding richiedendo le autorizzazioni in fase di runtime. In questo modo puoi fornire più contesto su una determinata autorizzazione e consentire agli utenti di scegliere quali funzionalità attivare. Per i dettagli dell'implementazione, consulta API Permissions.

Utilizzare l'autorizzazione "activeTab"

Questa autorizzazione non mostra un avviso relativo alle autorizzazioni. Concede l'autorizzazione di hosting temporaneo al sito su cui si trova l'utente. Per maggiori dettagli, consulta Informazioni sull'autorizzazione activeTab.

Visualizza avvisi

Per visualizzare gli avvisi relativi alle autorizzazioni di un'estensione, hai a disposizione le seguenti opzioni:

Utilizzare lo strumento di test dell'aggiornamento delle estensioni

Prima di iniziare

1. Installa Node.js e Gestione dei partner di rete.
2. Installa Chromium.
3. Clona il repository extension-update-testing-tool.
4. Esegui npm install nella directory radice del repository.

Utilizzo dello strumento

1. Esegui npm start.
2. Apri il server locale all'indirizzo http://localhost:8080 in Chromium.
3. Trascina un'estensione non pacchettizzata (cartella o file ZIP) sulla pagina.
4. Segui le istruzioni riportate nella sezione "Installa manualmente" per scaricare e installare l'estensione.

Comprimendo manualmente l'estensione

1. Vai a chrome://extensions
2. Attiva modalità sviluppatore
3. Fai clic su Crea pacchetto estensione.

   

   Figura 3: modalità sviluppatore attivata nella pagina Gestione estensioni

4. Specifica il percorso della cartella dell'estensione nel campo della directory principale dell'estensione. Ignora il campo Chiave privata per il pacchetto la prima volta.

5. Fai clic sul pulsante Crea pacchetto estensione.

   

   Figura 4: specifica del percorso dell'estensione

6. Chrome creerà due file, un file .crx e un file .pem. Il file .pem contiene la chiave privata utilizzata per firmare l'estensione. Assicurati di ricordare in quale directory sono stati salvati questi file.

   

   Figura 5: file di estensioni in pacchetto

7. Conserva il file .pem in un luogo segreto e protetto; sarà necessario per aggiornare l'estensione.

8. Installa il file .crx trascinandolo nella pagina Gestione dell'estensione.

   

   Figura 6: trascina il file da installare

9. Dopo aver eliminato il file .crx, il browser chiederà se è possibile aggiungere l'estensione e mostrerà avvisi.

   

   Figura 7: avviso per l'estensione Nuova scheda

Aggiorna autorizzazioni

Quando un'estensione aggiunge una nuova autorizzazione che attiva un avviso, potrebbe disabilitarla temporaneamente. L'estensione verrà riattivata solo dopo che l'utente ha accettato di accettare la nuova autorizzazione.

Per verificare se l'estensione verrà disattivata quando aggiungi una nuova autorizzazione, hai a disposizione le seguenti opzioni:

Eseguire l'aggiornamento utilizzando lo strumento di test dell'aggiornamento delle estensioni

Questi passaggi presuppongono che tu abbia seguito le istruzioni relative all'utilizzo dello strumento di test dell'aggiornamento delle estensioni per avviare il server.

Utilizzo dello strumento

1. Aggiungi una nuova autorizzazione con avviso.
2. Aumentare il numero di versione dell'estensione.
3. Trascina l'estensione non pacchettizzata (cartella o file ZIP) nella pagina.
4. Vai a chrome://extensions.
5. Fai clic sul pulsante Aggiorna.

Aggiornare manualmente l'estensione

1. Individua il file .crx appena creato in Visualizza avvisi.
2. Rinominalo o eliminalo.
3. Apri manifest.json e aggiungi qualsiasi autorizzazione che attivi un avviso.
4. Vai a chrome://extensions. Non rimuovere il pacchetto installato in precedenza.
5. Comprimi nuovamente l'estensione, ma questa volta aggiungi il file pem nel secondo input.

   

   Figura 8: finestra di dialogo dell'estensione di compressione con il file pem incluso.

6. Trascina la nuova estensione in pacchetto nella pagina Gestione estensioni.

7. Verrà visualizzata una finestra di dialogo in cui viene chiesto all'utente di accettare le nuove autorizzazioni.

   

   Figura 9: avviso di estensioni disattivate

   

   Figura 10: finestra di dialogo Richiesta di nuova autorizzazione