Utilizzare metodi di installazione alternativi

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

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

Nota: gli amministratori possono anche utilizzare i criteri aziendali per gestire l'installazione delle estensioni. Per saperne di più, consulta le norme relative alle estensioni Enterprise.

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

• Utilizzo di un file JSON delle preferenze (solo per macOS X e Linux)
• Utilizzare il Registro di sistema di Windows (solo per Windows)

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

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

Avviso: le installazioni su Windows e Mac devono provenire dal Chrome Web Store: a partire da Chrome 33, non sono consentite installazioni esterne da un percorso a un file CRX locale su Windows (consulta Proteggere gli utenti Windows dalle estensioni dannose). A partire da Chrome 44, non sono consentite installazioni esterne da un percorso a un file CRX locale su Mac OS (vedi Continuare a proteggere gli utenti di Chrome dalle estensioni dannose).

Prima di iniziare

Installare dal Chrome Web Store

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

• L'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.

Installa da file CRX locale

Se distribuisci il pacchetto agli utenti Linux da un file locale, devi eseguire il packaging di un file CRX e prendere nota delle seguenti informazioni:

• L'ID estensione, che puoi trovare nella pagina di gestione delle estensioni chrome://extensions.

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

• 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.

Installazione da un server personale

Se stai distribuendo un'estensione ospitata su un server personale per gli utenti Linux, devi seguire le istruzioni per l'installazione delle estensioni su Linux e prendere nota delle seguenti informazioni:

• L'ID estensione, disponibile nella pagina di gestione delle estensioni chrome://extensions.

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

Gli esempi riportati di seguito presuppongono che la versione sia la 1.0 e che l'ID estensione sia aaabbb presodddeeefff.

Utilizzare un file delle preferenze

Nota: solo macOS X e Linux: non utilizzare il file delle preferenze per Windows. Utilizza invece il Registro di sistema di Windows.

macOS

1. Crea un file JSON con il nome dell'ID dell'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 del 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 elencata.

Nota: il file dell'estensione esterna per tutti gli utenti è di sola lettura se ogni directory nel percorso è di proprietà dell'utente root, appartiene al gruppo admin o wheel e non è scrivibile da tutti. Il percorso deve inoltre essere libero da link simbolici. Queste limitazioni impediscono a un utente senza privilegi di installare estensioni per tutti gli utenti. Consulta la sezione Risolvere i problemi relativi alle autorizzazioni.

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 al momento dell'avvio di Chrome, potrebbe esserci un problema di autorizzazione con i file delle preferenze delle estensioni esterne. Per verificare se è questo il problema, segui questi passaggi:

1. Avvia il programma Console. Puoi trovarlo in /Applications/Utilities/Console.
2. Se l'icona più a sinistra nella console indica "Mostra elenco di log", fai clic su quell'icona. Viene visualizzata una seconda colonna 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, viene visualizzato un messaggio di errore. Cerca un altro messaggio di errore direttamente prima, che dovrebbe spiegare il problema. Ad esempio, se viene visualizzato il seguente errore: "Il percorso /Library/Application Support/Google/Chrome è di proprietà del gruppo sbagliato", devi utilizzare chgrp o la finestra di dialogo Informazioni del Finder per impostare il gruppo proprietario della directory sul gruppo Amministratore.
5. Dopo aver risolto il problema, riavvia Chrome. Verifica che l'estensione esterna sia ora installata. È possibile che un errore di autorizzazione impedisca a Chrome di rilevare un secondo errore. Se l'estensione esterna non è installata, ripeti questi passaggi finché non viene visualizzato alcun errore nell'applicazione Console.

Linux

1. Crea un file JSON con il nome dell'ID dell'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 delle estensioni dal Chrome Web Store, da un file CRX o da un server personale:

   • Per installare un'estensione del Chrome Web Store, specifica l'URL di aggiornamento con il nome del 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 la posizione 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 elencata.

Nota: se necessario, utilizza chmod per assicurarti che i file aaabbbcccdddeeefff.json siano leggibili da tutti. Per ulteriore assistenza, consulta le domande frequenti relative agli errori più comuni nei file delle preferenze.

Impostazioni internazionali supportate

Se vuoi installare l'estensione solo per alcune lingue del browser, puoi elencare le lingue supportate nel nome del campo "supported_locales". La lingua può specificare la lingua principale, ad esempio "it", in questo caso l'estensione verrà installata per tutte le lingue italiane, ad esempio "it-IT", "it-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 qualsiasi lingua. 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) sotto la chiave Extensions con lo stesso nome dell'ID della tua 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 a chrome://extensions. L'estensione dovrebbe essere elencata.

Nota: per ulteriore assistenza, consulta gli errori comuni del registro di Windows.

Aggiornamento e disinstallazione

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

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

Per disinstallare l'estensione (ad esempio se il software viene 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 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, vedi Criteri relativi ad app ed estensioni.

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

• Non specificare lo stesso ID o versione di quello elencato nel file CRX.
• Il file JSON (ad es. aaabbbcccdddeeefff.json) non si trova nella posizione corretta o l'ID specificato non corrisponde all'ID estensione.
• Errore di sintassi nel file JSON (dimenticando di separare le voci con una virgola o di lasciare una virgola finale da qualche parte).
• La voce del file JSON rimanda al percorso errato del file CRX (o al percorso specificato, ma senza nome file)
• Le barre diagonali nel percorso UNC non vengono sottoposte a escape. Ad esempio, "\\server\share\file" è errato; dovrebbe essere "\\\\server\\share\\extension".
• Problemi relativi alle autorizzazioni in una condivisione di rete.

Quali sono alcuni errori comuni durante l'installazione con il registry?

• Non specificare lo stesso ID indicato nel Chrome Web Store.
• Chiave creata nella posizione errata del Registro di sistema.
• La voce del registro punta al percorso errato del file CRX nel Chrome Web Store.
• Problemi di autorizzazione in una condivisione di rete.
• Non tutte le istanze di Chrome sono chiuse. Prova a riavviare il computer dopo aver impostato 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 è inserita nella lista bloccata.

Come faccio a uscire dalla lista bloccata?

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