Angular — التثبيت

المتطلبات

Angular 19+‎

هذه مكتبة Angular مخصّصة — خدمة LerixService قابلة للحقن (injectable)، ودالة provideLerix() لملف app.config.ts الخاص بك، وتكامل مع ErrorHandler الخاص بـ Angular — مبنية فوق @lerix-dev/lerix-core، المحرّك المستقل عن أي إطار عمل والمشترك بين كل حزم Lerix للويب. تبني تطبيق React بدلاً من ذلك؟ راجع حزمة React. إذا كنت لا تستخدم Angular ولا React، تعمل @lerix-dev/lerix-core مباشرة أيضاً.

1. أضف الاعتمادية (Dependency)

npm install @lerix-dev/lerix-angular

2. سجّل الـ SDK

أضف provideLerix() إلى ملف app.config.ts الخاص بك:

app.config.ts

import { ApplicationConfig } from '@angular/core';
import { provideLerix } from '@lerix-dev/lerix-angular';

export const appConfig: ApplicationConfig = {
  providers: [
    provideLerix({
      apiKey: 'your-api-key',
      projectId: 'your-project-id',
      debugMode: true,
    }),
  ],
};

ستجد مفتاح الـ API ومعرّف المشروع في لوحة تحكم Lerix ضمن إعدادات المشروع (Project Settings).

يعمل التسجيل مع الخادم (backend)، ومعالج الأعطال التلقائي، عند الإقلاع (bootstrap) — قبل أن يصبح تطبيقك تفاعلياً. لا حاجة لاستدعاء init() منفصل.

المعاملات (Parameters)

المعامل	النوع	مطلوب	الوصف
`apiKey`	`string`	نعم	مفتاح API الخاص بمشروعك من لوحة التحكم
`projectId`	`string`	نعم	معرّف مشروعك (slug) من لوحة التحكم
`url`	`string`	لا	رابط الخادم الأساسي. الافتراضي هو `https://api.lerix.dev/v1` — غيّره فقط إذا كنت تستضيف الخادم بنفسك
`release`	`string`	لا	الإصدار الذي يُنشر به هذا البناء (مثل `1.4.0` أو معرّف commit). مرّر القيمة نفسها عند رفع خرائط المصدر لتظهر تتبّعات الإنتاج بملفاتك الأصلية: راجع خرائط المصدر
`debugMode`	`boolean`	لا	طباعة سجلّات طلبات/استجابات الـ SDK في الـ console (الافتراضي: `false`)
`enableCrashReporting`	`boolean`	لا	تثبيت معالج الأخطاء التلقائي (الافتراضي: `true`) — راجع تتبع الأخطاء
`onError`	`(error: unknown) => void`	لا	يُستدعى إذا فشلت التهيئة نفسها (مثلاً تعذّر الوصول للشبكة)

3. تحقّق من التكامل

احقن LerixService وأرسل خطأً تجريبياً للتأكّد من أن كل شيء يعمل:

import { Component, inject } from '@angular/core';
import { LerixService } from '@lerix-dev/lerix-angular';

@Component({ ... })
export class MyComponent {
  private readonly lerix = inject(LerixService);

  test() {
    this.lerix.throwError('Test error');
  }
}

ثم افتح لوحة التحكم — يجب أن يظهر الخطأ خلال ثوانٍ.

كل شيء جاهز! تابع إلى تتبع الأخطاء لإرسال أخطاء مخصّصة وتفعيل الالتقاط التلقائي، أو إلى الإشعارات لتفعيل الإشعارات.

البدء

أطر العمل

الوحدات

المطورون

Angular — التثبيت

المتطلبات

1. أضف الاعتمادية (Dependency)

2. سجّل الـ SDK

المعاملات (Parameters)

3. تحقّق من التكامل

​المتطلبات

​1. أضف الاعتمادية (Dependency)

​2. سجّل الـ SDK

​المعاملات (Parameters)

​3. تحقّق من التكامل

المتطلبات

1. أضف الاعتمادية (Dependency)

2. سجّل الـ SDK

المعاملات (Parameters)

3. تحقّق من التكامل