Opzioni di distribuzione alternative delle estensioni

Tutte le estensioni di Chrome devono essere distribuite direttamente dal Chrome Web Store o tramite il i meccanismi descritti di seguito. Il mancato rispetto di uno di questi metodi di distribuzione costituisce una violazione dei criteri relativi alle estensioni di Chrome e potrebbe causare l'estensione e/o il software che lo distribuirà affinché venga contrassegnato come software indesiderato.

In genere, gli utenti installano estensioni dal Chrome Web Store, ma a volte potrebbe essere utile da installare con altri mezzi. Di seguito sono riportati due casi tipici:

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

Un'estensione non installata dal Chrome Web Store viene chiamata estensione esterna. Per gli sviluppatori che desiderano distribuire un'estensione nell'ambito della procedura di installazione per altri o per gli amministratori di rete che vogliono distribuire un'estensione nell'intera organizzazione, Google Chrome supporta i seguenti metodi di installazione delle estensioni:

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

Entrambi i modi supportano l'installazione di un'estensione ospitata su un update_URL. Su Windows e Mac, il update_URL deve indirizzare al Chrome Web Store in cui deve essere ospitata l'estensione.

Il file delle preferenze su Linux può puntare al tuo server su cui ospiti l'estensione. Il file JSON delle preferenze supporta anche l'installazione di un'estensione da un file di estensione .crx sul computer Linux dell'utente.

Prima di iniziare

Innanzitutto, pubblica l'estensione nel Chrome Web Store o crea un pacchetto con un file .crx e crea un pacchetto per assicurarti che venga installato correttamente.

Se esegui l'installazione da un URL di aggiornamento, assicurati che l'estensione sia correttamente ospitata.

Prima di modificare il file delle preferenze o il Registro di sistema, tieni presente quanto segue:

  • La posizione prevista del file .crx dell'estensione o l'URL di aggiornamento da cui proviene pubblicato
  • La versione dell'estensione (dal file manifest o dalla pagina chrome://extensions)
  • L'ID dell'estensione (dalla pagina chrome://extensions dopo aver caricato la estensione)

Gli esempi seguenti presuppongono che la versione sia 1.0 e l'ID sia aaaaaaaaaabbbbbbbbbbcccccccccc.

Utilizzo di un file delle preferenze

  1. Se esegui l'installazione da un file su Linux, rendi il file dell'estensione .crx disponibile per computer su cui vuoi installare l'estensione. (copialo in una directory locale o in una rete ad esempio \\server\share\extension.crx o /home/share/extension.crx.)

  2. Crea un file con il seguente nome in una delle cartelle elencate di seguito: aaaaaaaaaabbbbbbbbbbcccccccccc.json dove il nome del file (senza estensione) corrisponde a l'ID dell'estensione. La località dipende dal sistema operativo.

    Mac OS X:

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

    Il file dell'estensione esterna per tutti gli utenti può essere letto solo se ogni directory nel percorso è di proprietà dell'utente root, ha il gruppo admin o wheel e non è accessibile in scrittura. Il percorso deve essere privi di link simbolici. Queste restrizioni impediscono a un utente senza privilegi di causare da installare per tutti gli utenti. Per informazioni dettagliate, consulta la risoluzione dei problemi.

    Linux:

    /opt/google/chrome/extensions/

    /usr/share/google-chrome/extensions/

    Nota: utilizza chmod se necessario per assicurarti che aaaaaaaaaabbbbbbbbbbcccccccccc.json siano leggibili in tutto il mondo.

  3. Solo Linux: se esegui l'installazione da un file, specifica il percorso e la versione dell'estensione con campi denominati "external_crx" e "external_version" nel file creato sopra.

    • Esempio:
    • json { "external_crx": "/home/share/extension.crx", "external_version": "1.0" }
    • Nota: devi eseguire l'interpretazione letterale di ogni \` character in the location. For example,\server\share\extension.crxwould be"\\server\share\extension.crx"`.
    • Se esegui l'installazione da un URL di aggiornamento, specifica l'URL di aggiornamento dell'estensione con il nome del campo "external_update_url".
    • Esempio di installazione da un file .crx locale (solo Linux):
    • json { "external_update_url": "http://myhost.com/mytestextension/updates.xml" }
    • Esempio di installazione dal Chrome Web Store (Mac e Linux):
    • json { "external_update_url": "https://clients2.google.com/service/update2/crx" }
    • Se desideri installare l'estensione solo per alcune impostazioni internazionali del browser, puoi elencare le lingue supportate le impostazioni internazionali nel nome del campo "supported_locale". Le impostazioni internazionali possono specificare una lingua principale come "en", in se l'estensione verrà installata per tutte le lingue inglesi come "en-US", "en-GB" e così via. Se è selezionata un'altra lingua del browser non supportata dall'estensione, quelle esterne verranno disinstallate. Se "supported_locales" l'elenco non è presente, l'estensione sarà installato per qualsiasi lingua.
    • Esempio:
    • json { "external_update_url": "https://clients2.google.com/service/update2/crx", "supported_locales": [ "en", "fr", "de" ] }

  4. Salva il file JSON.

  5. Avvia Google Chrome e vai all'indirizzo chrome://extensions; dovresti vedere l'estensione nell'elenco.

di Gemini Advanced.

Risoluzione dei problemi relativi alle autorizzazioni di Mac OS

Su Mac OS, i file delle estensioni esterne per tutti gli utenti vengono letti solo se dispongono delle autorizzazioni del file system impedire agli utenti senza privilegi di modificarlo. Se non trovi le estensioni esterne installate quando Chrome viene avviato, potrebbe esserci un problema di autorizzazioni con le preferenze delle estensioni esterne . Per verificare se il problema è questo, procedi nel seguente modo:

  1. Avvia il programma Console. Puoi trovarla in /Applicazioni/Utility/Console.
  2. Se l'icona più a sinistra nella console indica "Mostra elenco di log", fai clic su quell'icona. Una seconda colonna viene visualizzato a sinistra.
  3. Fai clic su "Messaggi della console" nel riquadro a sinistra.
  4. Cerca la stringa Can not read external extensions. In caso di problemi durante la lettura di file di estensioni esterne, verrà visualizzato un messaggio di errore. Cerca un altro messaggio di errore direttamente sopra, il che dovrebbe spiegare il problema. Ad esempio, se ricevi 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 modificare il proprietario del gruppo della directory con Gruppo di amministratori.
  5. Dopo aver risolto il problema, riavvia Chrome. Verifica che l'estensione esterna sia installata. it è possibile che un errore di autorizzazione impedisca a Chrome di rilevare un secondo errore. Se estensione esterna non è stata installata, ripeti questi passaggi finché non viene visualizzato un errore nella l'applicazione Google Cloud.

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 del tuo (ad esempio aaaaaaaaaabbbbbbbbbbcccccccccc).

  3. Nella chiave dell'estensione, crea una proprietà, "update_url", e impostala sul valore: "https://clients2.google.com/service/update2/crx" (questo rimanda al file crx dell'estensione nel Chrome Web Store):

    {
  "update_url": "https://clients2.google.com/service/update2/crx"
}

  4. Avvia il browser e vai all'indirizzo chrome://extensions; dovresti vedere l'estensione nell'elenco.

