はじめに

Blipit を最新に保つ

Odoo と通常の script タグは自動で最新に保たれます。パッケージマネージャーでインストールしたものはインストールしたバージョンのままなので、新しいバージョンが出ると Blipit がお知らせします。app.blipit.io のプロジェクトに表示されるバナー、重要なリリースのときのメール、そして開発コンソールの 1 行です。どれも新しいバージョンで何が直ったかと、更新するための正確なコマンドを示します。

1自動で更新されるもの

https://blipit.io/sdk/blipit.js の script タグ：常に最新バージョンです。
Odoo：モジュールは次回の Blipit との同期後に最新のブラウザー SDK を読み込みます。新しい blipit_monitor のバージョンが出ると、管理者にはすべての Odoo 画面の上部に手順付きの更新バーが表示されます。
@blipit/browser 0.3.11 以降、npm でのインストールとバージョンを指定した script タグ（https://blipit.io/sdk/0.3.11/blipit.js）は、バグ報告画面、「バグを報告」ボタン、フィードバックフォーム、session replay を https://blipit.io/sdk/0.3/ から読み込みます。ここには常に互換性のある最新の 0.3 ビルドがあります。インストール済みのコアは各部分に自身のバージョンを伝え、そのコアに対応しない部分は実行を拒否して代わりに正確なバージョンが読み込まれるため、何も壊れません。
それ以外（バンドル内のコア、@blipit/nextjs、@blipit/node、React Native、Python、PHP、Ruby、Go、Java、.NET、Swift、Flutter）は、パッケージを更新したときだけ変わります。

2正確なバージョンに固定する

すべての部分をインストールした正確なバージョンから読み込むには、init に sdkChannel: "exact" を渡します。セキュリティポリシーで Subresource Integrity が必要な場合に使ってください。integrity ハッシュは https://blipit.io/sdk/0.3.11/blipit-report.js のような正確なバージョンのパスでしか機能しません。0.3 のパスはリリースごとに変わるためです。正確なバージョンのファイルは公開後に変わることはなく、すべてのパスは blipit.io から配信されます。

Blipit.init({
  key: "blipit_pk_...",
  sdkChannel: "exact",
});

3更新バナー

Blipit は、各プロジェクトが過去 7 日間にどの SDK とバージョンでイベントを送ったかを把握しています。新しいリリースが出ると、プロジェクトページとプロジェクト一覧に「このプロジェクトは @blipit/browser 0.3.7 を使用しています。0.3.11 が利用できます」のようなバナーが表示され、お使いのバージョン以降の変更点と、スタックに合った更新コマンド（npm、pnpm、yarn、pip、composer など）がコピーボタン付きで示されます。× ボタンはそのバージョンについてのみ非表示にし、次のリリースで再び表示されます。

4大事なときのメール

重要またはセキュリティ修正とされたリリースでは、過去 14 日間に影響を受けるバージョンからイベントを送ったプロジェクトについてのみ、ワークスペースのオーナーにメールを 1 通送ります。リリースとプロジェクトごとに最大 1 回です。通常のリリースはバナーのみです。これらのメールを止めるには、設定で「SDK の更新で重要な問題が修正されたらメールで知らせる」をオフにするか、メール下部のリンクを使ってください。

5開発コンソールのお知らせ

開発中、新しいバージョンが出ると、各 SDK はセッションまたはプロセスごとに 1 行を出力します。最新バージョンは SDK がもともと Blipit から受け取っている応答から読み取るので、リクエストは増えず、本番環境や訪問者に表示されることはありません。

ブラウザーと Next.js：localhost、127.0.0.1、.local ホスト上、debug: true のとき、または NODE_ENV が development のとき。「バグを報告」の設定と一緒に届くため、feedbackWidget: false ではお知らせは出ません。
Node、Python、PHP、Ruby、Go：環境が development のとき、または debug がオンのとき。
React Native：__DEV__ ビルドで。

[blipit] 0.3.11 is available (you have 0.3.7) — Loads the newest compatible bug reporter automatically… — npm install @blipit/browser@latest

6更新コマンド

npm

npm install @blipit/browser@latest
npm install @blipit/nextjs@latest
npm install @blipit/node@latest
npm install @blipit/react-native@latest

pnpm

pnpm add @blipit/browser@latest

yarn

yarn add @blipit/browser@latest

Python

pip install -U blipit

PHP

composer update blipit/blipit

Ruby

bundle update blipit

go get github.com/blipit-io/blipit-go@latest

.NET

dotnet add package Blipit

Script タグ

<script src="https://blipit.io/sdk/0.3.11/blipit.js" defer></script>

知っておくと便利

pnpm 11 は新しいリリースを 1 日待ってからインストールします（minimum-release-age）。そのためリリース当日の pnpm add は、何も言わずに前のバージョンをインストールします。翌日にもう一度試すか、pnpm add @blipit/browser@<version> --config.minimum-release-age=0 を実行するか、pnpm-workspace.yaml の minimumReleaseAgeExclude に @blipit/* を追加してください。
Blipit は、.NET、Java、Android、Swift、Flutter、および 0.2.1 より前の Python、PHP、Ruby、Go、React Native ではインストール済みバージョンをまだ把握できないため、それらのプロジェクトにはバナーもメールも届きません。受け取るには 0.2.1 以降に更新してください。

お困りですか？support@blipit.io までメールしてください。各プロジェクトのキーと正確な DSN は app.blipit.io の「APIキー」にあります。