إبقاء Blipit محدّثًا

1ما يتحدّث تلقائيًا

• وسم script من https://blipit.io/sdk/blipit.js: دائمًا أحدث إصدار.
• Odoo: تحمّل الوحدة أحدث SDK للمتصفح بعد مزامنتها التالية مع Blipit. وعند صدور إصدار جديد من 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تثبيت الإصدار الدقيق

لتحميل كل جزء من الإصدار الدقيق الذي ثبّتّه، مرّر sdkChannel: "exact" إلى init. استخدمه عندما تتطلب سياسة الأمان لديك Subresource Integrity: فبصمة السلامة لا تعمل إلا على مسار بإصدار دقيق مثل https://blipit.io/sdk/0.3.11/blipit-report.js، لأن مسار 0.3 يتغير مع كل إصدار. ملفات الإصدار الدقيق لا تتغير أبدًا بعد نشرها؛ وكل المسارات تُقدَّم من blipit.io.

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

3لافتة التحديث

يرى Blipit أي SDK وأي إصدار أرسل به كل مشروع أحداثه خلال آخر 7 أيام. وعند صدور إصدار أحدث تعرض صفحة المشروع وقائمة المشاريع لافتة مثل: يستخدم هذا المشروع @blipit/browser 0.3.7، والإصدار 0.3.11 متاح، مع ما تغيّر منذ إصدارك وأمر التحديث المناسب لبيئتك (npm وpnpm وyarn وpip وcomposer وغيرها) مع زر نسخ. علامة الإغلاق تخفيها لذلك الإصدار فقط؛ ويعيد الإصدار التالي إظهارها.

4رسائل بريد عندما يهم الأمر

الإصدارات المعلَّمة بأنها مهمة أو إصلاح أمني ترسل رسالة بريد واحدة إلى مالكي مساحة العمل، فقط للمشاريع التي أرسلت أحداثًا من إصدار متأثر خلال آخر 14 يومًا، ومرة واحدة على الأكثر لكل إصدار ومشروع. أما الإصدارات العادية فتعرض اللافتة فقط. لإيقاف هذه الرسائل، أوقف «راسلني عندما يصلح تحديث SDK أمرًا مهمًا» في الإعدادات، أو استخدم الرابط أسفل الرسالة.

5التنبيه في وحدة تحكم التطوير

أثناء التطوير، تطبع كل SDK سطرًا واحدًا لكل جلسة أو عملية عند صدور إصدار أحدث. وتقرأ أحدث إصدار من رد تتلقاه 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 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>

من المفيد معرفته

• ينتظر pnpm 11 يومًا قبل تثبيت إصدار جديد (minimum-release-age)، لذلك في يوم الإصدار يثبّت pnpm add الإصدار السابق دون أن يخبرك. حاول مجددًا غدًا، أو شغّل pnpm add @blipit/browser@<version> --config.minimum-release-age=0، أو أضف @blipit/* إلى minimumReleaseAgeExclude في pnpm-workspace.yaml.
• لا يرى Blipit بعدُ الإصدار المثبّت في .NET وJava وAndroid وSwift وFlutter، ولا في Python وPHP وRuby وGo وReact Native قبل 0.2.1، لذا لا تظهر لتلك المشاريع لافتة ولا رسالة. حدّث إلى 0.2.1 أو أحدث للحصول عليهما.