ما هي حقن الاعتماديات في Android (Hilt و Dagger)؟

Question

Accepted Answer

**حقن الاعتماديات (Dependency Injection — DI)** هي نمط معماري حيث تستقبل الكائنات اعتمادياتها من الخارج بدلاً من إنشاؤها بنفسها — مما يحسن قابلية الاختبار والصيانة والمرونة. في Android، **Hilt** (المبني على Dagger) هو إطار عمل DI الموصى به.

## ما هي حقن الاعتماديات ولماذا

```text
WITHOUT DI: a class CREATES its own dependencies (tightly coupled, hard to test/change):
  class UserRepo { val api = ApiService() }   // creates its own dependency — rigid
WITH DI: dependencies are PROVIDED from outside (injected):
  class UserRepo(val api: ApiService)          // receives it → flexible, testable
→ Benefits: TESTABILITY (inject mocks/fakes in tests), DECOUPLING, easier to swap
  implementations, centralized dependency management, less boilerplate (with a framework).
```

## Hilt — إطار عمل DI الموصى به في Android

```kotlin
// Hilt (built on Dagger) generates/manages dependency wiring for you
@HiltAndroidApp class MyApp : Application()      // set up Hilt

@AndroidEntryPoint class MainActivity : AppCompatActivity() {
  @Inject lateinit var repository: UserRepository  // Hilt INJECTS this automatically
}

// tell Hilt how to provide things
@Module @InstallIn(SingletonComponent::class)
object AppModule {
  @Provides fun provideApi(): ApiService = Retrofit.Builder()...create()
}
```

يتعامل Hilt مع إنشاء وتوفير الاعتماديات (مع الـ scoping والحياة الزمنية الصحيحة)، مما يقلل من الكود المتكرر للربط اليدوي.

## لماذا حقن الاعتماديات مهمة للمعمارية

```text
✓ TESTABILITY — inject test doubles (mocks/fakes) → unit-test in isolation (the big win)
✓ Works with architecture (MVVM): inject repositories into ViewModels, data sources into
  repositories → clean, decoupled, testable layers
✓ SCOPING — manage dependency lifecycles (singleton, per-activity, etc.)
✓ Less boilerplate than manual DI; standardized; Google-recommended (Hilt)
```

## لماذا يهمك ذلك

فهم حقن الاعتماديات معرفة مهمة على مستوى كبار المطورين لأنها **نمط أساسي للمعمارية الموثوقة والقابلة للصيانة في Android**، و Hilt هو الإطار الموصى به، لذلك فهو قيّم لتطوير Android عالي الجودة.

المفهوم الأساسي — أن الكائنات **تستقبل اعتمادياتها من الخارج** بدلاً من إنشاؤها بنفسها — يوفر فوائد كبيرة: الأهم هو **قابلية الاختبار** (يمكنك حقن النسخ المزيفة (mocks) أو الوهمية (fakes) في الاختبارات، مما يمكّن من الاختبارات الوحدية المعزولة — الفائدة الأساسية، حيث أن الفئات التي تنشئ اعتمادياتها بنفسها يصعب اختبارها)، بالإضافة إلى **فصل الارتباطات** (الفئات لا تعتمد على التطبيقات الملموسة)، والمرونة (سهولة التبديل بين التطبيقات)، والإدارة المركزية للاعتماديات.

فهم **Hilt** (إطار عمل DI الموصى به في Android، المبني على Dagger) — كيفية إنشاؤه وتوفيره وتحديد نطاق الاعتماديات تلقائياً، مما يقلل من كود الربط اليدوي — هو المعرفة العملية لتطبيق حقن الاعتماديات في Android الحديث.

فهم **لماذا تهم حقن الاعتماديات للمعمارية** هو البصيرة الأساسية: فهي تعمل جنباً إلى جنب مع أنماط مثل MVVM (حقن المستودعات في ViewModels، ومصادر البيانات في المستودعات) لإنشاء **طبقات نظيفة ومنفصلة وقابلة للاختبار** — مما يجعل حقن الاعتماديات ضرورية لبناء التطبيقات المعمارية بشكل جيد التي تستهدفها معمارية Android الموصى بها.

**تحديد النطاق الصحيح** (إدارة دورات حياة الاعتماديات) وتقليل الكود المتكرر (مقابل حقن الاعتماديات اليدوي) يجعل Hilt عملياً.

حقن الاعتماديات هي حجر الزاوية في معمارية Android المهنية لأنها تمكّن قابلية الاختبار والفصل اللذين تتطلبهما التطبيقات القابلة للصيانة.

بما أن حقن الاعتماديات نمط أساسي للمعمارية الموثوقة والقابلة للصيانة (حيث تكون فائدة قابلية الاختبار أساسية للتطوير الجيد في Android) و Hilt هو الإطار الموصى به الذي يجعله عملياً، ولأن فهم حقن الاعتماديات و Hilt مهم لبناء تطبيقات معمارية جيدة وقابلة للاختبار، فإن فهم حقن الاعتماديات في Android هو معرفة مهمة على مستوى كبار المطورين — حجر الزاوية في معمارية Android المهنية التي تمكّن قابلية الاختبار والفصل، وتعمل مع أنماط مثل MVVM لبناء تطبيقات قابلة للصيانة، وتعكس الارتقاء المعماري المتوقع لأدوار Android العليا.