Usa métodos de instalación alternativos

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.

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

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.

Advertencia: Las instalaciones en Windows y Mac deben provenir de Chrome Web Store: A partir de Chrome 33, no se permitirán instalaciones externas. estén permitidos desde una ruta de acceso a un archivo CRX local en Windows (consulta Protección de los usuarios de Windows contra extensiones maliciosas). A partir de Chrome 44, no se permiten instalaciones externas de una ruta de acceso a un archivo CRX local en Mac OS (consulta Cómo continuar protegiendo a los usuarios de Chrome contra extensiones maliciosas).

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

Nota: Solo en macOS X y Linux: No uses el archivo de preferencias para Windows. Usa el registro de Windows en su lugar.

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 en la lista.

Nota: El archivo de extensión externa para todos los usuarios es de solo lectura si todos los directorios de la ruta son propiedad de El usuario root tiene el grupo admin o wheel, y no admite escritura pública. La ruta también debe ser libre de vínculos simbólicos. Estas restricciones impiden que un usuario sin privilegios provoque que las extensiones instalarse para todos los usuarios. Consulta Soluciona problemas relacionados con los permisos.

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:

1. Inicia el programa de la consola. Puedes encontrarla en /Applications/Utilities/Console.
2. 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.
3. Haz clic en “Mensajes de la consola”. en el panel izquierdo.
4. 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.
5. 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

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

4. Guarda el archivo JSON.

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

Nota: Si es necesario, usa chmod para asegurarte de que los archivos aaabbbcccdddeeefff.json puedan leerse en todo el mundo. Consulta las Preguntas frecuentes sobre errores comunes del archivo de preferencias para obtener ayuda adicional.

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

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 nueva (carpeta) en la clave Extensiones con el mismo nombre que el ID de tu . Por ejemplo: aaabbbcccdddeeefff.

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

4. Inicia Chrome.

5. Ve a chrome://extensions. deberías ver la extensión en la lista.

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

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.