رموز تصميم OEM

الرموز المميزة لتصميم OEM هي تطبيق لنظام التشغيل Android Automotive OS (AAOS) لنظام التصميم متعدد الأبعاد . على عكس النهج الخوارزمي أو نهج اختيار المستخدم لقيم الرموز المميزة على الهاتف المحمول، تقوم الشركات المصنعة الأصلية بتعيين قيم الرموز المميزة للتصميم. تمثل رموز التصميم قرارات التصميم الصغيرة والمتكررة التي تشكل النمط المرئي لنظام التصميم وتستبدل القيم الثابتة بأسماء تشرح نفسها بنفسها. الرموز المميزة مماثلة لتلك التي يحددها نظام التصميم متعدد الأبعاد.

مكتبة رمز OEM

تتم الإشارة إلى الرموز المميزة لتصميم OEM من خلال مكتبة الرموز المميزة لـ OEM، والتي تتكون من المكونات الثلاثة الموضحة في الشكل 1.

الشكل 1. مكونات مكتبة الرموز المميزة لـ OEM.

مكتبة ثابتة

يسهل مكون المكتبة الثابتة لمكتبة الرمز المميز لـ OEM الوصول إلى قيم الرمز المميز على النحو التالي.

• يوفر واجهات برمجة التطبيقات للوصول إلى قيم OEM للرموز المميزة.
• لتمكين تجاوز الاشتراك في مراجع الرمز المميز في السمة مع قيم OEM.

مكتبة مشتركة

يكون مكون المكتبة المشتركة مسؤولاً عن تحديد ما يلي:

• اسم المكتبة.
• الاشتراك المنطقي لتمكين قيم رمز OEM المميز.
• النمط الذي يوفر قيم رمزية لـ OEM.

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

الشكل 2. تجاوز تطبيق المكتبة المشتركة.

مكتبة 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 المشتركة باستخدام تراكبات موارد وقت التشغيل (RROs). لمعرفة المزيد، راجع تغيير قيمة موارد التطبيق في وقت التشغيل .

لتعيين قيم الرمز المميز، راجع تحديد قيم الرمز المميز لـ OEM .

حدد قيم الرمز المميز لـ OEM

لتحديد قيم الرمز المميز، قم بتعيين السمة المقابلة في النمط 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، يجب على مصنعي المعدات الأصلية أولاً الاشتراك في تجاوز قيم الرمز المميز الافتراضية عن طريق تكوين قيمة enable_oem_tokens المنطقية لتكون true .

قيم رمز RRO

على غرار كيفية تعيين قيم الرمز المميز في OemStyle ، يمكن استخدام RROs لتعديل النمط لتوفير قيم رمزية بديلة.

<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>

يجب أن تقوم RROs بتعيين سمات المكتبة المشتركة على النمط عن طريق تحديد اسم المكتبة المشتركة.

تكوين التحميل الأخير

يجب على الأنظمة التي تتضمن تطبيق OEM لمكتبة الرمز المميز المشتركة تكوين النظام لتحميل المكتبة المشتركة بعد فئات التطبيق. للقيام بذلك، قم بتضمين اسم المكتبة ( com.android.oem.tokens ) في تكوين config_sharedLibrariesLoadedAfterApp على النظام. إذا كان لديك حق الوصول إلى خدمات Google للسيارات (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 المشتركة

نظرًا لأنه يلزم تثبيت المكتبات المشتركة في النظام مسبقًا على صور النظام، فيجب إما أن يتم شحن الأجهزة مع المكتبة أو يجب إضافة المكتبة كجزء من التحديث عبر الأثير (OTA) (لمعرفة المزيد، راجع تحديثات OTA ). ومع ذلك، فإن تضمين تنفيذ كعب الروتين لتجاوز OEM لمكتبة مشتركة لرمز OEM المميز على صورة النظام يسمح بدفع تحديث لتطبيق العمل الكامل إلى الأجهزة في وقت لاحق دون الحاجة إلى OTA.

مكتبة RROs المشتركة

على الرغم من عدم وجود متطلبات لتثبيت RROs كتطبيقات نظام، فإن القيام بذلك يوفر بعض سلوك التحديث الذي قد يكون مرغوبًا فيه.

• التحديثات التلقائية للتطبيقات عندما لا يقوم المستخدمون بتسجيل الدخول.
• لا يمكن للمستخدم إلغاء تثبيته (يمكن للمستخدمين فقط إزالة تثبيت التحديثات ).