> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerix.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Angular — التثبيت

> أضف Lerix إلى تطبيق Angular الخاص بك في خطوات قليلة.

## المتطلبات

* Angular 19+‎

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

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

```bash theme={"dark"}
npm install @lerix-dev/lerix-angular
```

## 2. سجّل الـ SDK

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

```ts app.config.ts theme={"dark"}
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,
    }),
  ],
};
```

<Note>
  ستجد مفتاح الـ API ومعرّف المشروع في [لوحة تحكم Lerix](https://app.lerix.dev) ضمن **إعدادات المشروع (Project Settings)**.
</Note>

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

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

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

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

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

```ts theme={"dark"}
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');
  }
}
```

ثم افتح [لوحة التحكم](https://app.lerix.dev) — يجب أن يظهر الخطأ خلال ثوانٍ.

<Check>
  كل شيء جاهز! تابع إلى [تتبع الأخطاء](/ar/frameworks/angular/error-tracking) لإرسال أخطاء مخصّصة وتفعيل الالتقاط التلقائي، أو إلى [الإشعارات](/ar/frameworks/angular/push-notifications) لتفعيل الإشعارات.
</Check>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.