توکن های طراحی OEM

توکن‌های طراحی OEM یک پیاده‌سازی سیستم‌عامل Android Automotive (AAOS) از سیستم طراحی مواد هستند. بر خلاف رویکرد الگوریتمی یا انتخاب کاربر برای مقادیر توکن در تلفن همراه، OEM ها مقادیر توکن طراحی را تعیین می کنند. نشانه‌های طراحی، تصمیم‌های کوچک و مکرر طراحی را نشان می‌دهند که سبک بصری یک سیستم طراحی را تشکیل می‌دهند و مقادیر ثابت را با نام‌های خود توضیحی جایگزین می‌کنند. توکن ها مشابه آنهایی هستند که توسط سیستم طراحی مواد تعریف شده اند.

کتابخانه توکن OEM

نشانه‌های طراحی OEM از طریق کتابخانه نشانه‌های OEM، که شامل سه جزء نشان‌داده‌شده در شکل 1 است، ارجاع می‌شوند.

شکل 1. اجزای کتابخانه توکن OEM.

کتابخانه ایستا

جزء کتابخانه ایستا کتابخانه توکن OEM دسترسی به مقادیر توکن را به شرح زیر تسهیل می کند.

• API ها را برای دسترسی به مقادیر OEM برای توکن ها فراهم می کند.
• نادیده گرفتن ارجاعات نشانه در طرح زمینه با مقادیر OEM را فعال می کند.

کتابخانه مشترک

مؤلفه کتابخانه مشترک مسئول تعریف موارد زیر است:

• نام کتابخانه
• انتخاب بولی برای فعال کردن مقادیر توکن OEM.
• سبکی که مقادیر توکن OEM را ارائه می کند.

برای تطبیق مالکیت OEM از این مؤلفه کتابخانه مشترک، از جمله نام بسته تعریف شده توسط OEM، OEM ها می توانند یک لغو اجرای کتابخانه مشترک ایجاد کنند.

شکل 2. اجرای یک کتابخانه مشترک را لغو کنید.

کتابخانه مشترک OEM

نادیده گرفتن OEM مؤلفه کتابخانه اشتراکی به مالکیت OEM کتابخانه اجازه می دهد و در عین حال سازگاری با سایر مؤلفه های موجود در کتابخانه نشانه های OEM را با فراهم کردن وسیله ای برای تنظیم نام بسته و امضا توسط OEM ها در حالی که اجرای کتابخانه مشترک را تغییر نمی دهد، می دهد.

لغو برای یک کتابخانه مشترک می تواند به صورت زیر تعریف شود:

override_android_app {
    name: "[OEM]-token-shared-lib",
    base: "token-shared-lib",
    package_name: "com.[OEM].sharedlib",
    rename_resources_package: false,
    certificate: …
}

برای تنظیم مقادیر نشانه، به تعیین مقادیر توکن OEM مراجعه کنید.

مهم: کتابخانه های مشترک باید روی یک تصویر سیستم از قبل نصب شده باشند.

سفارشی سازی های کتابخانه مشترک OEM

برای پشتیبانی از طرح‌های متنوع برای مقادیر نشانه (به عنوان مثال، تمایز مدل یا حالت درایو)، OEMها می‌توانند مقادیر پویا را برای توکن‌ها با هدف قرار دادن کتابخانه مشترک OEM با Runtime Resource Overlays (RROs) فراهم کنند. برای کسب اطلاعات بیشتر، به تغییر مقدار منابع برنامه در زمان اجرا مراجعه کنید.

برای تنظیم مقادیر نشانه، به تعیین مقادیر توکن OEM مراجعه کنید.

مقادیر توکن OEM را مشخص کنید

برای تعیین مقادیر توکن، ویژگی مربوطه را در style OemStyle روی مقدار مورد نیاز تنظیم کنید.

<resources>
    <style name="OemStyle">
        <item name="colorPrimary">#B0C5FF</item>
        <item name="colorOnPrimary">#002B76</item>
        <item name="colorPrimaryContainer">#003FA4</item>
        <item name="colorOnPrimaryContainer">#D9E2FF</item>
        …
    </style>
</resources>

در مقادیر OEM شرکت کنید

برای اینکه برنامه‌ها بتوانند به مقادیر توکن ارائه‌شده توسط OEM دسترسی داشته باشند، OEM‌ها ابتدا باید با پیکربندی true enable_oem_tokens ، مقادیر توکن پیش‌فرض را لغو کنند.

مقادیر رمز RRO

مشابه نحوه تنظیم مقادیر توکن در OemStyle ، از RROها می توان برای تغییر سبک برای ارائه مقادیر توکن جایگزین استفاده کرد.

<resources>
    <style name="OemStyle">
        <item name="com.android.oem.tokens:colorPrimary">#B0C5FF</item>
        <item name="com.android.oem.tokens:colorOnPrimary">#002B76</item>
        <item name="com.android.oem.tokens:colorPrimaryContainer">#003FA4</item>
        <item name="com.android.oem.tokens:colorOnPrimaryContainer">#D9E2FF</item>
        …
    </style>
</resources>

RROها باید ویژگی‌های کتابخانه مشترک را با تعیین نام کتابخانه مشترک روی سبک تنظیم کنند.

آخرین بار را پیکربندی کنید

سیستم‌هایی که شامل پیاده‌سازی OEM از یک کتابخانه مشترک توکن هستند، باید سیستم را برای بارگیری کتابخانه مشترک پس از کلاس‌های برنامه پیکربندی کنند. برای انجام این کار، نام کتابخانه ( com.android.oem.tokens ) را در پیکربندی config_sharedLibrariesLoadedAfterApp در سیستم وارد کنید. اگر به Google Automotive Services (GAS) دسترسی دارید، این به عنوان یک الزام اعمال می شود.

<!-- The OEM token shared library will be loaded after app classes -->
<string-array name="config_sharedLibrariesLoadedAfterApp" translatable="false">
    <item>com.android.oem.tokens</item>
</string-array>

بهترین شیوه ها

بهترین شیوه ها برای کتابخانه نشانه های OEM در زیر توضیح داده شده است.

یک استراتژی به‌روزرسانی انعطاف‌پذیر را فعال کنید

برای اطمینان از ایجاد انعطاف پذیری در رابطه با به روز رسانی، استراتژی های زیر را ببینید.

کتابخانه مشترک OEM

از آنجایی که کتابخانه‌های مشترک سیستم باید روی تصاویر سیستم از قبل نصب شوند، دستگاه‌ها باید یا با کتابخانه ارسال شوند یا کتابخانه باید به عنوان بخشی از به‌روزرسانی Over-the-Air (OTA) اضافه شود (برای اطلاعات بیشتر، به‌روزرسانی‌های OTA را ببینید). با این حال، شامل اجرای خرد از یک OEM نادیده گرفته شده از کتابخانه مشترک توکن OEM بر روی یک تصویر سیستم، امکان به‌روزرسانی یک پیاده‌سازی کامل کاری را فراهم می‌کند تا در تاریخ بعد بدون نیاز به OTA به دستگاه‌ها ارسال شود.

RROهای کتابخانه مشترک

اگرچه هیچ الزامی برای نصب RROها به عنوان برنامه های سیستمی وجود ندارد، انجام این کار برخی رفتارهای به روز رسانی را ارائه می دهد که ممکن است مورد نظر باشد.

• به‌روزرسانی خودکار برنامه‌ها زمانی که کاربران وارد سیستم نشده‌اند.
• کاربر نمی تواند آن را حذف نصب کند (کاربران فقط می توانند به روز رسانی ها را حذف نصب کنند ).