Por lo general, los usuarios de Chrome instalan extensiones al visitar su ficha en Chrome Web Store y, luego, instalar la extensión directamente desde esa página. Sin embargo, en algunos casos, se pueden usar flujos puede ser más adecuado. Por ejemplo:
- Las extensiones están asociadas a otro software, por lo que deberían instalarse. siempre que el usuario instale ese otro software.
- Un administrador de red quiere instalar las mismas extensiones en toda la organización.
En los casos anteriores, Google Chrome admite los siguientes métodos de instalación de extensiones:
- Con un archivo de preferencias JSON (solo en macOS X y Linux)
- Con el registro de Windows (solo para Windows)
Ambas formas admiten la instalación de una extensión alojada en un update_URL
. En Windows y macOS, la API de
update_URL
debe apuntar a Chrome Web Store. Cuando se instala una extensión con estos métodos,
Los usuarios de Windows y macOS deberán habilitar la extensión con el siguiente diálogo de confirmación:
En Linux, el archivo de preferencias puede apuntar a una extensión de Chrome Web Store, un servicio alojado externamente o un archivo de extensión CRX en la computadora del usuario. Los usuarios de Linux no podrán se le solicite habilitar la extensión; se instala automáticamente.
Antes de comenzar
Instalar desde Chrome Web Store
Si distribuyes una extensión alojada en Chrome Web Store, primero debes publicar el extensión. Luego, toma nota de lo siguiente:
- La URL de actualización:
https://clients2.google.com/service/update2/crx
. Esta URL dirige a los en Chrome Web Store. - El ID de la extensión: Puedes encontrarlo en la URL de Chrome Web Store de la extensión.
Instalar desde el archivo CRX local
Si distribuyes tu app a usuarios de Linux desde un archivo local, deberás empaquetar un CRX y ten en cuenta la siguiente información:
El ID de extensión: Puedes encontrarlo en la página de administración de extensiones
chrome://extensions
.La versión de la extensión (aparece en la página de administración de extensiones
chrome://extensions
) en el archivo JSON de manifiesto.
- La ubicación del archivo CRX: Puede ser un directorio local o un recurso compartido de red. Marca asegúrate de que el archivo esté disponible para la máquina en la que quieras instalar la extensión.
Instalar desde un servidor personal
Si distribuyes una extensión alojada en un servidor personal para usuarios de Linux, deberás sigue las instrucciones para instalar extensiones en Linux y ten en cuenta lo siguiente: información:
El ID de extensión: Puedes encontrarlo en la página de administración de extensiones
chrome://extensions
.La ruta del archivo XML update_url: Debe coincidir con la ruta de acceso del archivo Es el campo
update_url
declarado en el archivo JSON de manifiesto.
En los siguientes ejemplos, se supone que la versión es 1.0 y que el ID de la extensión es aaabbbcccdddeeefff.
Cómo usar un archivo de preferencias
macOS
- Crea un archivo JSON con el nombre del ID de la extensión. Por ejemplo:
aaabbbcccdddeeefff.json
Colócalo en una de las siguientes carpetas:
- Para un usuario específico
~USERNAME/Library/Application Support/Google/Chrome/External Extensions/
- Para todos los usuarios
/Library/Application Support/Google/Chrome/External Extensions/
Especifica la URL de actualización con el nombre de campo "external_update_url". Por ejemplo:
json { "external_update_url": "https://clients2.google.com/service/update2/crx" }
Guarda el archivo JSON.
Inicia Google Chrome y ve a chrome://extensions. deberías ver la extensión en la lista.
Solución de problemas de permisos de Mac OS
En macOS, los archivos de extensiones externas de todos los usuarios solo se leen si tienen los permisos del sistema de archivos. evitar que los usuarios sin privilegios la modifiquen. Si no ves extensiones externas instaladas cuando Se inició Chrome, es posible que haya un problema de permisos con las preferencias de extensiones externas archivos. Para ver si el problema se debe a esto, sigue estos pasos:
- Inicia el programa de la consola. Puedes encontrarla en /Applications/Utilities/Console.
- Si el ícono que está en el extremo izquierdo de la consola dice "Mostrar lista de registros", haz clic en él. Una segunda columna aparece a la izquierda.
- Haz clic en “Mensajes de la consola”. en el panel izquierdo.
- Busca la cadena No se pueden leer extensiones externas. Si hay un problema con la lectura del
externas, verás un mensaje de error. Busca otro mensaje de error
directamente antes de él, lo que debería explicar el problema. Por ejemplo, supongamos que ves el siguiente error:
"Path /Library/Application Support/Google/Chrome es propiedad del grupo equivocado", debes usar
chgrp
o el cuadro de diálogo Get Info de Finder para cambiar el propietario del grupo del directorio a la Administrador del grupo. - Después de solucionar el problema, reinicia Chrome. Prueba que la extensión externa ahora esté instalada. Integra es posible que un error de permisos impida que Chrome detecte un segundo error. Si el botón no se instaló la extensión externa, repite estos pasos hasta que no veas ningún error en el de la consola de Cloud.
Linux
- Crea un archivo JSON con el nombre del ID de la extensión. Por ejemplo:
aaabbbcccdddeeefff.json
. Colócalo en una de las siguientes carpetas:
/opt/google/chrome/extensions/
/usr/share/google-chrome/extensions/
La siguiente lista describe la instalación de extensiones desde Chrome Web Store, un archivo CRX o un servidor personal:
- Para instalar una extensión de Chrome Web Store, especifica la URL de actualización con el nombre del campo.
“external_update_url”. Por ejemplo:
json { "external_update_url": "https://clients2.google.com/service/update2/crx" }
- Para instalar la extensión desde un archivo CRX, especifica la ubicación en "external_crx" y las
de la versión en “external_version”. Por ejemplo:
json { "external_crx": "/home/share/extension.crx", "external_version": "1.0" }
- Para instalar la extensión alojada en un servidor personal,
"external_update_url" debe apuntar al archivo XML, como en el siguiente ejemplo:
json { "external_update_url": "http://myhost.com/mytestextension/updates.xml" }
- Para instalar una extensión de Chrome Web Store, especifica la URL de actualización con el nombre del campo.
“external_update_url”. Por ejemplo:
Guarda el archivo JSON.
Inicia Google Chrome y ve a chrome://extensions. deberías ver la extensión en la lista.
Configuraciones regionales compatibles
Si deseas instalar la extensión solo para algunas configuraciones regionales del navegador, puedes indicar las configuraciones regionales admitidas, en el nombre de campo "supported_locales". La configuración regional puede especificar una configuración regional principal, como "en"; en este caso, se instalará para todas las configuraciones regionales en inglés, como "en-US", "en-GB", etc. Si se usa otro una región seleccionada que no es compatible con la extensión, las extensiones externas serán desinstalada. Si es "supported_locales" si falta la lista, se instalará la extensión para cualquier configuración regional. Por ejemplo:
{
"external_update_url": "https://clients2.google.com/service/update2/crx",
"supported_locales": [ "en", "fr", "de" ]
}
Usa el registro de Windows
Busca o crea la siguiente clave en el registro:
- Windows de 32 bits
HKEY_LOCAL_MACHINE\Software\Google\Chrome\Extensions
- Windows de 64 bits
HKEY_LOCAL_MACHINE\Software\Wow6432Node\Google\Chrome\Extensions
Crea una clave nueva (carpeta) en la clave Extensiones con el mismo nombre que el ID de tu . Por ejemplo:
aaabbbcccdddeeefff
.En tu clave de extensión, crea una "update_url". y configúrala con el siguiente valor:
json { "update_url": "https://clients2.google.com/service/update2/crx" }
Inicia Chrome.
Ve a chrome://extensions. deberías ver la extensión en la lista.
Actualizando y desinstalando
Google Chrome analiza las entradas de metadatos en las preferencias y el registro cada vez que el navegador inicio y realiza los cambios necesarios en las extensiones externas instaladas que se alojan en Chrome Web Store.
Para actualizar una extensión de archivo CRX local a una versión nueva, actualiza el archivo y, luego, la versión en el archivo json de preferencias.
Para desinstalar tu extensión (por ejemplo, si se desinstala el software), quita tu preferencia
(por ejemplo, aaabbbcccdddeeefff.json
) o los metadatos del registro.
Preguntas frecuentes
En esta sección, se responden preguntas frecuentes sobre las extensiones externas.
Es de "preinstalación". todavía es compatible con Google Chrome?
Sí, pero solo como una instalación desde un update_url
de Chrome Web Store, no desde una ruta de CRX local. Para obtener más información, consulte las Políticas de aplicaciones y extensiones.
¿Cuáles son algunos errores comunes al realizar la instalación con el archivo de preferencias?
- No se especifica el mismo ID o versión que el que aparece en el archivo CRX.
- El archivo JSON (por ejemplo,
aaabbbcccdddeeefff.json
) está en una ubicación incorrecta o el ID especificada no coincide con el ID de la extensión. - Error de sintaxis en el archivo JSON (olvidaste separar las entradas con coma o dejar una coma final algún lugar).
- La entrada del archivo JSON apunta a la ruta incorrecta al archivo CRX (o a la ruta especificada, pero no el nombre del archivo).
- Las barras inversas en la ruta UNC no tienen escape. Por ejemplo,
"\\server\share\file"
es incorrecto. debería ser"\\\\server\\share\\extension"
. - Problemas de permisos en un recurso compartido de red.
¿Cuáles son algunos de los errores comunes de la instalación con el registro?
- No se especifica el mismo ID que el que aparece en Chrome Web Store.
- La clave se creó en la ubicación incorrecta en el registro.
- La entrada del registro apunta a la ruta incorrecta del archivo CRX en Chrome Web Store.
- Problemas de permisos en un recurso compartido de red.
- No todas las instancias de Chrome están cerradas. Intenta reiniciar la computadora después de configurar el registro.
¿Qué sucede si el usuario desinstala la extensión?
Si el usuario desinstala la extensión a través de la IU, ya no se instalará ni actualizará en en cada startup. En otras palabras, la extensión externa está en la lista de entidades bloqueadas.
¿Cómo salgo de la lista de entidades bloqueadas?
Si el usuario desinstala tu extensión, debes respetar esa decisión. Sin embargo, si tú (el desarrollador) desinstalaste accidentalmente tu extensión a través de la IU, puedes quitar la etiqueta de la lista de entidades bloqueadas instalando la extensión normalmente a través de la IU y, luego, desinstálala.