Usa métodos de instalación alternativos

Por lo general, los usuarios de Chrome instalan las extensiones cuando visitan la ficha de una extensión en Chrome Web Store y, luego, la instalan directamente desde esa página. Sin embargo, en algunos casos, es posible que otros flujos de instalación sean más adecuados. Por ejemplo:

• Una extensión está asociada a otro software, y debe instalarse cada vez que el usuario instale ese otro software.
• Un administrador de red quiere instalar las mismas extensiones en toda su organización.

Nota: Los administradores también pueden usar políticas empresariales para administrar la instalación de extensiones. Para obtener más información, consulta las políticas de Extension Enterprise.

En los casos anteriores, Google Chrome admite los siguientes métodos de instalación de extensiones:

• Con un archivo de preferencias JSON (solo para macOS X y Linux)
• Usa el registro de Windows (solo para Windows).

En ambos casos, se admite la instalación de una extensión alojada en un update_URL. En Windows y macOS, update_URL debe apuntar a Chrome Web Store. Cuando se instala una extensión con estos métodos, los usuarios de Windows y macOS tendrán que habilitarla con el siguiente diálogo de confirmación:

En Linux, el archivo de preferencias puede apuntar a una extensión de Chrome Web Store, a una extensión alojada externamente o a un archivo de extensión CRX en la computadora del usuario. No se les solicitará a los usuarios de Linux que habiliten la extensión; esta se instala automáticamente.

Advertencia: Las instalaciones en Windows y Mac deben provenir de Chrome Web Store: A partir de Chrome 33, no se permiten las instalaciones externas desde una ruta de acceso a un archivo CRX local en Windows (consulta Cómo proteger a los usuarios de Windows contra extensiones maliciosas). A partir de Chrome 44, no se permiten las instalaciones externas desde una ruta de acceso a un archivo CRX local en Mac OS (consulta Continúa protegiendo a los usuarios de Chrome de extensiones maliciosas).

Antes de comenzar

Instalar desde Chrome Web Store

Si distribuyes una extensión alojada en Chrome Web Store, primero debes publicarla. Luego, toma nota de lo siguiente:

• La URL de actualización: https://clients2.google.com/service/update2/crx. Esta URL dirige a 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 archivo CRX y tener 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 o en el archivo JSON de manifiesto.

• La ubicación del archivo CRX: Puede ser un directorio local o un recurso compartido de red. Asegúrate de que el archivo esté disponible en la máquina en la que quieres instalar la extensión.

Cómo instalar desde un servidor personal

Si distribuyes una extensión alojada en un servidor personal para usuarios de Linux, deberás seguir las instrucciones del artículo Cómo instalar extensiones en Linux y tener 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 ruta del archivo XML update_url: debe coincidir con la ruta del campo update_url declarado en el archivo JSON de manifiesto.

En los siguientes ejemplos se supone que la versión es 1.0 y el ID de extensión es aaabbbcccdddeeefff.

Cómo usar un archivo de preferencias

Nota: Solo para MacOS X y Linux: No uses el archivo de preferencias para Windows. En su lugar, usa el registro de Windows.

macOS

1. Crea un archivo JSON con el nombre del ID de la extensión. Por ejemplo: aaabbbcccdddeeefff.json

2. 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/

3. 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" }

4. Guarda el archivo JSON.

5. Inicia Google Chrome y ve a chrome://extensions. Deberías ver la extensión.

Nota: El archivo de extensión externa para todos los usuarios es de solo lectura si cada directorio de la ruta es propiedad del usuario root, tiene el grupo admin o wheel y no admite escritura pública. La ruta tampoco debe contener vínculos simbólicos. Estas restricciones evitan que un usuario sin privilegios haga que se instalen extensiones para todos los usuarios. Consulta Cómo solucionar problemas de permisos.

Solución de problemas de permisos de macOS

En macOS, los archivos de extensiones externas para todos los usuarios solo se leen si los permisos del sistema de archivos impiden que los usuarios sin privilegios los modifiquen. Si no ves extensiones externas instaladas cuando se inicia Chrome, es posible que haya un problema de permisos con los archivos de preferencias de extensiones externas. Para ver si se trata de un problema, sigue estos pasos:

