عرض بنية رمز الأمان

توضّح هذه الصفحة كيفية تنظيم رمز مصدر Display Safety.

لمزيد من المعلومات، راجِع ملف README.md في كل دليل.

إنشاء نسخة طبق الأصل من المستودع

للحصول على إذن الوصول إلى المستودع، يُرجى التواصل مع المدير الفني لحسابك على Google.

Framework

يحتوي هذا الدليل على المكوّنات الأساسية لإطار عمل "أمان الشاشة".

الدليل	الغرض
api/har-platform-api	مجموعة من تجريدات الأنظمة الفرعية للمنصات لإنشاء تطبيقات HAR عالية التوفّر على المنصات المتوافقة
api/har-types	أنواع طبقة تجريد الأجهزة
asset-manager	أدوات لإدارة مواد عرض التطبيق في وقت التشغيل
audio/har-audio	Crate للتعامل مع تشغيل الصوت بتنسيق HAR
customizations	يحتوي على واجهات برمجة التطبيقات وعمليات التنفيذ ووحدات الماكرو المشتقة لإنتاج تخصيصات التصميم من تطبيق يستند إلى HAR.
derive/har-ui-model-derive	وحدات ماكرو إجرائية لاشتقاق السمات الشائعة التي يستخدمها نظام نموذج واجهة مستخدم HAR
display_list	تحدّد هذه السمة البِنى والمكوّنات التي تصف مشهدًا للعرض، وهي منفصلة عن أي نظام خلفي رسومي.
graphics/external-image	حزمة لتمثيلات الصور الخارجية
graphics/har-gl-context	تحدّد واجهة برمجة التطبيقات لسياق الرسومات وتتضمّن عمليات تنفيذ متعددة على جميع المنصات المتوافقة، سواء للعرض أو للتقديم خارج الشاشة.
graphics/impeller	واجهة برمجة تطبيقات Safe Rust لـ Impeller، تستند إلى روابط FFI التي تم إنشاؤها.
graphics/impeller-renderer	تنفيذ أداة العرض عالية المستوى باستخدام Impeller كمحرك عرض أساسي
har-layout	برنامج تضمين Taffy لاحتساب تنسيق العرض في HAR
har-monitoring	مجموعة أدوات رصد الأداء
har-utils	برامج الخدمات الشائعة
harry	إطار عمل يُستخدَم كأساس لإنشاء تطبيقات HAR
harry-animation	واجهة برمجة تطبيقات وتنفيذ للصور المتحركة الخاصة بـ "هاري"
squoosh	تمثّل هذه السمة محرك العرض والرسوم المتحركة الوسيطة لمعلمات العرض في إطار عمل Harry.
task-scheduler	أداة مساعدة لجدولة المهام وتنفيذها في سلسلة محادثات في الخلفية بعد مهلة محدّدة.
test_suites	مجموعات الاختبارات لتنفيذ اختبارات الوحدة الخاصة بميزة "أمان العرض"

Prebuilts

يحتوي هذا الدليل على مكتبات ومواد عرض مُنشأة مسبقًا.

الدليل	الغرض
impeller/	مكتبات مُعدّة مسبقًا لمحرك الرسومات Impeller، منظَّمة حسب نظام التشغيل وبنية النظام
impeller-rs-bindgen/	عمليات ربط Rust FFI لـ Impeller
impeller-rs-bindgen-wrapper/	برنامج تضمين لواجهة برمجة التطبيقات لعمليات الربط في Impeller

مراجع

يحتوي هذا الدليل على التنفيذ المرجعي لتنسيق HAR وعمليات التنفيذ الخاصة بالمنصات والأدوات وعناصر الاختبار.

