Autohosting para Linux

Linux es la única plataforma en la que los usuarios de Chrome pueden instalar extensiones alojadas fuera de la Chrome Web Store. En este artículo, se describe cómo empaquetar, alojar y actualizar archivos crx desde un servidor web de uso general. Si distribuyes una extensión o un tema únicamente a través de Chrome Web Store, consulta Alojamiento y actualización de Web Store.

Paquete

Las extensiones y los temas se publican como archivos .crx. Cuando se suben a través del Panel del desarrollador de Chrome, el panel crea el archivo crx automáticamente. Si se publica en un servidor personal, el archivo crx deberá crearse de forma local o descargarse desde Chrome Web Store.

Descarga archivos .crx desde Chrome Web Store

Si una extensión está alojada en Chrome Web Store, se puede descargar el archivo .crx desde el Panel del desarrollador. Busca la extensión en "Tus fichas" y haz clic en "Más información". En la ventana emergente, haz clic en el vínculo azul main.crx para descargarlo.

Descarga el archivo .crx desde el Panel del desarrollador

El archivo descargado se puede alojar en un servidor personal. Esta es la forma más segura de alojar una extensión de forma local, ya que Chrome Web Store firmará el contenido de la extensión. Esto ayuda a detectar posibles ataques y manipulaciones.

Crea archivos .crx de forma local

Los directorios de extensiones se convierten en archivos .crx en la página de administración de extensiones. Navega a chrome://extensions/ en la barra de direcciones o haz clic en el menú de Chrome, mantén el puntero sobre "Más herramientas" y, luego, selecciona "Extensiones".

En la página de administración de extensiones, haz clic en el interruptor junto a Modo de desarrollador para habilitarlo. Luego, selecciona el botón EMPAQUETAR EXTENSIÓN.

Si el modo de desarrollador está marcado, haz clic en Empaquetar extensión.

Especifica la ruta de acceso a la carpeta de la extensión en el campo Directorio raíz de la extensión y, luego, haz clic en el botón EMPAQUETAR EXTENSIÓN. Ignora el campo Clave privada para un paquete nuevo.

Especifica la ruta de la extensión y, luego, haz clic en Pack Extension.

Chrome creará dos archivos: un archivo .crx y un archivo .pem, que contiene la clave privada de la extensión.

Archivos de extensión empaquetados

No pierdas la clave privada. Guarda el archivo .pem en un lugar secreto y seguro. Se necesitará para actualizar la extensión.

Actualiza un paquete .crx

Para actualizar el archivo .crx de una extensión, aumenta el número de versión en manifest.json.

{
  ...
  "version": "1.5",
  ...
  }
}

{
  ...
  "version": "1.6",
  ...
  }
}

Regresa a la página de administración de extensiones y haz clic en el botón EMPAQUETAR EXTENSIÓN. Especifica la ruta de acceso al directorio de extensiones y la ubicación de la clave privada.

Cómo actualizar los archivos de expansión

En la página, se proporcionará la ruta de acceso de la extensión empaquetada actualizada.

Cómo actualizar los archivos de expansión

Empaqueta a través de la línea de comandos

Para empaquetar extensiones en la línea de comandos, invoca chrome.exe. Usa la --pack-extension marca para especificar la ubicación de la carpeta de la extensión y la --pack-extension-key marca para especificar la ubicación del archivo de clave privada de la extensión.

chrome.exe --pack-extension=C:\myext --pack-extension-key=C:\myext.pem

Host

Un servidor que aloja archivos .crx debe usar encabezados HTTP adecuados para permitir que los usuarios instalen la extensión haciendo clic en un vínculo.

Google Chrome considera que un archivo se puede instalar si se cumple alguna de las siguientes condiciones:

  • El archivo tiene el tipo de contenido application/x-chrome-extension.
  • El sufijo del archivo es .crx y se cumplen ambas de las siguientes condiciones:
    • El archivo no se publica con el encabezado HTTP X-Content-Type-Options: nosniff.
    • El archivo se publica con uno de los siguientes tipos de contenido:
    • string vacía
    • "text/plain"
    • "application/octet-stream"
    • "unknown/unknown"
    • "application/unknown"
    • "\*/\*"

El motivo más común por el que no se reconoce un archivo instalable es que el servidor envía el encabezado X-Content-Type-Options: nosniff. El segundo motivo más común es que el servidor envía un tipo de contenido desconocido, uno que no está en la lista anterior. Para solucionar un problema de encabezado HTTP, cambia la configuración del servidor o intenta alojar el archivo .crx en otro servidor.

Actualizar

Cada pocas horas, el navegador verifica las extensiones instaladas para obtener una URL de actualización. Para cada una, realiza una solicitud a esa URL en busca de un archivo XML del manifiesto de actualización.

  • El contenido que muestra una verificación de actualización es un documento XML del manifiesto de actualización que muestra la versión más reciente de una extensión.

Si el manifiesto de actualización menciona una versión más reciente que la instalada, el navegador descarga e instala la versión nueva. Al igual que con las actualizaciones manuales, el nuevo archivo .crx debe firmarse con la misma clave privada que la versión instalada actualmente.

