PowerShell / المتوسط: الربط والأخطاء والوحدات والبيانات والاختبارات / الدرس 10
تجميع الوحدات بواجهات عامة صريحة
افصل الاكتشاف وآثار الاستيراد والمصدرات والبيانات الوصفية والإصدارات وتوافق المنصة.
في هذه الصفحة
أهداف الدرس
- شرح وحدات البرنامج والبيانات الوصفية والتصدير.
- اعتبار الاستيراد وdot-sourcing حدود تنفيذ.
- تثبيت واختبار الاعتماد مستقلاً عن الأسماء.
الوحدة عقد معاد بإصدار
تجمع الوحدة دوال وأوامر ومزودات وأنواعاً، ولـ psm1 وmanifest بيانات ومتطلبات ومصدرات. لا يحدد الاسم النسخة أو المسار؛ يؤثر التحميل التلقائي وPSModulePath والتوافق. سجل الأثر واختبر العام لا مجرد الاستيراد ولا تثبت محتوى للتعليم. ويمكن أن تتغير نتيجة الاكتشاف عند اختلاف PSModulePath أو التحميل التلقائي، حتى لو بقي نص الاستدعاء نفسه، لذلك يجب حفظ أصل الأثر المحلول.
التصدير المقصود وإبقاء المساعد خاصاً
حدد المصدرات وعقودها ولا تجعل المساعد اعتماداً عاماً. قد يثبت الاسم وتتغير الأنواع والافتراضات والقنوات، فراجع السلوك. تجنب تعديل حالة المستدعي عند الاستيراد، ويفرق dot-sourcing بالمجال الحالي فلا يقرأ غير الموثوق بيانات خاملة. افصل التحليل والتحميل الموثوق. وقد يشغل الاستيراد شيفرة قبل أول أمر عام، لذا لا يعفي حصر التصدير من مراجعة تهيئة الوحدة واعتماداتها وآثارها في جلسة المستدعي.
قراءة وحدة توضيحية دون استيرادها
يوضح المصدر دالة بيانات وتصديراً لا حزمة مثبتة أو manifest مختبراً. لم تستورد وحدة، وليعلن الحقيقي النسخة والمنصة والاعتماد والاختبار. يسهل حصر المصدرات المراجعة ولا يؤمن تهيئة خفية؛ راجع زمن الاستيراد واعتماداته أيضاً. ولا يثبت المثال وجود حزمة قابلة للتثبيت أو سلامة ملف بياناتها الوصفية، بل يوضح فقط كيف يصبح اختيار الواجهة العامة صريحاً في المصدر.
function Get-LabLabel {
[CmdletBinding()]
param([ValidateSet('Review', 'Archive')][string]$Mode = 'Review')
[pscustomobject]@{ Label = $Mode; SchemaVersion = 1 }
}
Export-ModuleMember -Function Get-LabLabel
هو مصدر بأسلوب psm1 فقط دون استيراد أو تنفيذ أو تقييم اعتماد أو ملف بدء أو تثبيت.
قد تغير طبقات التوافق حدود الكائن والعملية
تدعم7 سيناريوهات توافق مختارة على ويندوز لا توافقاً أصلياً شاملاً أو تعدد منصات. قد تفصل عملية وتسلسل كائنات فتتغير الطرق والحالة وتبقى API ويندوز مقيدة. اقرأ المسار واختبر احتياج المستهلك لا الاستيراد دليلاً على كل طريقة أو مزود أو اعتماد أو إدارة. وقد يعيد مسار التوافق لقطة خصائص بدلاً من كائن بطرقه الأصلية، فيختلف سلوك المستهلك رغم نجاح الاستيراد وظهور الأسماء المتوقعة.
فحص هوية الاعتماد المعلنة دون حل المثبت
يقارن القاموس الهوية والنسخة لا solver أو محلل manifest أو حل أو استيراد. ليحفظ الإصدار الأصل والفعلي والبيئة والسابق، واختبر السلوك لا التسمية. لا نجري بحث معرض أو تثبيتاً أو اكتشافاً بل نقارن المعلن. وتحتاج الترقية إلى اختبار السلوك العام أيضاً، لأن تطابق الاسم أو زيادة رقم الإصدار لا يصف التغيرات في الأنواع والافتراضات والقنوات.
required = {'Name': 'Lab.Reporting', 'Version': '1.0.0', 'Edition': 'Core'}
resolved_fixture = required.copy()
print('declared_lock_matches=' + str(required == resolved_fixture))
print('module_import=not-performed')declared_lock_matches=True
module_import=not-performedالهوية افتراضية لا حزمة مدعاة أو منزلة أو محملة؛ فحص قواميس فقط.
الأخطاء الشائعة وإصلاحها
اعتبار اسم الوحدة قفل نسخة
- لماذا يحدث؟
- اختلطت الهوية والمسار والنسخة.
- كيف تصلحه؟
- سجل وتحقق من الحل.
- كيف تتجنب تكراره؟
- احفظ بياناً مراجعاً.
تنفيذ إعداد dot-sourced شيفرة غير متوقعة
- لماذا يحدث؟
- اختلط التحميل بالتحليل.
- كيف تصلحه؟
- استخدم محلل بيانات معرفاً.
- كيف تتجنب تكراره؟
- راجع كل حد تحميل.
اعتبار استيراد التوافق دعماً أصلياً عاماً
- لماذا يحدث؟
- أُهملت الحدود.
- كيف تصلحه؟
- اختبر العمليات المدعومة فعلياً.
- كيف تتجنب تكراره؟
- وثق الآلية وحدودها.
اختبر فهمك
1. لماذا لا يثبت حصر التصدير أمان الاستيراد؟
اعرض الحل المشروح
قد تنفذ التهيئة والاعتمادات قبل الدالة؛ راجعها وافحص الواجهة بالنسخة المعلنة.
2. ماذا يثبت قاموس اعتماد مصطنع؟
اعرض الحل المشروح
يثبت اتساق المثبت فقط لا الوجود والأصالة والتثبيت والمسار والاستيراد والمنصة.
أهم ما تعلمته
- راجع الوحدات واعطها إصدارات كاعتماد تنفيذي.
- افصل العام وآثار الاستيراد وآلية التوافق.