Erste Schritte

Blipit auf dem neuesten Stand halten

Odoo und das einfache Script-Tag bleiben von selbst aktuell. Alles, was du über einen Paketmanager installierst, bleibt auf der installierten Version. Deshalb sagt dir Blipit, wenn eine neuere erscheint: mit einem Banner am Projekt in app.blipit.io, einer E-Mail, wenn ein Release wichtig ist, und einer Zeile in deiner Entwicklungskonsole. Jeder Hinweis nennt, was die neue Version behebt, und den genauen Befehl zum Aktualisieren.

1Was sich von selbst aktualisiert

  • Script-Tag von https://blipit.io/sdk/blipit.js: immer die neueste Version.
  • Odoo: Das Modul lädt nach dem nächsten Abgleich mit Blipit das neueste Browser-SDK. Wenn eine neue blipit_monitor-Version erscheint, sehen Administratoren oben auf jedem Odoo-Bildschirm eine Update-Leiste mit den Schritten.
  • Seit @blipit/browser 0.3.11 laden npm-Installationen und Script-Tags mit Versionsangabe (https://blipit.io/sdk/0.3.11/blipit.js) den Fehlermelder, den Button „Fehler melden“, das Feedback-Formular und Session Replay von https://blipit.io/sdk/0.3/, wo immer der neueste kompatible 0.3-Build liegt. Dein installierter Kern teilt jedem Teil seine Version mit; ein Teil, der diesen Kern nicht unterstützt, startet nicht und stattdessen wird die exakte Version geladen, damit nichts kaputtgeht.
  • Alles andere (der Kern in deinem Bundle, @blipit/nextjs, @blipit/node, React Native, Python, PHP, Ruby, Go, Java, .NET, Swift, Flutter) ändert sich erst, wenn du das Paket aktualisierst.

2Die exakte Version festlegen

Um jeden Teil aus genau der installierten Version zu laden, übergib sdkChannel: "exact" an init. Nutze das, wenn deine Sicherheitsrichtlinie Subresource Integrity verlangt: Ein Integrity-Hash funktioniert nur auf einem Pfad mit exakter Version wie https://blipit.io/sdk/0.3.11/blipit-report.js, weil sich der 0.3-Pfad mit jedem Release ändert. Dateien mit exakter Version ändern sich nach der Veröffentlichung nie; alle Pfade kommen von blipit.io.

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

3Das Update-Banner

Blipit sieht, mit welchem SDK und welcher Version jedes Projekt in den letzten 7 Tagen Events gesendet hat. Ist ein neueres Release erschienen, zeigen die Projektseite und die Projektliste ein Banner wie: Dieses Projekt nutzt @blipit/browser 0.3.7, 0.3.11 ist verfügbar, mit den Änderungen seit deiner Version und dem Update-Befehl für deinen Stack (npm, pnpm, yarn, pip, composer usw.) samt Kopieren-Button. Das Kreuz blendet es nur für diese Version aus; das nächste Release zeigt es wieder.

4E-Mails, wenn es darauf ankommt

Releases, die als wichtig oder als Sicherheitsfix markiert sind, senden eine E-Mail an die Inhaber des Workspaces, nur für Projekte, die in den letzten 14 Tagen Events von einer betroffenen Version gesendet haben, und höchstens einmal pro Release und Projekt. Normale Releases zeigen nur das Banner. Um diese E-Mails zu stoppen, schalte in den Einstellungen „Schick mir eine E-Mail, wenn ein SDK-Update etwas Wichtiges behebt“ aus oder nutze den Link unten in der E-Mail.

5Der Hinweis in deiner Entwicklungskonsole

In der Entwicklung gibt jedes SDK pro Sitzung oder Prozess eine Zeile aus, wenn eine neuere Version erschienen ist. Es liest die neueste Version aus einer Antwort, die das SDK ohnehin von Blipit bekommt, fügt also keine Anfrage hinzu, und erscheint nie in der Produktion oder bei deinen Besuchern.

  • Browser und Next.js: auf localhost, 127.0.0.1 und .local-Hosts, mit debug: true oder wenn NODE_ENV development ist. Der Hinweis kommt mit den Einstellungen für „Fehler melden“, mit feedbackWidget: false gibt es also keinen.
  • Node, Python, PHP, Ruby und Go: wenn die Umgebung development ist oder debug an ist.
  • React Native: in __DEV__-Builds.
sh
[blipit] 0.3.11 is available (you have 0.3.7) — Loads the newest compatible bug reporter automatically… — npm install @blipit/browser@latest

6Update-Befehle

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
go get github.com/blipit-io/blipit-go@latest
.NET
dotnet add package Blipit
Script-Tag
<script src="https://blipit.io/sdk/0.3.11/blipit.js" defer></script>

Gut zu wissen

  • pnpm 11 wartet einen Tag, bevor es ein neues Release installiert (minimum-release-age). Am Release-Tag installiert pnpm add daher stillschweigend die vorherige Version. Versuche es morgen erneut, führe pnpm add @blipit/browser@<version> --config.minimum-release-age=0 aus oder füge @blipit/* zu minimumReleaseAgeExclude in pnpm-workspace.yaml hinzu.
  • Blipit sieht die installierte Version noch nicht für .NET, Java, Android, Swift und Flutter, und nicht für Python, PHP, Ruby, Go und React Native vor 0.2.1. Diese Projekte bekommen daher kein Banner und keine E-Mail. Aktualisiere auf 0.2.1 oder neuer, um sie zu erhalten.

Kommen Sie nicht weiter? Schreiben Sie an support@blipit.io. Schlüssel und den genauen DSN jedes Projekts finden Sie unter API-Schlüssel in app.blipit.io.