Comece aqui

Manter o Blipit atualizado

O Odoo e a tag script simples se mantêm atualizados sozinhos. Tudo o que você instala por um gerenciador de pacotes fica na versão instalada, então o Blipit avisa quando sai uma mais nova: um banner no projeto em app.blipit.io, um e-mail quando uma versão é importante e uma linha no seu console de desenvolvimento. Cada aviso diz o que a nova versão corrige e o comando exato para atualizar.

1O que se atualiza sozinho

  • Tag script de https://blipit.io/sdk/blipit.js: sempre a versão mais recente.
  • Odoo: o módulo carrega o SDK de navegador mais recente após a próxima sincronização com o Blipit. Quando sai uma nova versão do blipit_monitor, os administradores veem uma barra de atualização no topo de cada tela do Odoo com os passos.
  • Desde o @blipit/browser 0.3.11, instalações via npm e tags script que indicam uma versão (https://blipit.io/sdk/0.3.11/blipit.js) carregam o relator, o botão Reportar erro, o formulário de feedback e o session replay de https://blipit.io/sdk/0.3/, que sempre tem o build 0.3 compatível mais recente. O núcleo instalado informa sua versão a cada parte; uma parte que não suporta esse núcleo se recusa a rodar e a versão exata é carregada no lugar, então nada quebra.
  • Todo o resto (o núcleo no seu bundle, @blipit/nextjs, @blipit/node, React Native, Python, PHP, Ruby, Go, Java, .NET, Swift, Flutter) só muda quando você atualiza o pacote.

2Fixar a versão exata

Para carregar cada parte da versão exata instalada, passe sdkChannel: "exact" para o init. Use isso quando sua política de segurança exigir Subresource Integrity: um hash de integridade só funciona em um caminho de versão exata como https://blipit.io/sdk/0.3.11/blipit-report.js, porque o caminho 0.3 muda a cada versão. Arquivos de versão exata nunca mudam depois de publicados; todos os caminhos são servidos por blipit.io.

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

3O banner de atualização

O Blipit vê com qual SDK e versão cada projeto enviou eventos nos últimos 7 dias. Quando sai uma versão mais nova, a página do projeto e a lista de projetos mostram um banner como: Este projeto usa @blipit/browser 0.3.7, 0.3.11 está disponível, com o que mudou desde a sua versão e o comando de atualização para o seu stack (npm, pnpm, yarn, pip, composer etc.) com um botão Copiar. O X o esconde só para aquela versão; a próxima versão o mostra de novo.

4E-mails quando importa

Versões marcadas como importantes ou correção de segurança enviam um e-mail aos proprietários do workspace, apenas para projetos que enviaram eventos de uma versão afetada nos últimos 14 dias, e no máximo uma vez por versão e projeto. Versões normais só mostram o banner. Para parar esses e-mails, desative "Me envie um e-mail quando uma atualização do SDK corrigir algo importante" em Configurações ou use o link no fim do e-mail.

5O aviso no seu console de desenvolvimento

Em desenvolvimento, cada SDK imprime uma linha por sessão ou processo quando sai uma versão mais nova. Ele lê a versão mais recente de uma resposta que o SDK já recebe do Blipit, então não adiciona nenhuma requisição, e nunca aparece em produção nem para seus visitantes.

  • Navegador e Next.js: em localhost, 127.0.0.1 e hosts .local, com debug: true, ou quando NODE_ENV é development. Ele vem com as configurações do Reportar erro, então com feedbackWidget: false não há aviso.
  • Node, Python, PHP, Ruby e Go: quando o ambiente é development ou o debug está ligado.
  • React Native: em builds __DEV__.
sh
[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 atualização

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
Tag script
<script src="https://blipit.io/sdk/0.3.11/blipit.js" defer></script>

Bom saber

  • O pnpm 11 espera um dia antes de instalar uma nova versão (minimum-release-age), então no dia do lançamento o pnpm add instala sem avisar a versão anterior. Tente de novo amanhã, rode pnpm add @blipit/browser@<version> --config.minimum-release-age=0 ou adicione @blipit/* ao minimumReleaseAgeExclude em pnpm-workspace.yaml.
  • O Blipit ainda não vê a versão instalada em .NET, Java, Android, Swift e Flutter, nem em Python, PHP, Ruby, Go e React Native antes da 0.2.1, então esses projetos não recebem banner nem e-mail. Atualize para 0.2.1 ou posterior para recebê-los.

Travou? Envie um e-mail para support@blipit.io. As chaves e o DSN exato de cada projeto ficam em Chaves de API no app.blipit.io.