Mantener Clearcote actualizado

Sin clave de licencia, cada versión del SDK está fijada a un build abierto verificado por SHA-256, y actualizarlo es subir la versión del paquete como con cualquier otro. Con una clave, el SDK obtiene el build con licencia actual en cada lanzamiento, sin necesidad de subir de versión.

Qué builds hay disponibles

Las versiones mayores de Chromium que publicamos hoy o en las que estamos trabajando, y cuándo llegan a cada plan:

Si usas el SDK (recomendado)

Actualiza el paquete como cualquier otra dependencia:

npm i clearcote@latest          # Node
pip install -U clearcote        # Python
dotnet add package Clearcote    # .NET (adds or updates to the newest version)

En el siguiente launch(), el SDK detecta que el build que necesita no está en caché, lo descarga —el build abierto desde GitHub Releases, el build con licencia desde clearcotelabs.com— y verifica el SHA-256 antes de usarlo. Nada se ejecuta sin verificar. Cada build se guarda por separado en el directorio de caché de tu usuario —%LOCALAPPDATA%\clearcote\Cache en Windows, ~/.cache/clearcote en Linux (define CLEARCOTE_CACHE para cambiarlo de lugar)—, así que cada uno se descarga una sola vez. Los builds antiguos se conservan hasta que ejecutes clearcote clear-cache.

Actualiza el build abierto sin actualizar el SDK

Sin clave, activa la actualización automática para usar el build abierto más reciente de GitHub en lugar del que fija el SDK. Se verifica contra el SHA256SUMS.txt de esa versión (y contra la clave de firma si tienes gpg instalado); si no se puede acceder a GitHub, vuelve al build fijado. Desde una terminal, clearcote update hace lo mismo. Con una clave no cambia nada: ya recibes el build con licencia actual.

import { launch } from "clearcote";
await launch({ autoUpdate: true });   // or set env CLEARCOTE_AUTO_UPDATE=1

El navegador en sí nunca “llama a casa” ni se actualiza solo. Sin clave, el navegador solo cambia cuando subes la versión del SDK o activas autoUpdate. Con una clave, el SDK toma cada nuevo build con licencia en el siguiente lanzamiento; en Pro puedes quedarte en un build con version.

Elegir un build

Pasa version (o define CLEARCOTE_BROWSER_VERSION): "latest", una versión mayor como "153", una versión exacta "153.0.8010.36" o una revisión con licencia "r28" / "153.0.8010.36-r28". Antes de descargar nada, una versión o una versión mayor se comprueba contra el catálogo publicado, y una revisión, contra el servidor de licencias. releaseChannel: "preview" (release_channel en Python, o CLEARCOTE_RELEASE_CHANNEL=preview) toma un build preview cuando existe. En el build con licencia, los builds anteriores, la fijación de versión y el canal preview son funciones de Pro; las claves gratuitas siempre reciben el más reciente.

clearcote install --version 153        # fetch + verify a build ahead of time
clearcote install --channel preview     # the newest preview build (Pro)
clearcote info                          # what's installed and cached, and your key
clearcote clear-cache                   # delete cached builds

Si usas el binario directo o Docker

• Binario directo (solo el build abierto; el build con licencia se ejecuta a través del SDK, clearcote serve o la imagen de Docker): descarga el nuevo archivo comprimido desde la página de Releases, verifica el checksum + la firma (consulta Verificación) y apunta executable_path / executablePath (o CLEARCOTE_BINARY) al nuevo chrome.
• Docker: ejecuta docker pull teamflatearth/clearcote para obtener la imagen más reciente y luego vuelve a crear tu contenedor. Las claves gratuitas requieren una imagen construida con el SDK 0.30.0 o posterior. Con una clave, monta -v clearcote-cache:/opt/xdg-cache para que el build con licencia se descargue una sola vez y no en cada contenedor nuevo. Consulta Despliegue.

El build con licencia: siempre al día y el primero en actualizarse

