مدیریت منابع میانای کاربر برنامه با «مدیر منابع»

«مدیر منابع» پنجره ابزاری برای وارد کردن، ایجاد، مدیریت، و استفاده از منابع در برنامه شما است. برای باز کردن پنجره ابزار، مشاهده > پنجره‌های ابزار > مدیر منابع را از منو انتخاب کنید یا مدیر منابع را در نوار کناری سمت راست انتخاب کنید.

پنجره ابزار «مدیر منابع» در Android Studio.
شکل ۱. پنجره ابزار «مدیر منابع».
  1. روی افزودن کلیک کنید تا منبع جدیدی به پروژه‌تان اضافه شود. می‌توانید دارایی‌های تصویری، دارایی‌های برداری، قلم‌ها، یا فایل‌ها و مقادیر منابع را اضافه کنید، یا می‌توانید ترسیم‌شدنی‌ها را به پروژه‌تان وارد کنید.
  2. برای مشاهده منابع مختص هر واحد، آن واحد را انتخاب کنید.
  3. بااستفاده از نوار جستجو، منبعی را در همه واحدهای پروژه خود جستجو کنید.
  4. منابعتان را براساس نوع در «مدیر منابع» نمایش دهید. از این برگه‌ها برای جابه‌جایی بین انواع منابع استفاده کنید. روی نماد سرریز دکمه منوِ گزینه‌های بیشتر کلیک کنید تا انواع منابع دیگر نشان داده شود.
  5. بااستفاده از دکمه فیلتر، منابع نمایش‌داده‌شده از ماژول‌های وابسته محلی، کتابخانه‌های خارجی، و چارچوب Android را فیلتر کنید. همچنین می‌توانید از فیلتر برای نشان دادن مشخصه‌های زمینه استفاده کنید.
  6. منابعتان را در بخش محتوای اصلی پیش‌دید کنید. روی منبعی کلیک راست کنید تا منوِ زمینه‌ای را ببینید که در آن می‌توانید نام منبع را تغییر دهید و در برنامه‌تان جستجو کنید تا ببینید منبع کجا استفاده شده است.
  7. روی این دکمه‌ها کلیک کنید تا منابعتان را به‌صورت کاشی یا فهرست مشاهده کنید.
  8. برای تغییر اندازه پیش‌نمایش منابع، روی این دکمه‌ها کلیک کنید.

علاوه‌بر این ویژگی‌ها، «مدیر منابع» روشی برای وارد کردن انبوه اشیای قابل‌رسم به پروژه‌تان ارائه می‌دهد. برای وارد کردن انبوه، می‌توانید:

  • فایل‌های تصویری‌تان (ازجمله فایل‌های SVG) را مستقیماً به «مدیر منابع» بکشید.
  • از جادوی وارد کردن Drawables استفاده کنید.

برای اطلاعات بیشتر، بخش وارد کردن موارد قابل‌رسم به پروژه را ببینید.

برای دیدن اطلاعات دقیق‌تر، روی منبعی در «مدیر منابع» دوکلیک کنید. اگر چند نسخه از یک منبع داشته باشید، این نمای تفصیلی هر نسخه را به‌همراه هرگونه توصیف‌گر مرتبط نمایش می‌دهد، همان‌طور که در شکل ۲ نشان داده شده است. از اینجا می‌توانید روی نسخه خاصی دوکلیک کنید تا آن را در پنجره ویرایشگر باز کنید.

«مدیر منبع» نسخه‌هایی از منبع ترسیم‌شدنی را برای تراکم‌های مختلف صفحه نشان می‌دهد.
شکل ۲. «مدیر منابع» نسخه‌هایی از منبع تصویر را برای تراکم‌های مختلف صفحه‌نمایش نشان می‌دهد.

وارد کردن ترسیم‌پذیرها به پروژه

می‌توانید از «مدیر منبع» برای وارد کردن منابع تصویر به پروژه‌تان استفاده کنید. برای دیدن فهرست انواع تصویر پشتیبانی‌شده، به پشتیبانی تصویر مراجعه کنید.

