إدارة موارد واجهة المستخدم لتطبيقك من خلال مدير الموارد

"مدير الموارد" هو نافذة أدوات لاستيراد الموارد وإنشائها وإدارتها واستخدامها في تطبيقك. لفتح نافذة الأدوات، اختَر عرض > نوافذ الأدوات > مدير الموارد من القائمة أو اختَر مدير الموارد في الشريط الجانبي الأيمن.

نافذة أداة "إدارة الموارد" في "استوديو Android"
الشكل 1. نافذة أداة "إدارة الموارد"
  1. انقر على إضافة لإضافة مرجع جديد إلى مشروعك. يمكنك إضافة مواد عرض صور أو مواد عرض متّجهة أو خطوط أو ملفات موارد وقيم، أو يمكنك استيراد عناصر قابلة للرسم إلى مشروعك.
  2. اختَر وحدة للاطّلاع على المراجع الخاصة بها.
  3. ابحث عن مورد في جميع الوحدات في مشروعك باستخدام شريط البحث.
  4. يمكنك عرض الموارد حسب النوع في "مدير الموارد". استخدِم علامات التبويب هذه للتبديل بين أنواع المراجع. انقر على رمز الخيارات الإضافية زر قائمة "خيارات إضافية" لعرض أنواع الموارد الإضافية.
  5. يمكنك فلترة الموارد المعروضة من الوحدات التابعة المحلية والمكتبات الخارجية وإطار عمل Android باستخدام زر الفلترة. يمكنك أيضًا استخدام الفلتر لعرض سمات المظهر.
  6. يمكنك معاينة المراجع في منطقة المحتوى الرئيسية. انقر بزر الماوس الأيمن على أحد الموارد للاطّلاع على قائمة سياق يمكنك من خلالها إعادة تسمية المورد والبحث في تطبيقك عن مكان استخدام المورد.
  7. انقر على هذين الزرَّين لعرض المراجع إما كمربّعات أو قوائم.
  8. انقر على هذين الزرَّين لتغيير حجم معاينة المراجع.

بالإضافة إلى هذه الميزات، يوفّر "مدير الموارد" طريقة لاستيراد العناصر القابلة للرسم بشكل مجمّع إلى مشروعك. للاستيراد بشكل مجمّع، يمكنك تنفيذ أحد الإجراءَين التاليَين:

  • اسحب ملفات الصور، بما في ذلك ملفات SVG، مباشرة إلى Resource Manager.
  • استخدِم معالج استيراد العناصر القابلة للرسم.

لمزيد من المعلومات، يُرجى الاطّلاع على قسم استيراد العناصر القابلة للرسم إلى مشروعك.

للاطّلاع على معلومات أكثر تفصيلاً، انقر مرّتين على أحد الموارد في "إدارة الموارد". إذا كانت لديك إصدارات متعددة من مورد، فإن طريقة العرض التفصيلية هذه تعرض كل إصدار مع أي محددات مرتبطة به، كما هو موضح في الشكل 2. من هنا، يمكنك النقر نقرًا مزدوجًا فوق إصدار معين لفتحه في نافذة المحرر.

"مدير الموارد" يعرض نُسخًا من مورد قابل للرسم لكثافات شاشة مختلفة.
الشكل 2. "مدير الموارد" يعرض نُسخًا من مورد صورة لكثافات شاشة مختلفة.

استيراد العناصر القابلة للرسم إلى مشروعك

يمكنك استخدام Resource Manager لاستيراد موارد الصور إلى مشروعك. للحصول على قائمة بأنواع الصور المتوافقة، يُرجى الاطّلاع على توافق الصور.

لاستيراد موارد الصور إلى مشروعك، اتّبِع الخطوات التالية:

  1. اسحب صورك مباشرةً إلى نافذة Resource Manager في Android Studio.

    • بدلاً من ذلك، يمكنك:
      1. انقر على رمز علامة الجمع (+).
      2. اختَر استيراد العناصر القابلة للرسم (Import Drawables)، كما هو موضّح في الشكل 3.
      3. اختَر الملفات والمجلدات التي تريد استيرادها.
    اختَر "استيراد العناصر القابلة للرسم" (Import Drawables) من قائمة الإضافة في "إدارة الموارد" (Resource Manager).
    الشكل 3: اختَر استيراد العناصر القابلة للرسم (Import Drawables) من القائمة.
  2. يظهر مربّع الحوار استيراد العناصر القابلة للرسم (Import drawables)، كما هو موضّح في الشكل 4. يعرض مربّع الحوار هذا قائمة بالموارد التي يتم استيرادها. يمكنك إعادة تسمية المراجع بالنقر على المربّع فوق معاينة المرجع.

    إذا كنت تقدّم إصدارات متعددة من المورد نفسه، أضِف مؤهلات إعداد الجهاز، كما هو موضّح في القسم التالي، والتي تصف الإعدادات المحدّدة التي يتيحها كل مورد.

    على سبيل المثال، إذا كنت تقدّم نُسخًا متعددة من المورد نفسه لكثافات شاشة مختلفة، يمكنك إضافة معرّف الكثافة لكل نسخة. يُرجى العِلم أنّه إذا كان هناك موردان أو أكثر يحملان الاسم نفسه والمحدّدات نفسها، يتم استيراد نسخة واحدة فقط.

    لمزيد من المعلومات حول مؤهِّلات الموارد، يُرجى الاطّلاع على توفير موارد بديلة.

    مربّع الحوار "استيراد العناصر القابلة للرسم" (Import drawables) الذي يعرض أسماء الموارد والمحدّدات
    الشكل 4. مربّع حوار استيراد العناصر القابلة للرسم

    بعد تسمية الموارد وإضافة أي مؤهلات ضرورية، انقر على التالي.

  3. تعرض الشاشة التالية ملخّصًا للمراجع التي تستوردها. عندما تكون مستعدًا للاستيراد، انقر على استيراد.

