توفير وظائف نقل حزم البرمجيات والتحقق منها ومعالجتها وتفعيلها وإدارتها في منصة AUTOSAR Adaptive.
دور واجهة الخدمة وسياق النظام
تُشكّل واجهة الخدمة PackageManagement جزءاً أساسياً من وحدة إدارة التحديث والتكوين (UCM) ضمن منصة AUTOSAR Adaptive Platform، حيث تُتيح للعملاء والتطبيقات الخارجية إدارة شاملة لحزم البرمجيات ومجموعات البرمجيات (Software Clusters). يُرجَّح أن التطبيقات المستفيدة تعمل كعملاء (Clients) يتفاعلون عبر كائنات الوكيل (Proxy) مع UCM الذي يؤدي دور المزوّد (Skeleton Provider) لتقديم وظائف دورة حياة الحزم البرمجية وتوفير المعرّف الخاص بالنسخة التشغيلية لـ UCM عبر استدعاء [SWS_UCM_00343].
يتفاعل UCM عبر هذه الواجهة مع مكوّنات إدارة الحالة (State Management) أثناء تفعيل المجموعات البرمجية أو إعداد عمليات التحديث لضمان اتساق منصة المركبة قبل التطبيق النهائي للتغييرات [SWS_UCM_00352]. كما تتيح الخدمة استرجاع قائمة بجميع حزم البرمجيات المتاحة داخل UCM [SWS_UCM_00359]، وتوفير سجل زمني تاريخي للعمليات التي نُفذت بواسطة الوحدة [SWS_UCM_00355].
بنية الواجهة: الطرق والحقول ودلالات الاستدعاء
تعتمد كافة الطرق المعرّفة في هذه الواجهة على دلالات استدعاء تزامنية/غير أحادية الاتجاه (أي إن قيمة Fire & Forget هي false)، مما يتيح إرجاع نتائج أو أخطاء تطبيقية محددة للعميل. تتضمن الواجهة حقلاً وحيداً هو CurrentStatus من النوع CurrentStatusType، ويوفّر أسلوب القراءة والإشعار (Getter وNotifier) دون إمكانية التعديل (Setter)، وذلك لبث الحالة اللحظية لـ UCM إلى المشتركين ومراقبة تطور الإجراءات [SWS_UCM_00361].
توفر الواجهة مجموعة واسعة من طرق الاستعلام المتخصصة لمراقبة بنية البرمجيات، ومنها استرجاع معلومات المجموعات البرمجية المثبتة حالياً في حالة kPresent عبر [SWS_UCM_00357]، وقراءة تفاصيل البيان التوصيفي (Manifest) لتلك المجموعات [SWS_UCM_00358]. كما يمكن تتبع التغييرات المعلقة المزمع تطبيقها (مثل الإضافة أو التحديث أو الحذف) باستخدام [SWS_UCM_00356]، أو الاستعلام عن نسبة تقدّم الحالة النشطة ضمن آلة حالات إدارة الحزم بواسطة [SWS_UCM_00360].
دورة الحياة وسير العمليات واعتماديات الحالة
تبدأ جلسة معالجة الحزمة إما بتسجيل مسار حزمة برمجية موجودة مسبقاً في نظام الملفات أو معدّة للتنزيل عبر RegisterSoftwarePackage للحصول على معرّف النقل [SWS_UCM_00344]، أو عبر بدء عملية نقل صريحة باستدعاء TransferStart الذي يحدّد حجم الحزمة ويُرجع معرّف النقل TransferIdType وحجم الكتل المعتمد [SWS_UCM_00345]. بعد ذلك، يتم إرسال البيانات كتلة تلو الأخرى بواسطة TransferData مع التحقق من ترقيم الكتل وحجمها [SWS_UCM_00346]، ويُختتم النقل باستدعاء TransferExit للتحقق النهائي من الحجم الإجمالي والبيان والشهادات الأمنية [SWS_UCM_00347].
بمجرد اكتمال النقل، يستدعي العميل ProcessSwPackage لفك ومعالجة الحزم المحولة [SWS_UCM_00349]. يمكن تفعيل المجموعات البرمجية الناتجة في النظام عبر Activate بعد التنسيق مع إدارة الحالة [SWS_UCM_00352]، ثم إنهاء المعالجة وحذف البيانات المؤقتة ومصادر الحزم بواسطة Finish [SWS_UCM_00354]. وللتحكم في مسار العمليات الطويلة، تدعم الواجهة إيقاف الإجراءات مؤقتاً عبر Suspend [SWS_UCM_00397] واستئنافها لاحقاً عبر Resume [SWS_UCM_00398].
مخطط تسلسلي: تدفق نقل حزمة البرمجيات ومعالجتها وتفعيلها بين العميل ومزوّد الخدمة PackageManagement. المصادر: [SWS_UCM_00345]، [SWS_UCM_00346]، [SWS_UCM_00347]، [SWS_UCM_00349]، [SWS_UCM_00352]، [SWS_UCM_00354].
معالجة الأخطاء وأخطاء التطبيق
تُعرّف الواجهة منظومة دقيقة من أخطاء التطبيق (Application Errors) للتعامل مع الإخفاقات التشغيلية. يُرفض أي إجراء غير متوافق مع السياق أو الحالة الحالية برمز الخطأ kOperationNotPermitted، وهو خطأ مشترك في معظم العمليات مثل [SWS_UCM_00348] و[SWS_UCM_00351]. كما تُرجع الطرق المعنية بنقل البيانات خطأ kTransferIdInvalid في حال عدم صحة معرّف النقل [SWS_UCM_00348]، وخطأ kMemoryInsufficient في حال عدم كفاية الذاكرة التخزينية [SWS_UCM_00345] و[SWS_UCM_00346].
في حالات فشل التحقق الأمني أو التوافق أثناء معالجة الحزمة عبر [SWS_UCM_00349]، تُطلق أخطاء نوعية مثل kAuthenticationFailed وkPackageVersionIncompatible وkChecksumDescriptionInvalid وkProcessedSoftwarePackageInconsistent، بالإضافة إلى حظر حذف المجموعات المحمية برمز kSwclRemovalDenied. عند تعثر العملية، يُسمح بإلغاء المعالجة الجارية عبر Cancel [SWS_UCM_00351]، أو حذف الحزم المنقولة بواسطة DeleteTransfer [SWS_UCM_00348]، أو التراجع عن تأثيرات المعالجة باستخدام RevertProcessedSwPackages [SWS_UCM_00350]، وصولاً إلى استعادة حالة النظام السابقة كلياً عبر Rollback [SWS_UCM_00353].
تم إنشاء هذا الدليل الإرشادي آلياً استناداً إلى متطلبات منصة AUTOSAR Adaptive (الإصدار R25-11).
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني