نطاق أسماء apext::log

دليل المستخدممولَّد بالذكاء الاصطناعي

يوفر واجهة آمنة بالنسبة للخيوط لإعادة توجيه الرسائل المنمذجة إلى أدوات التتبع الخارجية.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 199c14229bd8 المصدر أسئلة مفتوحة (2)

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يوفر واجهة آمنة بالنسبة للخيوط لإعادة توجيه الرسائل المنمذجة إلى أدوات التتبع الخارجية.

يوفر نطاق الأسماء apext::log باستخدام قالب الدالة TraceArti واجهة لإعادة توجيه رسائل التتبع المنمذجة إلى أدوات تتبع وقت التشغيل الخارجية [SWS_LOG_20000]. يتم استدعاء الدالة داخليًا وحصريًا بواسطة إطار عمل المسجل (Logger) عند التبديل بين التسجيل (Logging) والتتبع (Tracing)، وتعالج المعرفات الخاصة بالرسائل بالإضافة إلى المعلمات المتغيرة [SWS_LOG_20000]. وتعتبر القيود المركزية هي الحد الأدنى من العبء الإضافي في وقت التشغيل، والأمان الكامل بالنسبة للخيوط، والتنفيذ الآمن من الاستثناءات بدون أخطاء أو قيم إرجاع.

السياق

يوفر نطاق الأسماء apext::log واجهات وظيفية لنظام التسجيل والتتبع الفرعي في AUTOSAR Adaptive Platform. تكمن مسؤوليته الأساسية في توفير واجهة مخصصة لأدوات تتبع وقت التشغيل الخارجية عبر قالب الدالة TraceArti [SWS_LOG_20000]. من المرجح، كتفسير، أن تشير التسمية بالبادئة apext إلى أنه امتداد للمنصة (Adaptive Platform Extension) يربط آليات تتبع محددة مثل AUTOSAR Run-Time Interface (ARTI) بإطار عمل التسجيل. سؤال Q-325896ce9f6b8e42 (مفتوح)

في بنية النظام، يعمل نطاق الأسماء كحلقة وصل بين البنية التحتية الداخلية للتسجيل وأدوات التحليل أو التتبع اللاحقة. تتفاعل بشكل أساسي ثلاثة مكونات مع بعضها البعض: إطار عمل المسجل الداخلي، ودالة الواجهة TraceArti داخل apext::log، بالإضافة إلى أداة التتبع المتصلة [SWS_LOG_20000]. يعالج إطار عمل المسجل أحداث التطبيق ويعيد توجيه الرسائل المنمذجة عند التبديل المناسب إلى TraceArti، والذي يسلم البيانات إلى أداة التتبع الخاصة بالشركة المصنعة [SWS_LOG_20000].

مخطط السياق: تضمين TraceArti بين إطار عمل المسجل وأداة التتبع. المصادر: [SWS_LOG_20000]

دورة الحياة

لا يغلف نطاق الأسماء apext::log أي مثيلات فئات طويلة العمر، أو كائنات جلسات، أو كيانات ذات حالة ذات دورة حياة مستقلة. لا توجد في نطاق الأسماء روتينيات تهيئة أو إنهاء صريحة؛ بل يتم تنفيذ الوظائف حصريًا عبر دوال قوالب حرة [SWS_LOG_20000]. وبالتالي، ترتبط دورة حياة وظيفة التتبع بالكامل بدورة حياة التشغيل الشاملة لإطار عمل المسجل.

فيما يتعلق بسلوك التزامن والأمان التشغيلي، تنطبق ضمانات صارمة: تم تحديد الواجهة TraceArti صراحة كآمنة بالنسبة للخيوط (thread-safe) [SWS_LOG_20000]. يتيح ذلك لإطار عمل المسجل تفويض استدعاءات التتبع بالتوازي من سياقات تنفيذ وخيوط متعددة إلى نطاق الأسماء دون مزامنة خارجية. في الوقت نفسه، تم التصريح عن الدالة بأنها آمنة من الاستثناءات (exception safe) وnoexcept [SWS_LOG_20000]، بحيث لا يمكن أن تحدث تسريبات في الموارد أو حالات تفكيك مكدس غير منضبطة في أي وقت أثناء الاستدعاء.

مسار الاستخدام

لم يتم تصميم دوال نطاق الأسماء apext::log للاستدعاء المباشر بواسطة برمجيات التطبيق العامة. بدلاً من ذلك، يتم استدعاء TraceArti داخليًا وحصريًا بواسطة إطار عمل المسجل عندما ينتقل بين التسجيل التقليدي والتتبع القائم على ARTI [SWS_LOG_20000]. يقوم المطورون أو مسؤولو الدمج بتضمين ملف الترويسة المناسب #include "apext/log/trace_arti.h" عند الحاجة للوصول إلى التصريح [SWS_LOG_20000].

عند الاستدعاء، تعالج الدالة رسائل منمذجة (modeled messages) خاصة بأداة التتبع المستخدمة في كل حالة [SWS_LOG_20000]. تقبل الواجهة لهذا الغرض معرّفًا محددًا للرسالة msg_id من نوع محدد بالتنفيذ MsgId بالإضافة إلى حزمة معلمات متغيرة params... من أي أنواع Params... [SWS_LOG_20000]. للحفاظ على تكاليف وقت التشغيل منخفضة قدر الإمكان في مسار التتبع، تتطلب المواصفة تقليلاً صارمًا للعبء الإضافي في وقت التشغيل؛ ويجب تحقيق ذلك، على سبيل المثال، من خلال تخصيصات القوالب المصممة خصيصًا استنادًا إلى MsgId المعنية [SWS_LOG_20000]. من المفترض أن مثل هذه التخصيصات يتم إنشاؤها عادة بواسطة مولدات الأدوات كجزء من دمج سلسلة الأدوات (Toolchain) للأنظمة المستهدفة المعنية.