Aggiornamento e disinstallazione

Google Chrome analizza le voci di metadati nelle preferenze e nel registro ogni volta che il browser e apporta le modifiche necessarie alle estensioni esterne installate.

Per aggiornare l'estensione a una nuova versione, aggiorna il file, quindi aggiorna la versione nel preferenze o registro.

Per disinstallare l'estensione (ad esempio, se il software viene disinstallato), rimuovi la tua preferenza (aaaaaaaaaabbbbbbbbbbbbcccccCcic.json) o i metadati del registry.

Domande frequenti

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

La metodologia per consentire una "preinstallazione" essere ancora supportata da Google Chrome a partire dalla versione M33 in poi?

Sì, ma solo come installazione da un update_URL del Chrome Web Store, non da un percorso file locale.

Posso specificare un URL come percorso dell'estensione esterna?

Sì, puoi utilizzare il file JSON preferences per Mac OS X e Linux. il registro per Windows. La l'estensione deve essere ospitata come spiegato nella sezione relativa all'hosting. Nel file delle preferenze, utilizza il metodo "external_update_url" per puntare a un manifest di aggiornamento contenente l'URL del tuo . Nel registro di Windows, utilizza "update_url" proprietà.

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

  • Non specificare lo stesso ID/versione di quello elencato nel .crx
  • Il file .json (aaaaaaaaaabbbbbbbbbbcccccccccc.json) si trova nella posizione sbagliata o ha l'ID sbagliato specificato non corrisponde all'ID estensione.
  • Errore di sintassi nel file JSON (dimenticarsi di separare le voci con una virgola o lasciare una virgola finale) da qualche parte)
  • Il file JSON rimanda al percorso errato di .crx (o al percorso specificato, ma nessun nome file)
  • Barre rovesciate nel percorso UNC senza caratteri di 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 che si verificano durante l'installazione con il registro?

  • Non specificare lo stesso ID/versione di quello elencato nel Chrome Web Store
  • Chiave creata nella posizione errata nel registro
  • Punto di ingresso del registro nel percorso sbagliato del file .crx nel Chrome Web Store
  • Problemi relativi alle autorizzazioni in una condivisione di rete

Come faccio ad aggiornare i programmi binari nativi e le estensioni in un passaggio?

In precedenza, quando le estensioni esterne allo store erano supportate, era possibile avere i file binari nativi e aggiornare l'estensione nel passaggio di blocco. Tuttavia, le estensioni ospitate sul Chrome Web Store aggiornate tramite il meccanismo di aggiornamento di Chrome che gli sviluppatori non sono sotto il controllo. Gli sviluppatori di estensioni dovrebbero fai attenzione all'aggiornamento delle estensioni che hanno una dipendenza dal programma binario nativo (ad esempio, estensioni precedenti utilizzando NPAPI).

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 il giorno per ogni startup. In altre parole, l'estensione esterna è inserita nella lista bloccata.

Come faccio a uscire dalla lista bloccata?

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