الدليل	الغرض
audio/tinyalsa-rs	Rust FFI bindings for the Tinyalsa Audio library.
audio/tinyalsa-audio	مكتبة لتشغيل الصوت وإدارة الأجهزة، تستند إلى روابط FFI التي تم إنشاؤها بواسطة حزمة `tinyalsa-rs`
camera/emulated-camera	توفّر هذه السمة عملية تنفيذ لكاميرا محاكية باستخدام السمة `Camera` من `har-platform-api`.
graphics/gl-helpers	حزمة أدوات تحتوي على دوال مساعِدة لـ GL
har-user-input-evdev/	تنفِّذ هذه السمة عملية أساسية للتعامل مع الإدخال استنادًا إلى evdev. وتتيح أحداث لوحة المفاتيح والماوس واللمس (اللمس الفردي واللمس المتعدد)
harry-app/	تنفيذ مرجعي لتطبيق عارض محمول عالي التوفّر (HAR) تم إنشاؤه باستخدام إطار عمل `harry`.
harry-app-core/	منطق التطبيق الأساسي وإدارة الحالة وتعريفات نموذج واجهة المستخدم للتطبيق المرجعي `harry-app`.
harry-app-utils/	دوال مساعدة ووحدات مساعدة لتطبيق `harry-app` المرجعي
harry-control-api/	عناصر التحكّم في واجهات برمجة التطبيقات لتطبيق `harry-app` المرجعي
harry-grpcio-server/	خادم gRPC (استنادًا إلى grpcio) يتم استخدام هذا الخيار فقط عند إنشاء إصدار Android باستخدام Soong
harry-tonic-server/	خادم gRPC (مستند إلى Tonic)، ويتم استخدامه فقط عند إنشاء إصدار Linux باستخدام Cargo.
harry-vehicle-data-grpc/	رمز gRPC لبيانات المركبة، تم إنشاؤه من ملفات proto لبيانات المركبة
i18n/harry-app-i18n	خدمات التدويل والأقلمة لملفات HAR
i18n/i18n-protos	تحدّد هذه السمة رسائل protobuf وإنشاء رموز Rust لبيانات تدويل التطبيقات.
libyuv-rs/	أربطة Rust لـ libyuv
platforms/har-log	تحدّد هذه السمة عمليات تنفيذ التسجيل والتتبُّع لكل نظام أساسي متوافق.
platforms/har-looper-headless	تنفيذ مشّغل رسائل مستقل عن النظام الأساسي لعرض المحتوى بلا واجهة مستخدم رسومية
platforms/har-platform-android	توفّر هذه الحزمة عمليات تنفيذ خاصة بنظام التشغيل Android لعمليات تجريد المنصات في `har-platform-api`.
platforms/har-platform-linux	توفّر هذه الحزمة عمليات تنفيذ خاصة بنظام التشغيل Linux لعمليات تجريد المنصات في حزمة `har-platform-api`.
platforms/harry-app-platform-specific	جسر التجميع الشرطي لتطبيق harry-app، والذي يختار التنفيذ الصحيح استنادًا إلى النظام الأساسي المحدّد.
safety-monitor	تنفيذ "أداة مراقبة السلامة المرجعية" على Android
screencap	أداة تصوير الشاشة لاستخراج لقطات الشاشة مباشرةً من مخازن إطارات DRM
vehicle-data-scripts	البُنى والمنطق لإنشاء تسلسلات بيانات مركبة مكتوبة

الخدمة

يحتوي هذا الدليل على خدمات Android ذات الصلة بميزة "أمان الشاشة".

الدليل	الغرض
ds-cvd-toolkit	أداة سطر أوامر لخدمة "أمان الشاشة" تتيح تشغيل أجهزة Cuttlefish متعددة.
emulator	توافُق المحاكي مع ميزة "تراكب الموارد في وقت التشغيل"
har-grpc-services	يحتوي على تعريفات البروتوكول المستخدَمة في التنفيذ المرجعي لإنشاء قنوات اتصال بين تطبيق HAR وDriverUI وخدمات بيانات المركبة.
har-sdv-service*	توفّر حزمة خدمات SDV مستخدَمة لتقديم خدمات البيانات إلى HAR باستخدام الرمز الذي تم إنشاؤه بواسطة ملفات proto
har-tracing-common	خدمات تتبُّع الأداء لملفات HAR
harry-prebuilt/	مكوّنات Harry المُنشأة مسبقًا (مواد العرض والإعدادات وما إلى ذلك)
ivi/	المكوّنات ذات الصلة بنظام المعلومات والترفيه داخل المركبة (IVI) من Android
libhar_graphics/	مكتبة رسومات C++ لخدمات HAR
pdk/	البيانات الوصفية لإصدار حزمة تطوير البرامج (PDK)
product/	الإعدادات ومواد العرض الخاصة بالمنتج
SdvCameraPreviewApp	تطبيق لمعاينة الكاميرا في المركبات المزوّدة ببرامج محدّدة
vehicledata	تنفيذ ناشر "نفق بيانات" SDV لبيانات المركبة باستخدام gRPC

Utils

يحتوي هذا الدليل على أدوات عامة لتنفيذ المراجع واختبارها.

الدليل	الغرض
asset-manager-cli	توفّر واجهة سطر أوامر لإنشاء حِزم مواد عرض.
dcf-info/	أداة لاستخراج البيانات الوصفية من ملف DCF (مستند بتنسيق Serialized Design Compose Figma)
figma-utils	توفّر هذه الأداة برنامج تضمين لسطر الأوامر في `figma_import`، وذلك لجلب مستندات Figma المسلسلة.
gauge-test	تطبيق مصمّم لاختبار عناصر واجهة المستخدم الخاصة بالمؤشرات وعرضها.
gui-playground-app	بيئة وضع الحماية لاختبار ميزات جديدة في واجهة المستخدم والرسوم المتحركة
har-platform-tests	مجموعة من اختبارات الدمج لعمليات تنفيذ السمات الخاصة بالمنصة
har-rendering-parity	أداة مرئية للتحقّق من تكافؤ العرض بين HAR وDesignCompose وFigma
harry-rpc-client	توفّر هذه السمة واجهة سطر أوامر لإرسال أوامر إلى Harry عبر RPC.
human-readable-report-generator	أداة للتحقّق بصريًا من عناصر الأمان
ktx-utils	توفّر هذه الحزمة أدوات لترميز ملفات الخامات بتنسيق Khronos KTX 2.0 وفك ترميزها.
list-test-app	توفير بيئة اختبار وعرض لإدارة القوائم في HAR
transfer-localizations	أداة لتحويل ملفات الترجمة إلى لغات أخرى بتنسيق XML في Android إلى تنسيق HAR proto.
variable-density-analyzer	تحلّل هذه الدالة مستند Figma وتحسب نسبة العُقد إلى متغيرات التصميم.