Clearcote を最新の状態に保つ

ライセンスキーがない場合、SDK の各バージョンは SHA-256 で検証済みのオープンビルド 1 つに固定されており、更新は通常のパッケージのバージョンアップで済みます。キーがある場合は、SDK が起動のたびに現行のライセンスビルドを取得するので、バージョンアップは不要です。

利用できるビルド

現在提供中または開発中の Chromium メジャーバージョンと、各ティアで利用できるようになる時期：

SDK を使う場合（推奨）

ほかの依存関係と同じようにパッケージを更新します：

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

次に launch() を呼んだとき、SDK は必要なビルドがキャッシュにないことを検知してダウンロードし（オープンビルドは GitHub Releases から、ライセンスビルドは clearcotelabs.com から）、使用前に SHA-256 を検証します。検証されていないものが実行されることはありません。ビルドはビルドごとにユーザーのキャッシュディレクトリ（Windows では %LOCALAPPDATA%\clearcote\Cache、Linux では ~/.cache/clearcote。場所を変えるには CLEARCOTE_CACHE を設定）にキャッシュされるため、ダウンロードはそれぞれ 1 回だけです。古いビルドは clearcote clear-cache を実行するまで残ります。

SDK をアップグレードせずにオープンビルドを更新する

キーがない場合は、自動更新を有効にすると、SDK が固定しているビルドの代わりに GitHub 上の最新のオープンビルドを使えます。そのリリースの SHA256SUMS.txt と照合して検証し（gpg がインストールされていれば署名鍵とも照合します）、GitHub に接続できない場合は固定のビルドにフォールバックします。シェルからは clearcote update で同じことができます。キーがある場合は何も変わりません。すでに現行のライセンスビルドを使っているからです。

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

ブラウザ自体が外部へ勝手に通信したり、自らを更新したりすることはありません。キーがない場合、ブラウザが変わるのは SDK をバージョンアップしたときか、autoUpdate を有効にしたときだけです。キーがある場合、SDK は新しいライセンスビルドを次回の起動時に取り込みます。Pro では version でビルドを固定しておけます。

ビルドを選ぶ

version を渡します（または CLEARCOTE_BROWSER_VERSION を設定します）。指定できるのは "latest"、"153" のようなメジャーバージョン、"153.0.8010.36" のような正確なバージョン、またはライセンスビルドのリビジョン "r28" / "153.0.8010.36-r28" です。何かをダウンロードする前に、バージョンやメジャーは公開カタログと、リビジョンはライセンスサーバーと照合されます。releaseChannel: "preview"（Python では release_channel、または CLEARCOTE_RELEASE_CHANNEL=preview）を指定すると、プレビュービルドがあればそれを取得します。ライセンスビルドでは、古いビルド、バージョン固定、プレビューチャンネルは Pro の機能です。無料キーでは常に最新版が使われます。

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

バイナリを直接使う場合 / Docker を使う場合

• バイナリを直接使う場合（オープンビルドのみ。ライセンスビルドは SDK、clearcote serve、Docker イメージのいずれかを通じて実行します）：Releases ページから新しいアーカイブをダウンロードし、チェックサムと署名を検証して（検証を参照）、executable_path / executablePath（または CLEARCOTE_BINARY）を新しい chrome に向けます。
• Docker：docker pull teamflatearth/clearcote で最新のイメージを取得し、コンテナを作り直します。無料キーには、SDK 0.30.0 以降でビルドされたイメージが必要です。キーを使う場合は -v clearcote-cache:/opt/xdg-cache をマウントしてください。そうすれば、ライセンスビルドは新しいコンテナのたびにダウンロードされることなく、1 回のダウンロードで済みます。デプロイを参照してください。

ライセンスビルド：常に最新、しかもいち早く