El build con licencia sigue el Chromium más reciente y los parches más nuevos, así que recibes las actualizaciones sin recompilar nada a mano. Define CLEARCOTE_LICENSE_KEY, pasa licenseKey o ejecuta clearcote login (Python/Node; npx clearcote login con una instalación local de npm): comprueba la clave y la guarda en ~/.clearcote/license.key, que leen todos los SDK, incluido el de .NET. Hay dos formas de conseguir una clave:

• Gratis con GitHub: un navegador a la vez, sin costo. Inicia sesión con una cuenta de GitHub que tenga al menos 30 días de antigüedad, abre “Licenses” en tu panel, haz clic en “Connect GitHub and get it free” y después en “Claim my free key” (una por cuenta de GitHub). La clave dura 30 días; renuévala gratis desde la misma página antes de que venza.
• Pro: el mismo build, sin límite de navegadores simultáneos durante la beta, con builds anteriores, fijación de versión y el canal preview, además de soporte por email del dueño del proyecto.

Las nuevas versiones mayores llegan primero al build con licencia. Cuando se compila una nueva versión mayor de Chromium, queda disponible de inmediato en Gratis con GitHub y en Pro; el build abierto la recibe más tarde, con el objetivo de unos 2 meses después del lanzamiento (hoy está en Chromium 149). El build abierto siempre es completamente abierto y reproducible; el build con licencia recibe la versión más nueva antes.

Cómo se cuentan los navegadores con licencia

Cada navegador que se inicia con una clave toma un slot del servidor de licencias y lo devuelve al cerrarse. Tu panel muestra cuántos están en uso, y clearcote info muestra el mismo número.

• Gratis con GitHub cuenta cada navegador. Hay un solo slot, así que un segundo navegador —en el mismo programa, en otro programa o en otra máquina— se rechaza con The free tier runs one browser at a time, and one is already running hasta que se cierre el primero. Un navegador que se cayó sin cerrarse libera su slot en un máximo de 6 minutos.
• Pro cuenta máquinas, sin límite durante la beta. Todos los navegadores de una misma máquina comparten el slot de esa máquina.
• Las claves gratuitas requieren el SDK 0.30.0 o posterior (Python, Node y .NET), porque para contar cada navegador el SDK tiene que reportar cada lanzamiento y mantener la licencia vigente mientras ese navegador se ejecuta. Un SDK anterior recibe SDK_UPGRADE_REQUIRED junto con el comando para actualizarlo, y si aun así llega al motor, el motor lo rechaza. Las claves Pro siguen funcionando con SDK anteriores como hasta ahora.
• Un navegador gratuito se detiene cuando pierde su slot. La comprobación es continua, no solo al arrancar: si se revoca la clave, el slot se devuelve desde otro lugar o la licencia supera su límite, un navegador gratuito que ya está abierto se cierra en unos 2 a 3 minutos. Los cortes de red breves (uno o dos heartbeats perdidos) se toleran; una caída de más de unos 2 a 3 minutos detiene un navegador gratuito de la misma manera.
• El plan gratuito siempre ejecuta el build más reciente. Pedir un build con licencia anterior o el canal preview devuelve FREE_LATEST_ONLY; fijar un build es una función de Pro.
• Descargas con una clave gratuita: hasta 10 builds distintos cada 24 horas. Un mismo build cuenta una sola vez, sin importar cuántas veces lo inicies.

pip install -U clearcote          # Python 0.30.0+
npm i clearcote@latest            # Node 0.30.0+
dotnet add package Clearcote      # .NET 0.30.0+

Después de actualizar, vuelve a verificar

Un build nuevo puede cambiar alguna señal. Vuelve a ejecutar tus tests de huella digital (por ejemplo, CreepJS) y, si usas un perfil importado, confirma que sigue cargando de forma coherente; consulta Verificación. El build abierto actual es v0.1.0-pre.22 (Chromium 149.0.7827.114); el build con licencia actual es 153.0.8010.36-r28. En la hoja de ruta puedes ver lo que viene.