Nota: Para mantener la privacidad del usuario, Google Chrome no envía ningún encabezado de cookie con las solicitudes de manifiesto de actualización automática y omite cualquier encabezado Set-Cookie en las respuestas a esas solicitudes.

Actualizar URL

Las extensiones alojadas en servidores fuera de Chrome Web Store deben incluir el update_url campo en su manifest.json archivo.

{
  "name": "My extension",
  ...
  "update_url": "https://myhost.com/mytestextension/updates.xml",
  ...
}

Actualizar manifiesto

El manifiesto de actualización que muestra el servidor debe ser un documento XML.

<?xml version='1.0' encoding='UTF-8'?>
<gupdate xmlns='http://www.google.com/update2/response' protocol='2.0'>
  <app appid='aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'>
    <updatecheck codebase='https://myhost.com/mytestextension/mte_v2.crx' version='2.0' />
  </app>
</gupdate>

Este formato XML se toma prestado del que usa Omaha, la infraestructura de actualización de Google. El sistema de extensiones usa los siguientes atributos para los <app> y <updatecheck> elementos del manifiesto de actualización:

appid
El ID de la extensión se genera en función de un hash de la clave pública, como se describe en empaquetado. El ID de una extensión se muestra en la página de administración de extensiones.
base de código
Una URL HTTPS al archivo .crx.
versión
El cliente lo usa para determinar si debe descargar el archivo .crx especificado por codebase. Debe coincidir con el valor de "version" en el archivo manifest.json del archivo .crx.

El archivo XML del manifiesto de actualización puede contener información sobre varias extensiones si incluye varios <app> elementos.

Prueba

La frecuencia de verificación de actualización predeterminada es de varias horas, pero se puede forzar una actualización con el botón Actualizar extensiones ahora en la página de administración de extensiones.

Actualizar las extensiones ahora

Esto iniciará las verificaciones de todas las extensiones instaladas.

Uso avanzado: Parámetros de solicitud

El mecanismo básico de actualización automática está diseñado para que el trabajo del lado del servidor sea tan sencillo como colocar un archivo en formato XML estático en cualquier servidor web simple, como Apache, y actualizar ese archivo en formato XML a medida que se lanzan versiones nuevas de la extensión.

Los desarrolladores que alojan varias extensiones pueden verificar los parámetros de solicitud, que indican el ID y la versión de la extensión en la solicitud de actualización. Si se incluyen estos parámetros, las extensiones se pueden actualizar desde la misma URL que ejecuta código dinámico del servidor en lugar de un archivo en formato XML estático.

El formato de los parámetros de solicitud es el siguiente:

?x=EXTENSION_DATA

En el ejemplo anterior, EXTENSION_DATA es una cadena codificada como URL con el siguiente formato:

id=EXTENSION_ID&v=EXTENSION_VERSION

Por ejemplo, dos extensiones apuntan a la misma URL de actualización (https://test.com/extension_updates.php):

  • Extensión 1
    • ID: "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    • Versión: "1.1"
  • Extensión 2
    • ID: "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
    • Versión: "0.4"

La solicitud para actualizar cada extensión individual sería la siguiente:

https://test.com/extension_updates.php?x=id%3Daaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa%26v%3D1.1

y

https://test.com/extension_updates.php?x=id%3Dbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb%26v%3D0.4

Se pueden enumerar varias extensiones en una sola solicitud para cada URL de actualización única. En el ejemplo anterior, si un usuario tiene instaladas ambas extensiones, las dos solicitudes se combinan en una sola:

https://test.com/extension_updates.php?x=id%3Daaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa%26v%3D1.1&x=id%3Dbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb%26v%3D0.4

Si la cantidad de extensiones instaladas que usan la misma URL de actualización es lo suficientemente grande como para que una URL de solicitud GET sea demasiado larga (más de 2,000 caracteres aproximadamente), la verificación de actualización emite solicitudes GET adicionales según sea necesario.

Uso avanzado: Versión mínima del navegador

A medida que se agregan más APIs al sistema de extensiones, se puede lanzar una versión actualizada de una extensión que solo funcione con versiones más recientes del navegador. Si bien Google Chrome se actualiza automáticamente, puede tardar unos días antes de que la mayoría de la base de usuarios se actualice a un nuevo lanzamiento determinado. Para asegurarte de que una actualización determinada se aplique solo a las versiones de Google Chrome que sean iguales o superiores a una versión específica, agrega el atributo "prodversionmin" al elemento <app> en la respuesta de actualización.

<?xml version='1.0' encoding='UTF-8'?>
<gupdate xmlns='http://www.google.com/update2/response' protocol='2.0'>
  <app appid='aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'>
    <updatecheck codebase='http://myhost.com/mytestextension/mte_v2.crx' version='2.0' prodversionmin='3.0.193.0'/>
  </app>
</gupdate>

Esto garantizaría que los usuarios se actualicen automáticamente a la versión 2 solo si ejecutan Google Chrome 3.0.193.0 o una versión posterior.