از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
هر یک از آنها شامل مجموعه ای از 13 رنگ با مقادیر روشنایی مختلف تعریف شده همانطور که در R.color توضیح داده شده است، اما با مقادیر رنگ و رنگ تعریف نشده است که می تواند به صورت پویا توسط سیستم Android در زمان اجرا تولید شود.
سبک های تم برای رنگ پویا
با شروع اندروید 13، شش سبک تم مختلف با تغییراتی در الگوریتم رنگ پویا پشتیبانی می‌شوند که نیازهای توسعه‌دهنده و انتظارات تضاد را حفظ می‌کند. اینها برای تولید 65 رنگ پویا مورد استفاده برنامه ها فهرست شده اند:
TONAL_SPOT یک پالت با جنب و جوش متوسط است که از رنگ system_accent3_0 مشابه رنگ system_accent1_0 استفاده می کند (که از نسخه اندروید 12 منتقل شده و کمی تنظیم شده است).
VIBRANT یک پالت پر جنب و جوش است که به طور هماهنگ تغییر ظریف بین رنگ ها را ترکیب می کند.
EXPRESSIVE یک پالت پر جنب و جوش است که رنگ های غیرمنتظره و منحصر به فرد را با هم جفت می کند.
SPRITZ یک پالت کم ارتجاع است که شستشوی ملایمی را بین رنگ ها ایجاد می کند.
RAINBOW از لهجه‌های رنگی و سطوح خنثی برای ایجاد تجربه رنگی ظریف‌تر برای کاربران استفاده می‌کند.
این برای استفاده با استخراج رنگ مبتنی بر کاغذ دیواری توصیه نمی شود و در عوض باید با تم های رنگی ثابت استفاده شود.
FRUIT_SALADرنگ های دو رنگی را برای بیان بیشتر کاربران ارائه می دهد.
این برای استفاده با استخراج رنگ مبتنی بر کاغذ دیواری توصیه نمی شود و در عوض باید با تم های رنگی ثابت استفاده شود.
طرح زمینه سیستم با همان تنظیماتی که در Android 12 وجود داشت، تنظیم می‌شود که Settings.Secure.THEME_CUSTOMIZATION_OVERLAY_PACKAGES است. برای اندروید 13، تنها به یک کلید در JSON نیاز دارد که رنگ منبع را برای تولید 65 پالت رنگ ارسال می کند:
هر پالت تونال دارای 13 مقدار رنگ است که به شاخص های 0، 10، 50، 100، 200، 300، 400، 500، 600، 700، 800، 900 و 1000 ختم می شود.
API حاصل ترکیبی از نام پالت تونال است که به ایندکس ختم می شود. به عنوان مثال: R.color#system_accent1_10
پالت تونال پویا چگونه تولید می شود؟
یک پالت تونال پویا باید از یک رنگ منبع تولید شود که باید از کاغذ دیواری با استفاده از com.android.systemui.monet.ColorScheme#getSeedColors مشتق شده باشد، که چندین رنگ منبع معتبر را ارائه می دهد. اگر هیچ یک از رنگ های ارائه شده نیاز رنگ منبع را برآورده نمی کند، رنگ منبع تک باید از مقدار 0xFF1B6EF3 استفاده کند.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-08-24 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-24 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Dynamic color\n\nMaterial You design was launched with the Android 12\nrelease and expanded with Android 13.\n\nThis page focuses on updates to the Material You logic to help you integrate\nwith richer dynamic color support.\n\nDynamic color tonal palettes\n----------------------------\n\nStarting with Android 12, the following dynamic color\ntonal palettes are supported:\n\n- [`system_accent1_0`](https://developer.android.com/reference/android/R.color#system_accent1_0)\n- [`system_accent2_0`](https://developer.android.com/reference/android/R.color#system_accent2_0)\n- [`system_accent3_0`](https://developer.android.com/reference/android/R.color#system_accent3_0)\n- [`system_neutral1_0`](https://developer.android.com/reference/android/R.color#system_neutral1_0)\n- [`system_neutral2_0`](https://developer.android.com/reference/android/R.color#system_neutral2_0))\n\nEach of them comprise of a set of 13 colors with defined various luminance\nvalues as described at\n[`R.color`](https://developer.android.com/reference/android/R.color),\nbut with undefined hue and chroma values that can be dynamically generated by\nthe Android system at runtime.\n\nTheme styles for dynamic color\n------------------------------\n\nStarting with Android 13, six different theme styles\nare supported with variations on the dynamic color algorithm that maintain\ndeveloper needs and contrast expectations. These are listed for generating the\n65 dynamic color used by apps:\n\n- `TONAL_SPOT` is a mid-vibrancy palette that uses an `system_accent3_0` color analogous to the `system_accent1_0` color (carried over from the Android 12 release and slightly adjusted).\n- `VIBRANT` is a high-vibrancy palette that harmoniously blends subtle shift between colors.\n- `EXPRESSIVE` is a high-vibrancy palette that pairs unexpected and unique accents colors together.\n- `SPRITZ` is a low-vibrancy palette that creates a soft wash between colors.\n- `RAINBOW` uses both chromatic accents and neutral surfaces to create a more subtle color experience for users.\n - This is **NOT RECOMMENDED** to be used with wallpaper-based color extraction and should instead be used with static color themes.\n- `FRUIT_SALAD` provides *two tone colors* to give users more expression.\n - This is **NOT RECOMMENDED** to be used with wallpaper-based color extraction and should instead be used with static color themes.\n\nThe system theme is driven by the same setting as it was in Android 12,\nwhich is `Settings.Secure.THEME_CUSTOMIZATION_OVERLAY_PACKAGES`. For Android\n13, it requires only one key on its JSON that sends the\nsource color to generate the 65 color palettes: \n\n {\n \"android.theme.customization.system_palette\":\"746BC1\"\n }\n\nThe default theme style is `TONAL_SPOT`, but you can optionally specify one of\nthe other theme styles with an additional key with the JSON above: \n\n {\n \"android.theme.customization.system_palette\":\"746BC1\"\n \"android.theme.customization.theme_style\":\"EXPRESSIVE\"\n }\n\n| **Note:** You aren't required to expose ALL of the new theme styles in your UI, and can decide which to expose based on your user/brand needs. However, dynamic color palettes **MUST** be generated through one of these theme styles as CTS-tested by `SystemPaletteTest#testThemeStyles` and mandated by CDD.\n\nIntegrating dynamic color\n-------------------------\n\nFor guidelines on integrating dynamic color, see [Integrating Material You\nDesign](/docs/core/display/material).\n\nFrequently asked questions (FAQs)\n---------------------------------\n\n### What does the dynamic tonal palette API include?\n\n- There are five tonal palettes:\n\n - [`system_accent1`](https://developer.android.com/reference/android/R.color#system_accent1_0)\n - [`system_accent2`](https://developer.android.com/reference/android/R.color#system_accent2_0)\n - [`system_accent3`](https://developer.android.com/reference/android/R.color#system_accent3_0)\n - [`system_neutral1`](https://developer.android.com/reference/android/R.color#system_neutral1_0)\n - [`system_neutral2`](https://developer.android.com/reference/android/R.color#system_neutral2_0)\n- Each tonal palette has 13 color values ending in the indexes 0, 10, 50, 100,\n 200, 300, 400, 500, 600, 700, 800, 900, and 1000.\n\n- The resulting API is a combination of the tonal palette name, ending in the\n index. For example:\n [`R.color#system_accent1_10`](https://developer.android.com/reference/android/R.color#system_accent1_10)\n\n### How is a dynamic tonal pallet generated?\n\nA dynamic tonal palette must be generated from a single source color that should\nbe derived from wallpaper using\n`com.android.systemui.monet.ColorScheme#getSeedColors`, which provides multiple\nvalid source colors. If none of the provided colors meet the source color\nrequirement, the single source color should use the value `0xFF1B6EF3`."]]
