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

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

لمزيد من المعلومات، يُرجى الاطّلاع على 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 أداة سطر أوامر لخدمة Display Safety تتيح تشغيل أجهزة 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 وتحسب نسبة العُقد إلى متغيرات التصميم.