Utilizzare metodi di installazione alternativi

In genere, gli utenti di Chrome installano le estensioni visitando la relativa scheda nel Chrome Web Store e installando l'estensione direttamente da quella pagina. In alcuni casi, però, potrebbero essere più appropriati flussi di installazione diversi. Ad esempio:

  • Un'estensione è associata ad altri software e deve essere installata ogni volta che l'utente installa l'altro software.
  • Un amministratore di rete vuole installare le stesse estensioni in tutta l'organizzazione.

Per i casi precedenti, Google Chrome supporta i seguenti metodi di installazione delle estensioni:

Entrambi i modi supportano l'installazione di un'estensione ospitata in un update_URL. Su Windows e macOS, update_URL deve puntare al Chrome Web Store. Quando un'estensione viene installata con questi metodi, gli utenti di Windows e macOS dovranno attivarla utilizzando la seguente finestra di dialogo di conferma:

Avviso sulle estensioni esterne

Su Linux, il file delle preferenze può rimandare a un'estensione del Chrome Web Store, a un'estensione ospitata esternamente o a un file con estensione CRX sul computer dell'utente. Agli utenti Linux non verrà chiesto di abilitare l'estensione, che viene installata automaticamente.

Prima di iniziare

Installa dal Chrome Web Store

Se distribuisci un'estensione ospitata nel Chrome Web Store, devi prima pubblicarla. Quindi, prendi nota di quanto segue:

  • URL di aggiornamento: https://clients2.google.com/service/update2/crx. Questo URL rimanda al Chrome Web Store.
  • L'ID dell'estensione, che puoi trovare nell'URL del Chrome Web Store dell'estensione.

ID articolo del Chrome Web Store

Installa da file CRX locale

Se esegui la distribuzione a utenti Linux da un file locale, devi pacchettizzare un file CRX e prendere nota delle seguenti informazioni:

  • L'ID estensione: si trova nella pagina di gestione dell'estensione chrome://extensions.

  • La versione dell'estensione: viene visualizzata nella pagina di gestione dell'estensione chrome://extensions o nel file manifest JSON.

Come trovare l'ID e la versione dell'estensione

  • La posizione del file CRX: può essere una directory locale o una condivisione di rete. Assicurati che il file sia disponibile per il computer su cui vuoi installare l'estensione.

Installa da un server personale

Se distribuisci un'estensione ospitata su un server personale per utenti Linux, segui le istruzioni per Installazione delle estensioni su Linux e tieni presente le seguenti informazioni:

  • L'ID estensione: si trova nella pagina di gestione dell'estensione chrome://extensions.

  • Il percorso file XML update_url: deve corrispondere al percorso del campo update_url dichiarato nel file JSON manifest.

Gli esempi seguenti presuppongono che la versione sia 1.0 e che l'ID dell'estensione sia aaabbbCCdddeeefff.

Utilizzare un file delle preferenze

macOS

  1. Crea un file JSON con il nome dell'ID estensione. Ad esempio: aaabbbcccdddeeefff.json

  2. Inseriscilo in una delle seguenti cartelle:

    Per un utente specifico
    ~USERNAME/Library/Application Support/Google/Chrome/External Extensions/
    Per tutti gli utenti
    /Library/Application Support/Google/Chrome/External Extensions/

  3. Specifica l'URL di aggiornamento con il nome campo "external_update_url". Ad esempio: json { "external_update_url": "https://clients2.google.com/service/update2/crx" }

  4. Salva il file JSON.

  5. Avvia Google Chrome e vai all'indirizzo chrome://extensions; l'estensione dovrebbe essere visualizzata nell'elenco.

Risoluzione dei problemi relativi alle autorizzazioni di Mac OS

Su macOS, i file delle estensioni esterne per tutti gli utenti vengono letti solo se le autorizzazioni del file system impediscono agli utenti senza privilegi di modificarli. Se non vedi le estensioni esterne installate all'avvio di Chrome, potrebbe essersi verificato un problema di autorizzazione con i file delle preferenze delle estensioni esterne. Per verificare se è questo il problema, procedi nel seguente modo:

  1. Avvia il programma Console. Puoi trovarlo in /Applicazioni/Utility/Console.
  2. Se l'icona all'estrema sinistra della console indica "Mostra elenco log", fai clic sull'icona. Una seconda colonna è visualizzata a sinistra.
  3. Fai clic su "Messaggi della console" nel riquadro a sinistra.
  4. Cerca la stringa Impossibile leggere le estensioni esterne. Se si verifica un problema durante la lettura dei file delle estensioni esterne, verrà visualizzato un messaggio di errore. Cerca subito un altro messaggio di errore che dovrebbe spiegare il problema. Ad esempio, se viene visualizzato il seguente errore: "Il percorso /Libreria/Application Support/Google/Chrome è di proprietà del gruppo sbagliato", devi utilizzare chgrp o la finestra di dialogo Ottieni informazioni del Finder per cambiare il proprietario del gruppo della directory nel gruppo Amministratori.
  5. Dopo aver risolto il problema, riavvia Chrome. Verifica che l'estensione esterna sia installata. È possibile che un errore di autorizzazione impedisca a Chrome di rilevare un secondo errore. Se l'estensione esterna non è stata installata, ripeti questi passaggi finché non visualizzi un errore nell'applicazione Console.

