Clearcote aktuell halten

Ohne Lizenzschlüssel ist jede SDK-Version an einen per SHA-256 verifizierten offenen Build gepinnt, und ein Update ist ein ganz normales Anheben der Paketversion. Mit Schlüssel holt das SDK bei jedem Start den aktuellen lizenzierten Build — ohne dass Sie eine Version anheben müssen.

Welche Builds verfügbar sind

Die Chromium-Major-Versionen, die wir derzeit ausliefern oder an denen wir arbeiten, und wann welche Stufe sie bekommt:

SDK-Nutzer (empfohlen)

Aktualisieren Sie das Paket wie jede andere Abhängigkeit:

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

Beim nächsten launch() bemerkt das SDK, dass der benötigte Build nicht im Cache liegt, lädt ihn herunter — den offenen Build von GitHub Releases, den lizenzierten Build von clearcotelabs.com — und verifiziert den SHA-256-Hash vor der Nutzung. Nichts läuft unverifiziert. Jeder Build landet einzeln in Ihrem Benutzer-Cache-Verzeichnis — %LOCALAPPDATA%\clearcote\Cache unter Windows, ~/.cache/clearcote unter Linux (ein anderes Verzeichnis setzen Sie mit CLEARCOTE_CACHE) — und wird daher nur einmal heruntergeladen. Alte Builds bleiben erhalten, bis Sie clearcote clear-cache ausführen.

Offenen Build aktualisieren, ohne das SDK zu aktualisieren

Ohne Schlüssel können Sie Auto-Update aktivieren, um statt des im SDK gepinnten Builds den neuesten offenen Build von GitHub zu nehmen. Er wird gegen die SHA256SUMS.txt des jeweiligen Release verifiziert (und gegen den Signaturschlüssel, wenn gpg installiert ist); ist GitHub nicht erreichbar, fällt das Update auf den gepinnten Build zurück. In der Shell erledigt clearcote update dasselbe. Mit Schlüssel ändert sich dadurch nichts — Sie bekommen ohnehin den aktuellen lizenzierten Build.

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

Der Browser selbst telefoniert nie nach Hause und aktualisiert sich nie selbst. Ohne Schlüssel ändert sich der Browser nur, wenn Sie das SDK aktualisieren oder autoUpdate einschalten. Mit Schlüssel übernimmt das SDK jeden neuen lizenzierten Build beim nächsten Start; mit Pro können Sie per version an einem Build festhalten.

Einen Build auswählen

Übergeben Sie version (oder setzen Sie CLEARCOTE_BROWSER_VERSION): "latest", eine Major-Version wie "153", eine exakte Version "153.0.8010.36" oder eine lizenzierte Revision "r28" / "153.0.8010.36-r28". Eine Version oder Major-Version wird gegen den veröffentlichten Katalog geprüft, eine Revision gegen den Lizenzserver — bevor irgendetwas heruntergeladen wird. releaseChannel: "preview" (release_channel in Python oder CLEARCOTE_RELEASE_CHANNEL=preview) nimmt einen Preview-Build, sofern es einen gibt. Beim lizenzierten Build sind ältere Builds, Pinning und der Preview-Kanal Pro-Funktionen — kostenlose Schlüssel bekommen immer den neuesten.

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

Direkte Nutzung / Docker

• Direkte Binary (nur offener Build — der lizenzierte Build läuft über das SDK, clearcote serve oder das Docker-Image): Laden Sie das neue Archiv von der Releases-Seite herunter, verifizieren Sie Prüfsumme + Signatur (siehe Verifizierung) und lassen Sie executable_path / executablePath (oder CLEARCOTE_BINARY) auf die neue chrome-Binary zeigen.
• Docker: docker pull teamflatearth/clearcote holt das neueste Image; erstellen Sie danach Ihren Container neu. Kostenlose Schlüssel brauchen ein Image, das aus SDK 0.30.0 oder neuer gebaut wurde. Mit Schlüssel mounten Sie -v clearcote-cache:/opt/xdg-cache, damit der lizenzierte Build nur einmal heruntergeladen wird statt in jeden neuen Container. Siehe Deployment.

Der lizenzierte Build — immer aktuell und immer zuerst