سيناريوهات الأخطاء

في مجال معالجة الأخطاء، يتبع apext::log تصميمًا متسامحًا مع الأخطاء دون الإشارة إلى أخطاء وقت التشغيل للمتصل. لا يحدد توقيع الدالة لـ TraceArti أي قيمة إرجاع (void) ويحظر تمامًا إطلاق استثناءات C++‎ عبر مواصفة noexcept [SWS_LOG_20000]. وبالتالي، يجب ضمان الشروط المسبقة مثل صلاحية معرفات الرسائل والبيانات المفيدة الممررة إلزاميًا بواسطة إطار عمل المسجل المستدعي أو التخصيصات المقابلة، حيث لا يمكن نقل رموز الخطأ في حالة حدوث خطأ [SWS_LOG_20000].

تم إنشاء هذا الدليل بواسطة ذكاء اصطناعي ويلخص المواصفة الخاصة بالواجهة apext::log.

لا توجد بيانات عناصر لهذا الإصدار

الدوال

TraceArti دالة

Handles a modeled message, specific to the used trace tool. This function is only called internally by the Logger framework when switching between Log and TraceArti. It represents the interface to trace tools. The runtime overhead of this function shall be kept as minimal as possible, e.g. by using specializations based on the MsgId.

template <typename MsgId, typename... Params> void TraceArti (const MsgId &msg_id, const Params &... params) noexcept;

توثيق الدوال الحرة

دالة TraceArti [SWS_LOG_20000] Upstream: RS_LT_00003

template <typename MsgId, typename... Params> void TraceArti (const MsgId &msg_id, const Params &...                       params) noexcept;

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: afa9b5cd99a6 المصدر أسئلة مفتوحة (1)

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام وسياق الاستدعاء

تُستخدم دالة القالب TraceArti في نطاق الأسماء apext::log لمعالجة الرسائل المنمذجة خصيصاً لأداة التتبع المتصلة المعنية [SWS_LOG_20000]. وتعمل كواجهة لأدوات التتبع ولم يتم تصميمها للاستدعاء المباشر بواسطة كود التطبيق، بل يتم استدعاؤها داخلياً فقط بواسطة إطار عمل المُسجل عند التبديل بين Logging وTraceArti [SWS_LOG_20000]. وتأخذ الدالة كمعلمة عبر msg_id كائناً محدداً للرسالة من نوع خاص بالتنفيذ، بالإضافة إلى وسائط الرسالة عبر حزمة المعلمات params؛ ولم يتم تعريف قيمة إرجاع [SWS_LOG_20000].

التزامن، ومعالجة الأخطاء، وسلوك وقت التشغيل

تم تحديد الواجهة بأنها آمنة لخيوط المعالجة (thread-safe) وآمنة من الاستثناءات (exception safe عبر noexcept) [SWS_LOG_20000]. لا توجد رموز أخطاء محددة أو آليات للإبلاغ عن الأخطاء، بحيث يتعين على الدالة استبعاد الاستثناءات تماماً [SWS_LOG_20000].

يجب الإبقاء على العبء الزائد لوقت تشغيل TraceArti عند أدنى مستوى ممكن [SWS_LOG_20000]. ولتحقيق ذلك، تذكر المواصفة صراحةً التخصيصات المستندة إلى معلمة القالب MsgId كنهج للحل [SWS_LOG_20000]. تفسير: بالنسبة لتوصيل أداة تتبع، يُرجح أن يعني هذا أنه ينبغي تحسين منطق المعالجة الخاص بالرسالة ويفضل أن يكون ذلك في وقت الترجمة عبر تخصيصات القالب. سؤال Q-24ea7f9557ada827 (مفتوح)

تم إنشاء إشعار الاستخدام هذا آليًا استنادًا إلى مواصفة AUTOSAR لـ R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei	#include "apext/log/trace_arti.h"
Scope	namespace apext::log
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Template-Parameter

Parameter	Beschreibung
MsgIdParams	the type of the msg_id parameter the types of the params parameters

Parameter (in)

Parameter	Beschreibung
msg_id	an implementation-defined type identifying the message object
params	the arguments of the message

Rückgabewert

Typ	Beschreibung
None

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_LOG_20000
Status: valid/auto-approved
Version: AUTOSAR/AP/record/SWS_LOG_20000@rel:R25-11#f216ca66
Content hash: f216ca66
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_LogAndTrace.pdf#nameddest=SWS_LOG_20000

Status: valid/auto-approved Version: rel:R25-11#5511a3f8 Versionshistorie & Revisions (2 transitions, 4 revision)

Current State: valid/auto-approved
Reason: unchanged
Campaign: 2026-08-sws-log-pilot-after-tool-improvement
Active Version: AUTOSAR/AP/record/SWS_LOG_20000@rel:R25-11#5511a3f8

Recorded Revisions (4):

R25-11rel:R25-11#4e0ac6b92026-09-30
R23-11rel:R23-11#ab5e92c82026-10-14
R24-11rel:R24-11#5511a3f82026-10-14
R25-11rel:R25-11#5511a3f82026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-10	tool	`valid/unversioned` → `invalid/obsolete`	spec update after tool improvement	2026-08-sws-log-pilot-after-tool-improvement
2026-08-10	tool	`invalid/obsolete` → `valid/auto-approved`	unchanged	2026-08-sws-log-pilot-after-tool-improvement