Linux

  1. Crea un file JSON con il nome dell'ID estensione. Ad esempio: aaabbbcccdddeeefff.json.

  2. Inseriscilo in una delle seguenti cartelle:

    • /opt/google/chrome/extensions/
    • /usr/share/google-chrome/extensions/

  3. Il seguente elenco descrive l'installazione di estensioni dal Chrome Web Store, un file CRX o un server personale:

    • Per installare un'estensione del Chrome Web Store, specifica l'URL di aggiornamento con il nome campo "external_update_url". Ad esempio: json { "external_update_url": "https://clients2.google.com/service/update2/crx" }
    • Per installare l'estensione da un file CRX, specifica il percorso in "external_crx" e la versione in "external_version". Ad esempio: json { "external_crx": "/home/share/extension.crx", "external_version": "1.0" }
    • Per installare l'estensione ospitata su un server personale, il campo "external_update_url" deve puntare al file XML, come nell'esempio seguente: json { "external_update_url": "http://myhost.com/mytestextension/updates.xml" }

  4. Salva il file JSON.

  5. Avvia Google Chrome e vai all'indirizzo chrome://extensions; l'estensione dovrebbe essere visualizzata nell'elenco.

Impostazioni internazionali supportate

Se vuoi installare l'estensione solo per alcune impostazioni internazionali del browser, puoi elencare le impostazioni internazionali supportate nel nome campo "supported_locales". Le impostazioni internazionali potrebbero specificare le impostazioni internazionali principali, ad esempio "en". In questo caso l'estensione verrà installata per tutte le lingue inglesi, ad esempio "en-US", "en-GB" e così via. Se viene selezionata un'altra lingua del browser non supportata dall'estensione, le estensioni esterne verranno disinstallate. Se l'elenco "supported_locales" non è presente, l'estensione verrà installata per tutte le impostazioni internazionali. Ad esempio:

{
  "external_update_url": "https://clients2.google.com/service/update2/crx",
  "supported_locales": [ "en", "fr", "de" ]
}

Utilizzare il Registro di sistema di Windows

  1. Trova o crea la seguente chiave nel Registro di sistema:

    Windows a 32 bit
    HKEY_LOCAL_MACHINE\Software\Google\Chrome\Extensions
    Windows a 64 bit
    HKEY_LOCAL_MACHINE\Software\Wow6432Node\Google\Chrome\Extensions

  2. Crea una nuova chiave (cartella) nella chiave Estensioni con lo stesso nome dell'ID dell'estensione. Ad esempio: aaabbbcccdddeeefff.

  3. Nella chiave dell'estensione, crea una proprietà "update_url" e impostala sul seguente valore: json { "update_url": "https://clients2.google.com/service/update2/crx" }

  4. Avvia Chrome.

  5. Vai alla pagina chrome://extensions; dovresti vedere l'estensione nell'elenco.

Aggiornamento e disinstallazione

Google Chrome analizza le voci dei metadati nelle preferenze e nel registro a ogni avvio del browser e apporta le modifiche necessarie alle estensioni esterne installate ospitate nel Chrome Web Store.

Per aggiornare l'estensione di un file CRX locale a una nuova versione, aggiorna il file, quindi aggiorna la versione nel file JSON delle preferenze.

Per disinstallare l'estensione (ad esempio, se il software è stato disinstallato), rimuovi il file delle preferenze (ad esempio aaabbbcccdddeeefff.json) o i metadati dal registro.

Domande frequenti

Questa sezione risponde alle domande più comuni sulle estensioni esterne.

La funzionalità "preinstallazione" è ancora supportata da Google Chrome?

Sì, ma solo come installazione da un update_url del Chrome Web Store, non da un percorso CRX locale. Per ulteriori informazioni, consulta l'articolo Norme relative ad app ed estensioni.

Quali sono alcuni errori comuni che si verificano durante l'installazione con il file delle preferenze?

  • Non specificare lo stesso ID o la stessa versione di quelli elencati nel file CRX.
  • Il file JSON (ad esempio, aaabbbcccdddeeefff.json) si trova nella posizione errata o l'ID specificato non corrisponde all'ID estensione.
  • Errore di sintassi nel file JSON (dimenticare di separare le voci con una virgola o lasciare una virgola finale da qualche parte).
  • L'ingresso nel file JSON rimanda al percorso errato del file CRX (o il percorso specificato, ma nessun nome file)
  • Le barre rovesciate nel percorso UNC non contengono caratteri di escape. Ad esempio, "\\server\share\file" non è corretto; deve essere "\\\\server\\share\\extension".
  • Problemi relativi alle autorizzazioni su una condivisione di rete.

Quali sono alcuni errori comuni che si verificano durante l'installazione con il registro?

  • Non specificare lo stesso ID di quello elencato nel Chrome Web Store.
  • Chiave creata nella posizione errata del registro.
  • Le voci di registro del registro rimandano al percorso sbagliato del file CRX nel Chrome Web Store.
  • Problemi relativi alle autorizzazioni su una condivisione di rete.
  • Non tutte le istanze di Chrome sono chiuse. Prova a riavviare il computer dopo aver configurato il Registro di sistema.

Che cosa succede se l'utente disinstalla l'estensione?

Se l'utente disinstalla l'estensione tramite l'interfaccia utente, questa non verrà più installata o aggiornata a ogni avvio. In altre parole, l'estensione esterna viene inserita in una lista bloccata.

Come posso uscire dalla lista bloccata?

Se l'utente disinstalla l'estensione, devi rispettare la decisione. Tuttavia, se tu (lo sviluppatore) hai disinstallato per errore l'estensione tramite l'interfaccia utente, puoi rimuovere il tag della lista bloccata installando l'estensione normalmente tramite l'interfaccia utente e poi disinstallandola.