برای وارد کردن منابع تصویر به پروژه‌تان، کارهای زیر را انجام دهید:

  1. تصاویرتان را مستقیماً به پنجره مدیر منابع در Android Studio بکشید.

    • یا می‌توانید:
      1. روی نماد به‌علاوه (+) کلیک کنید.
      2. وارد کردن Drawables را انتخاب کنید، همان‌طور که در شکل ۳ نشان داده شده است.
      3. فایل‌ها و پوشه‌هایی را که می‌خواهید وارد کنید انتخاب کنید.
    «وارد کردن Drawables» را از منو افزودن «مدیر منابع» انتخاب کنید.
    شکل ۳. وارد کردن Drawables را از منو انتخاب کنید.
  2. کادر گفتگوی وارد کردن ترسیم‌شدنی‌ها ظاهر می‌شود، همان‌طور که در شکل ۴ نشان داده شده است. این کادر گفتگو فهرستی از منابعی را که وارد می‌کنید نمایش می‌دهد. با کلیک کردن روی چارگوش بالای پیش‌نمایش منبع، می‌توانید نام منبع را تغییر دهید.

    اگر چند نسخه از یک منبع ارائه می‌دهید، توصیف‌گرهای پیکربندی دستگاه را اضافه کنید (همان‌طور که در بخش زیر توضیح داده شده است) که پیکربندی خاصی را که هر منبع پشتیبانی می‌کند شرح می‌دهد.

    برای مثال، اگر چندین نسخه از یک منبع را برای تراکم‌های مختلف صفحه‌نمایش ارائه می‌دهید، می‌توانید برای هر نسخه یک توصیف‌گر تراکم اضافه کنید. توجه داشته باشید که اگر دو یا چند منبع نام و توصیف‌کننده یکسان داشته باشند، فقط یک نسخه وارد می‌شود.

    برای اطلاعات بیشتر درباره توصیف‌گرهای منبع، ارائه منابع جایگزین را ببینید.

    کادر گفتگوی «وارد کردن ترسیم‌شدنی‌ها» که نام‌های منبع و واجدشرایط‌ها را نشان می‌دهد.
    شکل ۴. کادر گفتگوی وارد کردن موارد قابل‌رسم.

    وقتی منابعتان را نام‌گذاری کردید و هرگونه توصیف‌کننده لازم را اضافه کردید، روی بعدی کلیک کنید.

  3. صفحه بعدی خلاصه‌ای از منابعی را که وارد می‌کنید نشان می‌دهد. وقتی آماده وارد کردن بودید، روی وارد کردن کلیک کنید.

در پنجره مدیر منابع، منابع شما اکنون برای استفاده در پروژه‌تان آماده هستند، همان‌طور که در شکل ۵ نشان داده شده است.

«مدیر منبع» منابع تصویر تازه‌واردشده را نمایش می‌دهد.
شکل ۵. اکنون «مدیر منابع» تصاویر واردشده را نشان می‌دهد.

تجزیه خودکار تراکم‌های قابل‌رسم

وقتی فایل یا پوشه‌ای را وارد می‌کنید و مسیر آن حاوی توصیف‌گر تراکم است، «مدیر منابع» به‌طور خودکار توصیف‌گر تراکم را به‌عنوان بخشی از وارد کردن اعمال می‌کند. «مدیر منابع» می‌تواند هم توصیف‌گرهای تراکم Android و هم ضریب‌های مقیاس iOS را تجزیه کند.

این جدول نحوه نمایش تراکم‌های پشتیبانی‌شده مختلف را برای Android و iOS فهرست می‌کند:

چگالی توصیف‌گر تراکم Android ضریب مقیاس iOS
تراکم پایین (~۱۲۰ نقطه در اینچ) ldpi پشتیبانی نمی‌شود
تراکم متوسط (~۱۶۰ نقطه در اینچ) mdpi مقیاس اصلی
تراکم بالا (~۲۴۰ نقطه در اینچ) hdpi پشتیبانی نمی‌شود
تراکم بسیار بالا (~۳۲۰ نقطه در اینچ) xhdpi @2x
تراکم فوق‌العاده بالا (~۴۸۰ نقطه در اینچ) xxhdpi @3x
تراکم فوق‌العاده فوق‌العاده فوق‌العاده بالا (~۶۴۰ نقطه در اینچ) 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 UI ارجاع دهید.

برای کسب اطلاعات درباره مدیریت پیشرفته منابع (ازجمله بار کردن پویای قلم، منابع ویژه پیکربندی، و کتابخانه‌های منابع ویژه Compose) به سند مربوط به منابع در Compose مراجعه کنید.

منابع بیشتر

محتوا را مشاهده می‌کند