في نافذة Resource Manager، أصبحت الموارد جاهزة للاستخدام في مشروعك، كما هو موضّح في الشكل 5.

صورة تعرض "إدارة الموارد" مع موارد الصور التي تم استيرادها حديثًا
الشكل 5. يعرض Resource Manager الآن الصور التي تم استيرادها.

تحليل كثافات العناصر القابلة للرسم تلقائيًا

عند استيراد ملف أو مجلد يحتوي مساره على معرّف كثافة، يطبّق "مدير الموارد" معرّف الكثافة تلقائيًا كجزء من عملية الاستيراد. يمكن لـ "مدير الموارد" تحليل كل من معرّفات الكثافة في Android وعوامل القياس في iOS.

يسرد هذا الجدول كيفية تمثيل الكثافات المختلفة المتوافقة لنظامَي التشغيل Android وiOS:

الكثافة معرّف الكثافة في Android عامل قياس iOS
كثافة منخفضة (120 نقطة لكل بوصة تقريبًا) ldpi غير متوافق
كثافة متوسطة (160 نقطة لكل بوصة تقريبًا) mdpi المقياس الأصلي
كثافة عالية (حوالي 240 نقطة في البوصة) hdpi غير متوافق
كثافة عالية جدًا (320 نقطة لكل بوصة تقريبًا) xhdpi @2x
كثافة عالية جدًا جدًا (480 نقطة لكل بوصة تقريبًا) xxhdpi @3x
كثافة عالية جدًا جدًا جدًا (640 نقطة لكل بوصة تقريبًا) xxxhdpi ‎@4x

في ما يلي بعض الأمثلة على كيفية ترجمة مسارات الإدخال إلى مسارات الموارد بعد الاستيراد:

معرّف الكثافة في Android:‏ hdpi
مسار الإدخال: /UserFolder/icon1/hdpi/icon.png
مسار المورد: <projectFolder>/<moduleFolder> /src/main/res/drawable-hdpi/icon.png
معرّف الكثافة في Android:‏ xxhdpi
مسار الإدخال: /UserFolder/icon1/abc-xxhdpi/icon.png
مسار المورد: <projectFolder>/<moduleFolder> /src/main/res/drawable-xxhdpi/icon.png
عامل قياس iOS:‏ @2x
مسار الإدخال: /UserFolder/icon1/icon@2x.png
مسار المورد: <projectFolder>/<moduleFolder> /src/main/res/drawable-xhdpi/icon.png
عامل قياس iOS:‏ @2x
مسار الإدخال: /UserFolder/icon1/icon@2x_alternate.png
مسار المورد: <projectFolder>/<moduleFolder> /src/main/res/drawable-xhdpi/icon_alternate.png

لمزيد من المعلومات حول الأجهزة المتوافقة ذات كثافات وحدات البكسل المختلفة، يُرجى الاطّلاع على التوافق مع كثافات وحدات البكسل المختلفة.

استخدام الموارد في Jetpack Compose

عند إنشاء التطبيقات باستخدام Jetpack Compose، يمكنك الوصول إلى الموارد مباشرةً من رمز Kotlin باستخدام واجهات برمجة تطبيقات محسّنة، ما يضمن بقاء منطق واجهة المستخدم ومراجع الموارد متزامنة.

  • الصور: استخدِم painterResource(id = R.drawable.your_image) ضمن دالة مركّبة Image.
  • السلاسل: استخدِم stringResource(id = R.string.your_string) لاسترداد نص واجهة المستخدم المترجَم.
  • الألوان: استخدِم colorResource(id = R.color.your_color) لتطبيق الألوان المحدّدة في المظهر.

يضمن Resource Manager إنشاء هذه المعرّفات بشكل صحيح، ما يتيح لك الإشارة بسلاسة إلى مواد العرض من التسلسل الهرمي لواجهة مستخدم Compose.

للحصول على معلومات حول التعامل المتقدّم مع الموارد، بما في ذلك تحميل الخطوط الديناميكية والموارد الخاصة بالإعدادات ومكتبات الموارد الخاصة بـ Compose، يُرجى الاطّلاع على المستندات حول الموارد في Compose.

مراجع إضافية

محتوى المشاهدات