Maintenir Clearcote à jour

Sans clé de licence, chaque version du SDK est épinglée sur un build ouvert dont le SHA-256 est vérifié, et la mise à jour se fait par une simple montée de version du package. Avec une clé, le SDK récupère le build sous licence actuel à chaque lancement — aucune montée de version nécessaire.

Builds disponibles

Les versions majeures de Chromium que nous livrons actuellement ou sur lesquelles nous travaillons, et quand chaque offre les reçoit :

Utilisateurs du SDK (recommandé)

Mettez le package à jour comme n’importe quelle autre dépendance :

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

Au prochain launch(), le SDK constate que le build dont il a besoin n’est pas en cache, le télécharge — le build ouvert depuis GitHub Releases, le build sous licence depuis clearcotelabs.com — et vérifie son SHA-256 avant de l’utiliser. Rien ne s’exécute sans vérification. Chaque build est mis en cache séparément dans le répertoire de cache de votre utilisateur — %LOCALAPPDATA%\clearcote\Cache sous Windows, ~/.cache/clearcote sous Linux (définissez CLEARCOTE_CACHE pour le déplacer) — si bien que chacun n’est téléchargé qu’une seule fois. Les anciens builds sont conservés jusqu’à ce que vous lanciez clearcote clear-cache.

Mettre à jour le build ouvert sans mettre à jour le SDK

Sans clé, activez la mise à jour automatique pour prendre le build ouvert le plus récent publié sur GitHub au lieu de celui qu’épingle le SDK. Il est vérifié avec le SHA256SUMS.txt de cette version (et avec la clé de signature si gpg est installé) ; si GitHub est injoignable, le SDK se rabat sur le build épinglé. Depuis un shell, clearcote update fait la même chose. Avec une clé, cela ne change rien — vous obtenez déjà le build sous licence actuel.

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

Le navigateur lui-même ne contacte jamais son éditeur et ne se met jamais à jour tout seul. Sans clé, le navigateur ne change que lorsque vous montez la version du SDK ou activez autoUpdate. Avec une clé, le SDK récupère chaque nouveau build sous licence au lancement suivant ; avec Pro, vous pouvez conserver un build donné grâce à version.

Choisir un build

Passez version (ou définissez CLEARCOTE_BROWSER_VERSION) : "latest", une version majeure comme "153", une version exacte "153.0.8010.36" ou une révision sous licence "r28" / "153.0.8010.36-r28". Avant tout téléchargement, une version ou une majeure est vérifiée auprès du catalogue publié, et une révision auprès du serveur de licences. releaseChannel: "preview" (release_channel en Python, ou CLEARCOTE_RELEASE_CHANNEL=preview) prend un build preview lorsqu’il en existe un. Sur le build sous licence, les anciens builds, l’épinglage et le canal preview sont des fonctionnalités Pro — les clés gratuites obtiennent toujours la dernière version.

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

Utilisation directe / Docker

• Binaire direct (build ouvert uniquement — le build sous licence s’exécute via le SDK, clearcote serve ou l’image Docker) : téléchargez la nouvelle archive depuis la page Releases, vérifiez la somme de contrôle + la signature (voir Vérification), puis faites pointer executable_path / executablePath (ou CLEARCOTE_BINARY) vers le nouveau chrome.
• Docker : docker pull teamflatearth/clearcote pour obtenir la dernière image, puis recréez votre conteneur. Les clés gratuites nécessitent une image construite à partir du SDK 0.30.0 ou plus récent. Avec une clé, montez -v clearcote-cache:/opt/xdg-cache pour que le build sous licence ne soit téléchargé qu’une fois, et non dans chaque nouveau conteneur. Voir Déploiement.

Le build sous licence — toujours à jour, et en premier

