Mantendo o Clearcote atualizado

Sem chave de licença, cada versão do SDK fica fixada em um build aberto com SHA-256 verificado, e atualizar é só subir a versão do pacote, como de costume. Com uma chave, o SDK busca o build licenciado atual a cada inicialização — sem precisar subir versão nenhuma.

Quais builds estão disponíveis

As versões major do Chromium que distribuímos hoje ou nas quais estamos trabalhando, e quando cada plano recebe cada uma:

Usuários do SDK (recomendado)

Atualize o pacote do mesmo jeito que você atualiza qualquer dependência:

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

No próximo launch(), o SDK percebe que o build de que precisa não está em cache, faz o download — o build aberto do GitHub Releases, o build licenciado do clearcotelabs.com — e verifica o SHA-256 antes de usar. Nada roda sem verificação. Cada build fica em cache separadamente, no diretório de cache do usuário — %LOCALAPPDATA%\clearcote\Cache no Windows, ~/.cache/clearcote no Linux (defina CLEARCOTE_CACHE para mudar o local) —, então cada um é baixado uma única vez. Builds antigos ficam guardados até você rodar clearcote clear-cache.

Atualizar o build aberto sem atualizar o SDK

Sem chave, ative a atualização automática para usar o build aberto mais recente do GitHub em vez do build fixado pelo SDK. Ele é verificado contra o SHA256SUMS.txt daquela versão (e contra a chave de assinatura quando o gpg está instalado); se o GitHub estiver inacessível, o SDK volta para o build fixado. Pelo terminal, clearcote update faz o mesmo. Com uma chave, isso não muda nada — você já recebe o build licenciado atual.

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

O navegador em si nunca “liga para casa” nem se atualiza sozinho. Sem chave, o navegador só muda quando você sobe a versão do SDK ou ativa o autoUpdate. Com uma chave, o SDK pega cada novo build licenciado na próxima inicialização; no Pro, dá para manter um build fixo com version.

Escolhendo um build

Passe version (ou defina CLEARCOTE_BROWSER_VERSION): "latest", uma major como "153", uma versão exata "153.0.8010.36" ou uma revisão licenciada "r28" / "153.0.8010.36-r28". Uma versão ou major é conferida no catálogo publicado, e uma revisão, no servidor de licenças, antes de qualquer download. releaseChannel: "preview" (release_channel em Python, ou CLEARCOTE_RELEASE_CHANNEL=preview) pega um build de preview quando houver um. No build licenciado, builds mais antigos, fixação de versão e o canal de preview são recursos do Pro — chaves gratuitas sempre recebem o mais recente.

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

Usuários do binário direto / Docker

• Binário direto (só o build aberto — o build licenciado roda pelo SDK, pelo clearcote serve ou pela imagem Docker): baixe o novo arquivo compactado na página de Releases, verifique o checksum + a assinatura (veja Verificação) e aponte executable_path / executablePath (ou CLEARCOTE_BINARY) para o novo chrome.
• Docker: docker pull teamflatearth/clearcote para pegar a imagem mais recente e, depois, recrie o seu contêiner. Chaves gratuitas precisam de uma imagem gerada a partir do SDK 0.30.0 ou mais recente. Com uma chave, monte -v clearcote-cache:/opt/xdg-cache para que o build licenciado seja baixado uma vez só, e não em cada contêiner novo. Veja Deploy.

O build licenciado — sempre atual, e primeiro

O build licenciado acompanha o Chromium mais recente e os patches mais novos, então você recebe as atualizações sem recompilar nada manualmente. Defina CLEARCOTE_LICENSE_KEY, passe licenseKey ou rode clearcote login (Python/Node; npx clearcote login em uma instalação local do npm) — ele valida a chave e a salva em ~/.clearcote/license.key, que todos os SDKs leem, inclusive o .NET. Há duas formas de conseguir uma chave:

• Grátis com GitHub — um navegador por vez, sem custo. Entre com uma conta do GitHub que tenha pelo menos 30 dias, abra Licenses no seu painel, clique em Connect GitHub and get it free e depois em Claim my free key (uma por conta do GitHub). A chave vale por 30 dias; renove-a de graça na mesma página antes que ela expire.
• Pro — o mesmo build, sem limite de navegadores simultâneos durante o beta, com builds mais antigos, fixação de versão e o canal de preview, além de suporte por e-mail com o próprio dono.

Novas majors chegam primeiro ao build licenciado. Quando uma nova major do Chromium é compilada, ela fica disponível no Grátis com GitHub e no Pro imediatamente; o build aberto recebe essa major depois — a meta é cerca de 2 meses após o lançamento (hoje ele está no Chromium 149). O build aberto é sempre totalmente aberto e reproduzível; o build licenciado recebe a major mais nova antes.

Como os navegadores licenciados são contados

Cada navegador iniciado com uma chave ocupa um slot no servidor de licenças e o devolve quando é fechado. O seu painel mostra quantos estão em uso, e clearcote info exibe a mesma contagem.

• O Grátis com GitHub conta cada navegador. É um slot só, então um segundo navegador — no mesmo programa, em outro programa ou em outra máquina — é recusado com The free tier runs one browser at a time, and one is already running até o primeiro ser fechado. Um navegador que travou sem fechar libera o slot em até 6 minutos.
• O Pro conta máquinas, sem limite durante o beta. Todos os navegadores de uma máquina compartilham o slot dessa máquina.
• Chaves gratuitas exigem o SDK 0.30.0 ou mais recente (Python, Node e .NET), porque contar cada navegador exige que o SDK informe cada inicialização e mantenha a licença válida enquanto aquele navegador roda. Um SDK mais antigo recebe SDK_UPGRADE_REQUIRED com o comando de atualização, e um SDK mais antigo que chegue ao motor mesmo assim é recusado ali. Chaves Pro continuam funcionando com SDKs mais antigos, como antes.
• Um navegador gratuito é encerrado quando perde o slot. A verificação é contínua, não só na inicialização: se a chave for revogada, se o slot for devolvido em outro lugar ou se a licença passar do limite, um navegador gratuito que já esteja aberto é encerrado em cerca de 2 a 3 minutos. Quedas curtas de rede (um ou dois heartbeats perdidos) são toleradas; uma interrupção de mais de cerca de 2 a 3 minutos encerra um navegador gratuito da mesma forma.
• O plano gratuito sempre roda o build mais recente. Pedir um build licenciado mais antigo ou o canal de preview retorna FREE_LATEST_ONLY; fixar um build é recurso do Pro.
• Downloads com uma chave gratuita: até 10 builds diferentes a cada 24 horas. O mesmo build conta uma vez só, não importa quantas vezes você o inicie.

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

Depois de atualizar, verifique de novo

Um build novo pode alterar algum sinal. Rode de novo os seus testes de fingerprint (por exemplo, CreepJS) e, se você usa um perfil importado, confirme que ele ainda carrega de forma coerente — veja Verificação. O build aberto atual é o v0.1.0-pre.22 (Chromium 149.0.7827.114); o build licenciado atual é o 153.0.8010.36-r28. O roadmap mostra o que vem por aí.