ライセンスビルドは最新の Chromium と最新のパッチに追従するため、手動で再ビルドしなくても更新を受け取れます。CLEARCOTE_LICENSE_KEY を設定するか、licenseKey を渡すか、clearcote login を実行してください（Python / Node の場合。npm でローカルにインストールしたときは npx clearcote login）。このコマンドはキーを確認して ~/.clearcote/license.key に保存します。このファイルは .NET を含むすべての SDK が読み込みます。キーの入手方法は 2 つあります：

• GitHub で無料：同時に 1 つのブラウザを無料で使えます。作成から 30 日以上経った GitHub アカウントでサインインし、ダッシュボードの「Licenses」を開いて「Connect GitHub and get it free」をクリックし、続いて「Claim my free key」をクリックします（GitHub アカウント 1 つにつき 1 つ）。キーの有効期間は 30 日です。期限が切れる前に、同じページから無料で更新してください。
• Pro：同じビルドを、ベータ期間中は同時起動数の上限なしで使えます。古いビルド、バージョン固定、プレビューチャンネルも利用でき、オーナーによるメールサポートも付きます。

新しいメジャーバージョンは、まずライセンスビルドに届きます。新しい Chromium メジャーがビルドされると、「GitHub で無料」と Pro ではすぐに利用できます。オープンビルドにはその後で入り、目標はリリースから約 2 か月後です（現在は Chromium 149）。オープンビルドは常に完全にオープンで、再現可能です。ライセンスビルドは最新のものをより早く受け取ります。

ライセンスブラウザのカウント方法

キーを使って起動したブラウザは、それぞれライセンスサーバーからスロットを 1 つ取得し、終了時に返却します。使用中の数はダッシュボードに表示され、clearcote info でも同じ数が表示されます。

• 「GitHub で無料」はすべてのブラウザをカウントします。スロットは 1 つだけなので、最初のブラウザが終了するまで、2 つ目のブラウザは（同じプログラム内でも、別のプログラムでも、別のマシンでも）The free tier runs one browser at a time, and one is already running というエラーで拒否されます。正常に終了せずクラッシュしたブラウザのスロットは、6 分以内に解放されます。
• Pro はマシン単位でカウントし、ベータ期間中は上限がありません。1 台のマシン上のブラウザはすべて、そのマシンのスロットを共有します。
• 無料キーには SDK 0.30.0 以降が必要です（Python、Node、.NET）。すべてのブラウザをカウントするには、SDK が起動のたびにそれを報告し、ブラウザの実行中はライセンスを有効な状態に保つ必要があるためです。古い SDK にはアップグレード用のコマンドとともに SDK_UPGRADE_REQUIRED が返され、それでも古い SDK がエンジンまで到達した場合は、エンジン側で拒否されます。Pro キーは、これまでどおり古い SDK でも動作します。
• 無料のブラウザは、スロットがなくなると停止します。チェックは起動時だけでなく継続的に行われます。キーが失効した場合、スロットが別の場所から返却（チェックイン）された場合、またはライセンスが上限を超えた場合、すでに開いている無料のブラウザは約 2〜3 分以内に終了します。短時間のネットワーク断（ハートビートの 1〜2 回の取りこぼし）は吸収されますが、約 2〜3 分を超えて接続できない状態が続くと、同じように無料のブラウザは停止します。
• 無料キーでは常に最新ビルドが動きます。古いライセンスビルドやプレビューチャンネルを要求すると FREE_LATEST_ONLY が返されます。ビルドの固定は Pro の機能です。
• 無料キーでのダウンロード：24 時間あたり最大 10 個の異なるビルドまで。同じビルドは、何度起動しても 1 回とカウントされます。

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

アップグレード後は再検証を

新しいビルドでは、シグナルが変わることがあります。フィンガープリントのチェック（CreepJS など）を再実行し、インポートしたプロファイルを使っている場合は、引き続き整合性を保って読み込まれることを確認してください（検証を参照）。現在のオープンビルドは v0.1.0-pre.22（Chromium 149.0.7827.114）、現在のライセンスビルドは 153.0.8010.36-r28 です。今後の予定はロードマップで確認できます。