Der lizenzierte Build folgt dem neuesten Chromium und den neuesten Patches, Sie bekommen Updates also ohne manuelles Neubauen. Setzen Sie CLEARCOTE_LICENSE_KEY, übergeben Sie licenseKey oder führen Sie clearcote login aus (Python/Node; npx clearcote login bei lokaler npm-Installation) — der Befehl prüft den Schlüssel und speichert ihn in ~/.clearcote/license.key, wo ihn jedes SDK liest, .NET eingeschlossen. Es gibt zwei Wege zu einem Schlüssel:

• Kostenlos mit GitHub — ein Browser gleichzeitig, ohne Kosten. Melden Sie sich mit einem GitHub-Konto an, das mindestens 30 Tage alt ist, öffnen Sie in Ihrem Dashboard Licenses, klicken Sie auf Connect GitHub and get it free und dann auf Claim my free key (einer pro GitHub-Konto). Der Schlüssel gilt 30 Tage; verlängern Sie ihn vor Ablauf kostenlos auf derselben Seite.
• Pro — derselbe Build ohne Obergrenze für gleichzeitige Browser während der Beta, dazu ältere Builds, Versions-Pinning und der Preview-Kanal sowie E-Mail-Support direkt vom Inhaber.

Neue Major-Versionen kommen zuerst in den lizenzierten Build. Sobald eine neue Chromium-Major-Version gebaut ist, steht sie sofort in „Kostenlos mit GitHub“ und Pro bereit; der offene Build bekommt sie später — angestrebt sind etwa 2 Monate nach dem Release (heute basiert er auf Chromium 149). Der offene Build ist immer vollständig offen und reproduzierbar; der lizenzierte Build bekommt die neueste Version früher.

Wie lizenzierte Browser gezählt werden

Jeder mit Schlüssel gestartete Browser belegt einen Slot beim Lizenzserver und gibt ihn beim Schließen wieder frei. Ihr Dashboard zeigt, wie viele gerade belegt sind, und clearcote info gibt dieselbe Zahl aus.

• „Kostenlos mit GitHub“ zählt jeden Browser. Es gibt einen Slot, daher wird ein zweiter Browser — im selben Programm, in einem anderen Programm oder auf einem anderen Rechner — mit The free tier runs one browser at a time, and one is already running abgelehnt, bis der erste geschlossen ist. Ein Browser, der abgestürzt ist, ohne sich zu schließen, gibt seinen Slot innerhalb von 6 Minuten frei.
• Pro zählt Rechner, während der Beta ohne Obergrenze. Alle Browser auf einem Rechner teilen sich dessen Slot.
• Kostenlose Schlüssel brauchen SDK 0.30.0 oder neuer (Python, Node und .NET), denn um jeden Browser zu zählen, muss das SDK jeden Start melden und die Lizenz aktuell halten, solange der Browser läuft. Ein älteres SDK bekommt SDK_UPGRADE_REQUIRED samt Upgrade-Befehl, und ein älteres SDK, das trotzdem bis zur Engine durchkommt, wird dort abgewiesen. Pro-Schlüssel funktionieren wie bisher auch mit älteren SDKs.
• Ein kostenloser Browser stoppt, wenn sein Slot wegfällt. Die Prüfung läuft fortlaufend, nicht nur beim Start: Wird der Schlüssel widerrufen, der Slot an anderer Stelle freigegeben oder das Limit der Lizenz überschritten, beendet sich ein bereits geöffneter kostenloser Browser innerhalb von etwa 2 bis 3 Minuten. Kurze Netzwerkaussetzer (ein oder zwei verpasste Heartbeats) werden abgefangen; ein Ausfall von mehr als etwa 2 bis 3 Minuten stoppt einen kostenlosen Browser auf die gleiche Weise.
• Der kostenlose Tarif nutzt immer den neuesten Build. Wer einen älteren lizenzierten Build oder den Preview-Kanal anfordert, bekommt FREE_LATEST_ONLY; einen Build zu pinnen ist eine Pro-Funktion.
• Downloads mit kostenlosem Schlüssel: bis zu 10 verschiedene Builds pro 24 Stunden. Derselbe Build zählt einmal, egal wie oft Sie ihn starten.

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

Nach dem Upgrade erneut prüfen

Ein neuer Build kann ein Signal verschieben. Führen Sie Ihre Fingerprint-Tests erneut aus (z. B. CreepJS) und prüfen Sie bei einem importierten Profil, ob es weiterhin kohärent lädt — siehe Verifizierung. Der aktuelle offene Build ist v0.1.0-pre.22 (Chromium 149.0.7827.114); der aktuelle lizenzierte Build ist 153.0.8010.36-r28. Was als Nächstes kommt, steht auf der Roadmap.