Mantener Blipit actualizado

1Lo que se actualiza solo

• Etiqueta script desde https://blipit.io/sdk/blipit.js: siempre la versión más reciente.
• Odoo: el módulo carga el SDK de navegador más reciente tras su siguiente sincronización con Blipit. Cuando sale una nueva versión de blipit_monitor, los administradores ven una barra de actualización en la parte superior de cada pantalla de Odoo con los pasos.
• Desde @blipit/browser 0.3.11, las instalaciones con npm y las etiquetas script que indican una versión (https://blipit.io/sdk/0.3.11/blipit.js) cargan el reportador, el botón Reportar un error, el formulario de comentarios y el session replay desde https://blipit.io/sdk/0.3/, que siempre tiene la compilación 0.3 compatible más reciente. Tu núcleo instalado indica su versión a cada parte; una parte que no admite ese núcleo se niega a ejecutarse y se carga la versión exacta en su lugar, así que nada se rompe.
• Todo lo demás (el núcleo de tu bundle, @blipit/nextjs, @blipit/node, React Native, Python, PHP, Ruby, Go, Java, .NET, Swift, Flutter) solo cambia cuando actualizas el paquete.

2Fijar la versión exacta

Para cargar cada parte desde la versión exacta que instalaste, pasa sdkChannel: "exact" a init. Úsalo cuando tu política de seguridad exija Subresource Integrity: un hash de integridad solo funciona en una ruta de versión exacta como https://blipit.io/sdk/0.3.11/blipit-report.js, porque la ruta 0.3 cambia con cada versión. Los archivos de versión exacta nunca cambian una vez publicados; todas las rutas se sirven desde blipit.io.

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

3El banner de actualización

Blipit ve con qué SDK y versión envió eventos cada proyecto en los últimos 7 días. Cuando sale una versión más nueva, la página del proyecto y la lista de proyectos muestran un banner como: Este proyecto usa @blipit/browser 0.3.7, 0.3.11 está disponible, con lo que cambió desde tu versión y el comando de actualización para tu stack (npm, pnpm, yarn, pip, composer, etc.) con un botón Copiar. La cruz lo oculta solo para esa versión; la siguiente versión lo vuelve a mostrar.

4Correos cuando importa

Las versiones marcadas como importantes o de seguridad envían un correo a los propietarios del espacio de trabajo, solo para proyectos que enviaron eventos desde una versión afectada en los últimos 14 días, y como máximo una vez por versión y proyecto. Las versiones normales solo muestran el banner. Para dejar de recibir estos correos, desactiva «Envíame un correo cuando una actualización del SDK corrija algo importante» en Ajustes, o usa el enlace al final del correo.

5El aviso en tu consola de desarrollo

En desarrollo, cada SDK imprime una línea por sesión o proceso cuando sale una versión más nueva. Lee la versión más reciente de una respuesta que el SDK ya recibe de Blipit, así que no añade ninguna petición, y nunca se muestra en producción ni a tus visitantes.

• Navegador y Next.js: en localhost, 127.0.0.1 y hosts .local, con debug: true, o cuando NODE_ENV es development. Llega con los ajustes de Reportar un error, así que con feedbackWidget: false no hay aviso.
• Node, Python, PHP, Ruby y Go: cuando el entorno es development o debug está activado.
• React Native: en compilaciones __DEV__.

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

6Comandos de actualización

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

pnpm add @blipit/browser@latest

yarn add @blipit/browser@latest

pip install -U blipit

composer update blipit/blipit

bundle update blipit

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

dotnet add package Blipit

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

Conviene saber

• pnpm 11 espera un día antes de instalar una versión nueva (minimum-release-age), así que el día del lanzamiento pnpm add instala sin avisar la versión anterior. Vuelve a intentarlo mañana, ejecuta pnpm add @blipit/browser@<version> --config.minimum-release-age=0, o añade @blipit/* a minimumReleaseAgeExclude en pnpm-workspace.yaml.
• Blipit aún no ve la versión instalada en .NET, Java, Android, Swift y Flutter, ni en Python, PHP, Ruby, Go y React Native anteriores a 0.2.1, así que esos proyectos no reciben banner ni correo. Actualiza a 0.2.1 o posterior para tenerlos.