Giữ Clearcote luôn được cập nhật

Khi không có khóa giấy phép, mỗi phiên bản SDK được ghim với một bản build mở đã xác minh SHA-256, và việc cập nhật chỉ là nâng phiên bản package như bình thường. Khi có khóa, SDK tải bản build có giấy phép hiện hành ở mỗi lần khởi chạy — không cần nâng phiên bản.

Những bản build hiện có

Các Chromium major mà chúng tôi đang phát hành hoặc đang phát triển, và thời điểm mỗi gói nhận được chúng:

Người dùng SDK (khuyến nghị)

Nâng phiên bản package như khi bạn cập nhật bất kỳ dependency nào:

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

Ở lần launch() tiếp theo, SDK nhận thấy bản build cần dùng chưa có trong cache, tải nó về — bản build mở từ GitHub Releases, bản build có giấy phép từ clearcotelabs.com — và xác minh SHA-256 trước khi dùng. Không có gì chạy khi chưa được xác minh. Mỗi bản build được cache riêng trong thư mục cache của người dùng — %LOCALAPPDATA%\clearcote\Cache trên Windows, ~/.cache/clearcote trên Linux (đặt CLEARCOTE_CACHE để đổi vị trí) — nên mỗi bản chỉ cần tải một lần. Các bản build cũ được giữ lại cho đến khi bạn chạy clearcote clear-cache.

Cập nhật bản build mở mà không cần nâng cấp SDK

Khi không có khóa, hãy bật auto-update để dùng bản build mở mới nhất trên GitHub thay vì bản mà SDK ghim. Bản này được xác minh với SHA256SUMS.txt của bản phát hành đó (và với khóa ký nếu đã cài gpg); nếu không kết nối được tới GitHub, SDK quay về bản build đã ghim. Từ shell, clearcote update làm điều tương tự. Khi có khóa, tùy chọn này không thay đổi gì — bạn vốn đã nhận bản build có giấy phép hiện hành.

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

Bản thân trình duyệt không bao giờ tự gửi dữ liệu về (phone home) hay tự cập nhật. Khi không có khóa, trình duyệt chỉ thay đổi khi bạn nâng phiên bản SDK hoặc bật autoUpdate. Khi có khóa, SDK nhận từng bản build có giấy phép mới ở lần khởi chạy tiếp theo; Pro có thể giữ nguyên một bản build bằng version.

Chọn bản build

Truyền version (hoặc đặt CLEARCOTE_BROWSER_VERSION): "latest", một major như "153", một phiên bản cụ thể "153.0.8010.36", hoặc một revision có giấy phép "r28" / "153.0.8010.36-r28". Phiên bản hoặc major được đối chiếu với catalog đã công bố, còn revision được đối chiếu với licence server, trước khi tải bất cứ thứ gì. releaseChannel: "preview" (release_channel trong Python, hoặc CLEARCOTE_RELEASE_CHANNEL=preview) sẽ lấy bản build preview nếu có. Trên bản build có giấy phép, các bản build cũ, việc ghim phiên bản và kênh preview là tính năng của Pro — khóa miễn phí luôn nhận bản mới nhất.

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

Người dùng binary trực tiếp / Docker

• Binary trực tiếp (chỉ áp dụng cho bản build mở — bản build có giấy phép chạy qua SDK, clearcote serve hoặc Docker image): tải file nén mới từ trang Releases, xác minh checksum + chữ ký (xem Xác minh), rồi trỏ executable_path / executablePath (hoặc CLEARCOTE_BINARY) tới file chrome mới.
• Docker: chạy docker pull teamflatearth/clearcote để lấy image mới nhất, rồi tạo lại container. Khóa miễn phí cần image được build từ SDK 0.30.0 trở lên. Khi có khóa, hãy mount -v clearcote-cache:/opt/xdg-cache để bản build có giấy phép chỉ tải một lần thay vì tải lại vào mỗi container mới. Xem Triển khai.

Bản build có giấy phép — luôn mới nhất, và luôn có trước

Bản build có giấy phép bám theo Chromium mới nhất và các patch mới nhất, nên bạn nhận được cập nhật mà không phải tự build lại. Đặt CLEARCOTE_LICENSE_KEY, truyền licenseKey, hoặc chạy clearcote login (Python/Node; dùng npx clearcote login nếu cài npm cục bộ) — lệnh này kiểm tra khóa và lưu vào ~/.clearcote/license.key, file mà mọi SDK, kể cả .NET, đều đọc. Có hai cách để nhận khóa:

• Miễn phí với GitHub — mỗi lần một trình duyệt, không mất phí. Đăng nhập bằng tài khoản GitHub đã tạo ít nhất 30 ngày, mở Licenses trong dashboard, nhấn Connect GitHub and get it free, rồi Claim my free key (mỗi tài khoản GitHub một khóa). Khóa có hiệu lực 30 ngày; hãy gia hạn miễn phí ngay trên trang đó trước khi hết hạn.
• Pro — cùng bản build đó, không giới hạn số trình duyệt chạy đồng thời trong giai đoạn beta, có các bản build cũ, ghim phiên bản và kênh preview, cùng hỗ trợ qua email từ chủ dự án.

Các major mới đến với bản build có giấy phép trước. Khi một Chromium major mới được build, nó có ngay trên Miễn phí với GitHub và Pro; bản build mở nhận major đó sau — mục tiêu là khoảng 2 tháng sau khi phát hành (hiện bản build mở đang ở Chromium 149). Bản build mở luôn hoàn toàn mở và có thể tái tạo; bản build có giấy phép nhận major mới nhất sớm hơn.

Cách tính số trình duyệt có giấy phép

Mỗi trình duyệt khởi chạy bằng khóa sẽ lấy một slot từ licence server và trả lại khi đóng. Dashboard của bạn hiển thị số slot đang dùng, và clearcote info in ra cùng con số đó.

• Miễn phí với GitHub tính mọi trình duyệt. Chỉ có một slot, nên trình duyệt thứ hai — trong cùng chương trình, ở chương trình khác hay trên máy khác — sẽ bị từ chối với lỗi The free tier runs one browser at a time, and one is already running cho đến khi trình duyệt đầu tiên đóng. Trình duyệt bị crash mà không kịp đóng sẽ giải phóng slot trong vòng 6 phút.
• Pro tính theo máy, không giới hạn trong giai đoạn beta. Mọi trình duyệt trên cùng một máy dùng chung slot của máy đó.
• Khóa miễn phí cần SDK 0.30.0 trở lên (Python, Node và .NET), vì để tính mọi trình duyệt, SDK phải báo cáo từng lần khởi chạy và giữ giấy phép luôn được cập nhật trong khi trình duyệt đó chạy. SDK cũ hơn sẽ nhận SDK_UPGRADE_REQUIRED kèm lệnh nâng cấp, và SDK cũ nào vẫn đến được engine thì cũng bị từ chối ở đó. Khóa Pro vẫn hoạt động với SDK cũ như trước.
• Trình duyệt miễn phí sẽ dừng khi mất slot. Việc kiểm tra diễn ra liên tục, không chỉ lúc khởi động: nếu khóa bị thu hồi, slot bị check-in ở nơi khác, hoặc giấy phép vượt giới hạn, trình duyệt miễn phí đang mở sẽ tắt trong khoảng 2 đến 3 phút. Các lần rớt mạng ngắn (lỡ một hai heartbeat) sẽ được bỏ qua; mất kết nối lâu hơn khoảng 2 đến 3 phút cũng sẽ dừng trình duyệt miễn phí theo cách tương tự.
• Gói miễn phí luôn chạy bản build mới nhất. Yêu cầu một bản build có giấy phép cũ hơn hoặc kênh preview sẽ trả về FREE_LATEST_ONLY; ghim bản build là tính năng của Pro.
• Lượt tải với khóa miễn phí: tối đa 10 bản build khác nhau trong mỗi 24 giờ. Cùng một bản build chỉ tính một lần, dù bạn khởi chạy bao nhiêu lần.

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

Sau khi nâng cấp, hãy xác minh lại

Một bản build mới có thể làm thay đổi một tín hiệu. Hãy chạy lại các bài kiểm tra fingerprint (ví dụ CreepJS) và, nếu bạn dùng profile được import, hãy xác nhận profile đó vẫn tải lên nhất quán — xem Xác minh. Bản build mở hiện tại là v0.1.0-pre.22 (Chromium 149.0.7827.114); bản build có giấy phép hiện tại là 153.0.8010.36-r28. Lộ trình cho biết những gì sắp tới.