Le build sous licence suit le dernier Chromium et les patchs les plus récents : vous recevez les mises à jour sans recompiler vous-même. Définissez CLEARCOTE_LICENSE_KEY, passez licenseKey ou lancez clearcote login (Python/Node ; npx clearcote login pour une installation npm locale) — la commande vérifie la clé et l’enregistre dans ~/.clearcote/license.key, que lisent tous les SDK, .NET compris. Il existe deux façons d’obtenir une clé :

• Gratuit avec GitHub — un navigateur à la fois, sans frais. Connectez-vous avec un compte GitHub qui existe depuis au moins 30 jours, ouvrez « Licenses » dans votre tableau de bord, cliquez sur « Connect GitHub and get it free », puis sur « Claim my free key » (une par compte GitHub). La clé est valable 30 jours ; renouvelez-la gratuitement depuis la même page avant son expiration.
• Pro — le même build, sans limite de navigateurs simultanés pendant la bêta, avec les anciens builds, l’épinglage de version et le canal preview, plus un support par e-mail assuré par le propriétaire du projet.

Les nouvelles versions majeures arrivent d’abord sur le build sous licence. Dès qu’une nouvelle majeure de Chromium est compilée, elle est disponible immédiatement sur Gratuit avec GitHub et Pro ; le build ouvert la reçoit plus tard — avec pour objectif environ 2 mois après la sortie (il est aujourd’hui sur Chromium 149). Le build ouvert reste toujours entièrement ouvert et reproductible ; le build sous licence reçoit la plus récente plus tôt.

Comment les navigateurs sous licence sont comptés

Chaque navigateur démarré avec une clé prend un slot auprès du serveur de licences et le rend à sa fermeture. Votre tableau de bord indique combien de slots sont utilisés, et clearcote info affiche le même décompte.

• Gratuit avec GitHub compte chaque navigateur. Un seul slot : un deuxième navigateur — dans le même programme, dans un autre programme ou sur une autre machine — est refusé avec The free tier runs one browser at a time, and one is already running tant que le premier n’est pas fermé. Un navigateur qui a planté sans se fermer libère son slot dans un délai de 6 minutes.
• Pro compte les machines, sans plafond pendant la bêta. Tous les navigateurs d’une même machine partagent le slot de cette machine.
• Les clés gratuites nécessitent le SDK 0.30.0 ou plus récent (Python, Node et .NET), car pour compter chaque navigateur, le SDK doit signaler chaque lancement et maintenir la licence à jour tant que ce navigateur tourne. Un SDK plus ancien reçoit SDK_UPGRADE_REQUIRED avec la commande de mise à jour, et un SDK plus ancien qui atteint malgré tout le moteur y est refusé. Les clés Pro fonctionnent avec les anciens SDK, comme avant.
• Un navigateur gratuit s’arrête quand son slot disparaît. La vérification est continue, pas seulement au démarrage : si la clé est révoquée, si le slot est restitué ailleurs ou si la licence dépasse sa limite, un navigateur gratuit déjà ouvert s’arrête en 2 à 3 minutes environ. Les courtes coupures réseau (un ou deux heartbeats manqués) sont absorbées ; une panne de plus de 2 à 3 minutes environ arrête un navigateur gratuit de la même façon.
• L’offre gratuite exécute toujours le dernier build. Demander un ancien build sous licence ou le canal preview renvoie FREE_LATEST_ONLY ; l’épinglage d’un build est une fonctionnalité Pro.
• Téléchargements avec une clé gratuite : jusqu’à 10 builds différents par période de 24 heures. Un même build ne compte qu’une fois, quel que soit le nombre de lancements.

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

Après une mise à jour, revérifiez

Un nouveau build peut modifier un signal. Relancez vos tests d’empreinte (par exemple CreepJS) et, si vous utilisez un profil importé, vérifiez qu’il se charge toujours de façon cohérente — voir Vérification. Le build ouvert actuel est v0.1.0-pre.22 (Chromium 149.0.7827.114) ; le build sous licence actuel est 153.0.8010.36-r28. La feuille de route indique ce qui arrive ensuite.