1. Inicia el programa de Console. Puedes encontrarlo en /Applications/Utilities/Console.
2. Si el ícono que se encuentra más a la izquierda en la consola dice “Show Log List”, haz clic en ese ícono. Aparecerá una segunda columna a la izquierda.
3. Haz clic en “Mensajes de la consola” en el panel izquierdo.
4. Busca la cadena No se pueden leer las extensiones externas. Si hay un problema para leer los archivos de extensiones externas, verás un mensaje de error. Busca otro mensaje de error justo antes de este, lo que debería explicar el problema. Por ejemplo, si ves el siguiente error: "Path /Library/Application Support/Google/Chrome isOwned by the incorrect group", debes usar chgrp o el diálogo Get Info de Finder para cambiar el propietario del grupo del directorio a Administrator.
5. Después de solucionar el problema, reinicia Chrome. Prueba que la extensión externa ya esté instalada. Es posible que un error de permisos impida que Chrome detecte un segundo error. Si la extensión externa no estaba instalada, repite estos pasos hasta que no veas un error en la aplicación de Console.

Linux

1. Crea un archivo JSON con el nombre del ID de la extensión. Por ejemplo: aaabbbcccdddeeefff.json.

2. Colócalo en una de las siguientes carpetas:

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

3. En la siguiente lista, se 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 de 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 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, el campo “external_update_url” debe apuntar al archivo en formato XML, como en el siguiente ejemplo: json { "external_update_url": "http://myhost.com/mytestextension/updates.xml" }

4. Guarda el archivo JSON.

5. Inicia Google Chrome y ve a chrome://extensions. Deberías ver la extensión.

Nota: Usa chmod si es necesario para asegurarte de que los archivos aaabbbcccdddeeefff.json sean legibles para todo el mundo. Consulta las Preguntas frecuentes sobre errores comunes del archivo de preferencias para obtener ayuda adicional.

Configuraciones regionales compatibles

Si quieres instalar la extensión solo para algunas configuraciones regionales de navegador, puedes enumerar las configuraciones regionales compatibles en el nombre del campo "supported_locales". La configuración regional puede especificar una configuración regional superior, como "en", en este caso, la extensión se instalará para todas las configuraciones regionales de inglés, como "en-US", "en-GB", etc. Si se selecciona otra configuración del navegador que no sea compatible con la extensión, se desinstalarán las extensiones externas. Si falta la lista "supported_locales", la extensión se instalará 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

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

2. Crea una clave (carpeta) nueva en la clave Extensions con el mismo nombre que el ID de la extensión. Por ejemplo: aaabbbcccdddeeefff.

3. En tu clave de extensión, crea una propiedad "update_url" y establécela en el siguiente valor: json { "update_url": "https://clients2.google.com/service/update2/crx" }

4. Inicia Chrome.

5. Ve a chrome://extensions. Deberías ver la extensión.

Nota: Consulta los errores comunes del registro de Windows para obtener ayuda adicional.

Actualización y desinstalación

Google Chrome analiza las entradas de metadatos en las preferencias y el registro cada vez que se inicia el navegador, y realiza los cambios necesarios en las extensiones externas instaladas que están alojadas en Chrome Web Store.

Para actualizar una extensión de archivo CRX local a una versión nueva, actualiza el archivo y, luego, actualiza la versión en el archivo JSON de preferencias.

Para desinstalar la extensión (por ejemplo, si se desinstala el software), quita el archivo de preferencias (por ejemplo, aaabbbcccdddeeefff.json) o los metadatos del registro.

Preguntas frecuentes

En esta sección, se responden preguntas comunes acerca de las extensiones externas.

¿Google Chrome aún admite la "preinstalación"?

Sí, pero solo como una instalación desde update_url de Chrome Web Store, no desde una ruta CRX local. Para obtener más información, consulta las Políticas de apps y extensiones.

¿Cuáles son algunos errores comunes cuando se realiza la instalación con el archivo de preferencias?

• No especificar 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 especificado no coincide con el ID de la extensión.
• Error de sintaxis en el archivo JSON (olvidar separar las entradas con comas o dejar una coma final) en alguna parte
• La entrada del archivo JSON apunta a una ruta de acceso incorrecta al archivo CRX (o a la ruta especificada, pero sin nombre de archivo).
• Las barras inversas en la ruta de acceso 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 errores comunes cuando se realiza la instalación con el registro?

• No especificar el mismo ID que aparece en Chrome Web Store
• La clave se creó en la ubicación incorrecta en el registro.
• La entrada del registro dirige a una ruta de acceso incorrecta al 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 tu 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 cada inicio. 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 la extensión a través de la IU, puedes quitar la etiqueta de la lista de entidades bloqueadas. Para ello, instala la extensión normalmente a través de la IU y, luego, desinstálala.