Al.exe (رابط التجميع)
يقوم رابط التجميع بإنشاء ملف يحتوي على بيان تجميع من ملف واحد أو أكثر سواء كان وحدات نمطية أو ملفات الموارد, حيث إن الوحدة النمطية عبارة عن ملف (Microsoft intermediate language (MSIL الذي لا يحتوي على بيان تجميع.
.gif "ملاحظة") ملاحظة |
|---|
يجب أن يتضمن التجميع الخاص بك بيان win32 الذي يحدد مستوى التنفيذ المطلوب لتجنب الخضوع للتمثيل الافتراضي على جهاز كمبيوتر Windows Vista,فعند استخدام al.exe مباشرةً من سطر الأوامر يمكنك إما أن تضمّن البيان في ملف الموارد win32 أو استخدام mt.exe لإلحاق البيان في عملية البناء خلال مرحلة لاحقة,و في Visual Studio 2008 فإن المجمعين #C و Visual Basic يضمّنان بيان win32 تلقائياً في التجميع.لمزيد من المعلومات، راجع /win32manifest (خيارات المحول البرمجي C#). |
al sources options
المعلمات
يمكنك تحديد واحد أو أكثر من الـ sources التالية.
المصدر |
الوصف |
|---|---|
file[,target] |
ينسخ المحتويات لوحدة نمطية file إلى اسم الملف المحدد بواسطة target, و بعد النسخ يقوم Al.exe بجمع target في تجميع, |
/embed[resource]:file[,name[,private]] |
يضمّن المورد المحدد بواسطة file في الصورة التي تحتوي على بيان التجميع, وهكذا فإن Al.exe ينسخ المحتويات لــ file في الصورة المحمولة القابلة للتنفيذ (PE). المعلمة name عبارة عن معرّف داخلي للمورد, فبشكل افتراضي تعمم الموارد في التجميع (مرئية لتجميعات أخرى), و لكن تحديد private يجعل المورد غير مرئي لتجميعات أخرى. إذا كان file عبارة عن ملف مورد .NET Framework منشأ باستخدام منشئ ملف المورد Resgen.exe أو في بيئة التطوير التي يمكن للأعضاء الوصول إليها في System.Resources . لمزيد من المعلومات، راجع ResourceManager. و لكافة الموارد الأخرى استخدم الأساليب GetManifestResource * في Assembly للوصول إلى الموارد في وقت التشغيل. إلا إذا تم تمرير ملفات المورد فقط إلى Al.exe فإن ملف الإخراج يصبح عبارة عن تجميع مورد تابع. |
/link[resource]:file[,name[,target[,private]]] |
يربط ملف مورد إلى تجميع حيث إن المورد المحدد بواسطة file يصبح جزءًا من التجميع و لا يتم نسخ الملف, و المعلمة file يمكن أن تكون في أي تنسيق للملف على سبيل المثال، يمكنك تحديد مكتبة ارتباط حيوي (DLL) أصلية كالمعلمة file فهذا سوف يجعل مكتبة الارتباط الحيوي (DLL) الأصلية جزءاً من التجميع بحيث يمكن تثبيتها في مخزن التجميع العمومي المؤقت و الوصول إليها من خلال تعليمات برمجية مدارة في التجميع و يمكنك أيضًا القيام بذلك باستخدام خيار المحول البرمجي /linkresource. لمزيد من المعلومات، راجع /linkresource (خيارات المحول البرمجي C#). المعلمة name عبارة عن معرّف داخلي للمورد, بحيث تقوم المعلمة target بتحديد مسار أو اسم ملف في Al.exe الذي ينسخ file و بعد النسخ يقوم Al.exe بجمع target في تجميع, فبشكل افتراضي تعمم الموارد في التجميع (مرئية لتجميعات أخرى), و لكن تحديد private يجعل المورد غير مرئي لتجميعات أخرى. إذا كان file عبارة عن ملف مورد .NET Framework منشأ باستخدام منشئ ملف المورد (Resgen.exe) أو في بيئة التطوير التي يمكن للأعضاء الوصول إليها في مساحة الاسم System.Resources. لمزيد من المعلومات، راجع ResourceManager. لكافة الموارد الأخرى استخدم الأساليب GetManifestResource * في الفئة Assembly للوصول إلى الموارد في وقت التشغيل. إلا إذا تم تمرير ملفات المورد فقط إلى Al.exe فإن ملف الإخراج يصبح عبارة عن تجميع مورد تابع. |
يمكنك تحديد الـ options التالية و لكن يجب عليك تحديد /out.
الخيار |
الوصف |
|---|---|
/algid:id |
تحديد خوارزمية لتجزئة كافة الملفات في تجميع ملف متعدد ما عدا الملف الذي يحتوي على بيان التجميع, فالخوارزمية الافتراضية عبارة عن CALG_SHA1 ويمكنك مراجعة ALG_ID في وثائق النظام الأساسي SDK للحصول على خوارزميات أخرى, و بالنسبة للمنتج الأول من .NET Framework فإن CALG_SHA1 و CALG_MD5 فقط صالحة. يتم تخزين قيم التجزئة في جدول الملف لبيان التجميع و التحقق من ملفات التجميع مقابل هذه التجزئة في وقت التحميل و التثبيت. يمكنك أيضاً تحديد هذا الخيار كسمة مخصصة (AssemblyAlgorithmIdAttribute) في التعليمات البرمجية للمصدر لأية وحدة نمطية. |
/base[address]:addr |
يحدد العنوان عندما يتم تحميل مكتبة ارتباط حيوي DLL على جهاز كمبيوتر المستخدم في وقت التشغيل, و إذا قمت بتحديد العنوان الأساسي لـمكتبات الارتباط الحيوي DLL بدلاً من السماح لنظام التشغيل بنقل مكتبات الارتباط الحيوي DLL في مساحة العملية فإنه يتم تحميل التطبيقات بشكل أسرع. |
/bugreport:filename |
إنشاء ملف (filename) الذي يحتوي على معلومات لتقديم تقارير حول الأخطاء. |
/comp[any]:text |
يحدد سلسلة لحقل الشركة في التجميع, و إذا كان text يحتوي على مسافة فقم بوضع السلسلة بعلامات اقتباس مزدوجة (" "), فهذه السلسلة عبارة عن سمة مخصصة على التجميع و هي متوفرة للعرض مع انعكاس. و إذا لم تقم بتحديد /win32res فإن text يظهر في "مستكشف Microsoft Windows" كالخاصية Company للملف, وهكذا إذا قمت بتحديد /win32res تظهر معلومات الشركة في ملف المورد المحدد كالخاصية Company في مستكشف Windows. إذا كان النص عبارة عن سلسلة فارغة ("") فإن المورد Win32 Company يظهر كمساحة مفردة. إذا قمت بتحديد /win32res فإن /company لن يؤثر على معلومات المورد Win32. يمكنك أيضاً تحديد هذا الخيار كسمة مخصصة (AssemblyCompanyAttribute) في التعليمات البرمجية للمصدر لأية وحدة نمطية MSIL. |
/config[uration]:text |
يحدد سلسلة لحقل التكوين في التجميع, و إذا كان text يحتوي على مسافة فقم بوضع السلسلة بعلامات اقتباس مزدوجة (" "), فهذه السلسلة عبارة عن سمة مخصصة على التجميع و هي متوفرة للعرض مع انعكاس. إذا كان النص عبارة عن سلسلة فارغة فإن مورد التكوين Win32 يظهر كمساحة مفردة. يمكنك أيضاً تحديد هذا الخيار كسمة مخصصة (AssemblyConfigurationAttribute) في التعليمات البرمجية للمصدر لأية وحدة نمطية MSIL. |
/copy[right]:text |
يحدد سلسلة لحقل حقوق النشر في التجميع, و إذا كان text يحتوي على مسافة فقم بوضع السلسلة بعلامات اقتباس مزدوجة (" "), فهذه السلسلة عبارة عن سمة مخصصة على التجميع و هي متوفرة للعرض مع انعكاس. إذا لم تقم بتحديد /win32res فإن /copyright يظهر في مستكشف Windows كمورد حقوق النشر Win32. إذا كان النص عبارة عن سلسلة فارغة فإن مورد حقوق النشر Win32 يظهر كمساحة مفردة. إذا قمت بتحديد /win32res فإن /copyright لن يؤثر على معلومات المورد Win32. يمكنك أيضاً تحديد هذا الخيار كسمة مخصصة (AssemblyCopyrightAttribute) في التعليمات البرمجية للمصدر لأية وحدة نمطية MSIL. |
/c[ulture]:text |
تحديد سلسلة الثقافة لتقترن مع التجميع, فالقيم الصالحة لـللثقافات هي تلك المعرّفة بواسطة "طلبات الإنترنت" لمستند 1766 التعليقات (RFC) تحت عنوان "العلامات لتعريف اللغات". و إذا كان text يحتوي على مسافة فقم بوضع السلسلة بعلامات اقتباس مزدوجة (" "), بحيث لا يوجد أية سلسلة ثقافة افتراضية فهذه السلسلة متوفرة للعرض مع انعكاس. للحصول على معلومات حول السلاسل الصالحة text، راجع CultureInfo. يمكنك أيضاً تحديد هذا الخيار كسمة مخصصة (AssemblyCultureAttribute) في التعليمات البرمجية للمصدر لأية وحدة نمطية MSIL. |
/delay[sign][+|-] |
تحدد ما إذا كان سيتم توقيع التجميع بالكامل أو جزئياً, استخدم /delaysign- إذا كنت تريد تجميعاً موقعاً بشكل كامل. و استخدم /delaysign+ إذا كنت فقط ترغب في تضمين المفتاح العام في التجميع. عندما تقوم بطلب تجميع موقع بشكل كامل فإن Al.exe يجزّئ الملف الذي يحتوي على البيان (بيانات تعريف التجميع) و يوقّع ذلك الجزء بالمفتاح الخاص يتم تخزين التوقيع الرقمي الناتج في الملف الذي يحتوي على ملف البيان. أما عند تأخير توقيع تجميع فإن Al.exe لا يحسب ولا يخزن التوقيع ولكن فقط يقوم بحفظ مساحة في الملف بحيث يمكن إضافة التوقيع لاحقاً. يكون الإعداد الافتراضي هو /delaysign-. الخيار /delaysign ليس له أي تأثير إلا إذا استخدم مع /keyfile أو /keyname, فعلى سبيل المثال، استخدام /delaysign+ تمكن المختبر بوضع التجميع في ذاكرة التخزين المؤقت العمومية, و بعد الاختبار يمكنك توقيع التجميع بشكل كامل عن طريق تضمين المفتاح الخاص في التجميع. ملاحظة
قبل استخدام Gacutil.exe (أداة مخزن التجميع العمومي المؤقت) لوضع تجميع بتوقيع متأخر في ذاكرة التخزين المؤقت العمومية قم باستخدام Sn.exe (أداة الاسم القوي) لتسجيل التجميع ليتم تخطي التحقق من صحته,على سبيل المثال، Sn.exe –Vr delaySignedAssembly.استخدم هذا للتطوير فقط.
يمكنك أيضاً تحديد هذا الخيار كسمة مخصصة (AssemblyDelaySignAttribute) في التعليمات البرمجية للمصدر لأية وحدة نمطية MSIL. |
/descr[iption]:text |
تحديد سلسلة للحقل Description في التجميع, و إذا كان text يحتوي على مسافة فقم بوضع السلسلة بعلامات اقتباس مزدوجة (" "), فهذه السلسلة عبارة عن سمة مخصصة على التجميع و هي متوفرة للعرض مع انعكاس. إذا لم تقم بتحديد /win32res فإن /description يظهر في مستكشف Windows كالمورد Win32 تعليقات. إذا كان النص عبارة عن سلسلة فارغة فإن المورد Win32 تعليقات يظهر كمساحة مفردة. إذا قمت بتحديد /win32res فإن /description لن يؤثر على معلومات المورد Win32. يمكنك أيضاً تحديد هذا الخيار كسمة مخصصة (Description) في التعليمات البرمجية للمصدر لأية وحدة نمطية MSIL. |
/e[vidence]:file |
يضمّن file في التجميع مع اسم المورد لدليل.الأمان. لا يمكنك استخدام دليل.الأمان لموارد عادية. |
/fileversion:version |
تحديد سلسلة للحقل إصدار ملف في التجميع, فهذه السلسلة عبارة عن سمة مخصصة على التجميع و هي متوفرة للعرض مع انعكاس. إذا لم تقم بتحديد /win32res فإنه سيتم استخدام /fileversion كالمورد Win32 إصدار ملف, أما إذا لم تقم بتحديد /fileversion فإنه سيتم نشر المورد إصدار ملف عن طريق المورد Win32 إصدار تجميع. إذا تم تحديد /win32res فإن /fileversion لا يؤثر على المورد Win32. يمكنك أيضاً تحديد هذا الخيار كسمة مخصصة (AssemblyFileVersionAttribute) في التعليمات البرمجية للمصدر لأية وحدة نمطية MSIL. |
/flags:flags |
تحديد قيمة للحقل Flags في التجميع, حيث إن القيم المحتملة لـ flags:
يمكنك أيضاً تحديد هذا الخيار كسمة مخصصة (AssemblyFlagsAttribute) في التعليمات البرمجية للمصدر لأية وحدة نمطية MSIL. |
/fullpaths |
يؤدي Al.exe لاستخدام المسار المطلق عن أية ملفات التي يتم الإعلام عنها في رسالة خطأ. |
/help |
يقوم بعرض بناء جملة الأمر والخيارات للأداة. |
/keyf[ile]:filename |
تحديد ملف (filename) الذي يحتوي على زوج مفاتيح أو فقط مفتاح عام لتوقيع تجميع, بحيث يقوم المحول البرمجي بإدراج المفتاح العام في بيان التجميع و من ثم بتوقيع التجميع النهائي مع المفتاح الخاص, فراجع أداة السم القوي (Sn.exe) للحصول على معلومات حول إنشاء ملفات المفاتيح و تثبيت أزواج المفاتيح في حاويات المفاتيح. إذا كنت تستخدم التوقيع المتأخر فإن هذا ملف عادة سوف يحتوي على المفتاح العام و ليس المفتاح الخاص. تظهر معلومات المفتاح العام (لزوج المفاتيح) في الحقل .publickey للتجميع. يمكنك أيضاً تحديد هذا الخيار كسمة مخصصة (AssemblyKeyFileAttribute) في التعليمات البرمجية للمصدر لأية وحدة نمطية MSIL. إذا تم تحديد كلا من /keyfile و /keyname (إما بواسطة خيار سطر الأوامر أو بواسطة سمة مخصصة) في التحويل البرمجي نفسه فإن Al.exe سيجرب أولاً الحاوية المحددة باستخدام /keyname, و إذا نجح ذلك فإنه يتم توقيع التجميع مع المعلومات الموجودة في حاوية المفاتيح, فإذا لم يجد المحول البرمجي حاوية المفاتيح فإنه سيجرب الملف المحدد بـاستخدام /keyfile, و في حال نجاح ذلك سيتم توقيع التجميع باستخدام المعلومات الموجودة في ملف المفاتيح و سيتم تثبيت معلومات المفاتيح في حاوية المفاتيح (مشابهة خيار -i في Sn.exe) حيث إن الخيار /keyname سيكون صالح على المحول البرمجي التالي. |
/keyn[ame]:text |
إن تحديد حاوية تحتوي على زوج مفاتيح سوف يقوم بتوقيع التجميع (لإعطائه اسماً قوياً) عن طريق إدراج المفتاح العام في بيان التجميع, ثم يقوم Al.exe بتوقيع التجميع النهائي مع المفتاح الخاص. استخدم Sn.exe لإنشاء زوج مفاتيح. تظهر معلومات المفاتيح في الحقل .publickey للتجميع. في حالة وجود مسافة مضمنة قم بوضع text بين علامات اقتباس مزدوجة (" "). يمكنك أيضاً تحديد هذا الخيار كسمة مخصصة (AssemblyKeyNameAttribute) في التعليمات البرمجية للمصدر لأية وحدة نمطية MSIL. |
/main:method |
تحديد اسم مؤهل بشكل كامل (class. method) للأسلوب لاستخدامه كنقطة إدخال عند تحويل وحدة نمطية إلى ملف قابل للتنفيذ. |
/nologo |
يمنع عرض الشعار أو اللافتة عند سطر الأوامر عندما تقوم باستدعاء Al.exe. |
/out:filename |
يحدد الاسم للملف الذي تم إنشاؤه من قبل Al.exe, و هذا خيار مطلوب. |
/platform:text |
حدد أي نظام أساسي يمكن لهذه التعليمات البرمجية تشغيله بحيث يجب أن يكون x86 أو Itanium أو x64 أو anycpu (الافتراضي). |
/prod[uct]:text |
يحدد سلسلة للحقل منتج في التجميع, و إذا كان text يحتوي على مسافة فقم بوضع السلسلة بعلامات اقتباس مزدوجة (" "), فهذه السلسلة عبارة عن سمة مخصصة على التجميع و هي متوفرة للعرض مع انعكاس. إذا لم تقم بتحديد /win32res فإن /product يظهر في مستكشف Windows كالمورد Win32 اسم منتج. إذا كان النص عبارة عن سلسلة فارغة فإن المورد Win32 اسم منتج يظهر كمساحة مفردة. إذا قمت بتحديد /win32res فإن /product لن يؤثر على معلومات المورد Win32. يمكنك أيضاً تحديد هذا الخيار كسمة مخصصة (AssemblyProductAttribute) في التعليمات البرمجية للمصدر لأية وحدة نمطية MSIL. |
/productv[ersion]:text |
يحدد سلسلة للحقل إصدار منتج في التجميع, و إذا كان text يحتوي على مسافة فقم بوضع السلسلة بعلامات اقتباس مزدوجة (" "), فهذه السلسلة عبارة عن سمة مخصصة على التجميع و هي متوفرة للعرض مع انعكاس. إذا لم تقم بتحديد /win32res فإنه سيتم استخدام /productversion كالمورد Win32 إصدار منتج, أما إذا لم تقم بتحديد /productversion فإنه سيتم نشر المورد إصدار منتج عن طريق المورد Win32 إصدار ملف. إذا قمت بتحديد /win32res فإن /productversion لن يؤثر على معلومات المورد Win32. يمكنك أيضاً تحديد هذا الخيار كسمة مخصصة (AssemblyInformationalVersionAttribute) في التعليمات البرمجية للمصدر لأية وحدة نمطية MSIL. |
/t[arget]:lib[rary] | exe | win[exe] |
تحديد تنسيق الملف لملف الإخراج: (مكتبة تعليمات برمجية) [lib[rary أو (تطبيق وحدة التحكم) exe أو (تطبيق يستند إلى ويندوز) [win[exe. [lib[rary هو الافتراضي. |
/template:filename |
يحدد التجميع filename الذي يرث كافة بيانات تعريف التجميع باستثناء حقل الثقافة. إن التجميع الذي تقوم بإنشائه باستخدام /template سيكون تجميع تابع. |
/title:text |
تحديد سلسلة للحقل عنوان في التجميع, و إذا كان text يحتوي على مسافة فقم بوضع السلسلة بعلامات اقتباس مزدوجة (" "), فهذه السلسلة عبارة عن سمة مخصصة على التجميع و هي متوفرة للعرض مع انعكاس. إذا لم تقم بتحديد /win32res فإن /title يظهر في مستكشف Windows كالمورد Win32 وصف الذي يتم استخدامه من قبل الـ shell كالاسم المألوف لتطبيق ما, و يتم أيضاً عرضه على القائمة الفرعية فتح باستخدام من القائمة المختصرة لنوع ملف الذي يحتوي على تطبيقات دعم متعددة. إذا كان النص عبارة عن سلسلة فارغة فإن المورد Win32 وصف يظهر كمساحة مفردة. إذا قمت بتحديد /win32res فإن /title لن يؤثر على معلومات المورد Win32. يمكنك أيضاً تحديد هذا الخيار كسمة مخصصة (AssemblyTitleAttribute) في التعليمات البرمجية للمصدر لأية وحدة نمطية MSIL. |
/trade[mark]:text |
تحديد سلسلة للحقل العلامات التجارية في التجميع, و إذا كان text يحتوي على مسافة فقم بوضع السلسلة بعلامات اقتباس مزدوجة (" "), فهذه السلسلة عبارة عن سمة مخصصة على التجميع و هي متوفرة للعرض مع انعكاس. إذا لم تقم بتحديد /win32res فإن /trademark يظهر في مستكشف Windows كالمورد Win32 العلامات التجارية. إذا كان النص عبارة عن سلسلة فارغة فإن المورد Win32 العلامات التجارية يظهر كمساحة مفردة. إذا قمت بتحديد /win32res فإن /trademark لن يؤثر على معلومات المورد Win32. يمكنك أيضاً تحديد هذا الخيار كسمة مخصصة (AssemblyTrademarkAttribute) في التعليمات البرمجية للمصدر لأية وحدة نمطية MSIL. |
/v[ersion]:version |
تحديد معلومات الإصدار لهذا التجميع بحيث يكون التنسيق لسلسلة الإصدار عبارة عن major. minor. build. revision وتكون القيمة الافتراضية هي 0. إذا قمت بتحديد /version فيجب عليك أن تقوم بتحديد major, أما إذا قمت بتحديد major و minor فيمكنك تحديد علامة النجمة (*) لــ build و هذا يؤدي إلى build لتكون مساوية لعدد الأيام منذ 1 يناير 2000 في التوقيت المحلي و إلى revision لتكون مساوية لعدد الثواني منذ منتصف الليل لليوم الحالي في التوقيت المحلي مقسوماً على 2. إذا قمت بتحديد major و minor و build فيمكنك تحديد علامة النجمة لــ revision و هذا يؤدي إلى revision لتكون مساوية لعدد الثواني منذ منتصف الليل لليوم الحالي في التوقيت المحلي مقسوماً على 2. باختصار إن سلاسل الإصدار الصالحة كما يلي: X X.X X.X.* X.X.X X.X.X.* X.X.X.X حيث X عبارة عن أي ثابت قصير غير موقع باستثناء 65535 (0-65534). إذا لم تقم بتحديد /win32res فإنه سيتم استخدام /version كالمورد Win32 إصدار تجميع, أما إذا لم تقم بتحديد /win32resو /productversion و /fileversion فإن /version سيتم استخدامها لإصدار الملف إصدار تجميع و موارد Win32 إصدار منتج. إذا قمت بتحديد /win32res فإن /version لن يؤثر على معلومات المورد Win32. يمكنك أيضاً تحديد هذا الخيار كسمة مخصصة (AssemblyVersionAttribute) في التعليمات البرمجية للمصدر لأية وحدة نمطية MSIL. |
/win32icon:filename |
إدراج ملف .ico في التجميع حيث يقوم الملف .ico بتوفير المظهر المرغوب به لملف الإخراج في مستكشف Windows. |
/win32res:filename |
يدرج مورد Win32 (ملف .res) في ملف الإخراج حيث يمكن إنشاء ملف مورد Win32 باستخدام "المحول البرمجي للمورد", وهكذا يتم استدعاء "المحول البرمجي للموارد" عندما تقوم بترجمة برنامج ++Visual C و يتم إنشاء ملف .res من الملف .rc. |
@filename |
تحديد ملف استجابة الذي يحتوي على الأوامر Al.exe. يمكن أن تظهر الأوامر في ملف الاستجابة واحدة لكل سطر أو على السطر نفسه مفصولة بمسافة أو أكثر. |
/? |
يقوم بعرض بناء جملة الأمر والخيارات للأداة. |
ملاحظات
تقوم كافة المحولات البرمجية Visual Studio بإنتاج تجميعات, و مع ذلك إذا كان لديك وحدات نمطية واحدة أو أكثر (بيانات التعريف من غير بيان) يمكنك استخدام Al.exe لإنشاء تجميع مع البيان في ملف منفصل.
لتثبيت تجميعات في ذاكرة التخزين المؤقت قم بإزالة تجميعات من ذاكرة التخزين المؤقت أو سرد المحتويات لذاكرة التخزين المؤقت باستخدام أداة مخزن تجميع عمومي مؤقت (Gacutil.exe).
مثال
ينشئ الأمر التالي ملف قابل للتنفيذ t2a.exe مع تجميع من t2. netmodule module. فنقطة الإدخال عبارة عن الأسلوب Main في MyClass.
al t2.netmodule /target:exe /out:t2a.exe /main:MyClass.Main
راجع أيضًا:
المهام
كيفية: تشغيل اختبارات تلقائية من سطر الأوامر باستخدام MSTest
المرجع
Al.exe أداة الأخطاء و التحذيرات
Gacutil.exe (أداة مخزن التجميع العمومي المؤقت)