DotNetCoreInstaller@1 - مهمة مثبت .NET Core SDK/وقت التشغيل v1

استخدم هذه المهمة للحصول على إصدار معين من .NET Core SDK من الإنترنت أو ذاكرة التخزين المؤقت المحلية وإضافتها إلى PATH.

هام

تم إهمال هذه المهمة وسيتم إيقافها في 31 يناير 2024. استخدم UseDotNet@2.

بناء الجملة

# .NET Core SDK/runtime installer v1
# Acquire a specific version of the .NET Core SDK from the internet or local cache and add it to the PATH.
- task: DotNetCoreInstaller@1
  inputs:
    packageType: 'sdk' # 'runtime' | 'sdk'. Required. Package to install. Default: sdk.
    version: '2.2.x' # string. Required. Version. Default: 2.2.x.
    #includePreviewVersions: false # boolean. Include Preview Versions. Default: false.
  # Advanced
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

الإدخالات

packageType - الحزمة المراد تثبيتها
string. مطلوب القيم المسموح بها: runtime (وقت التشغيل فقط)، sdk (SDK (يحتوي على وقت التشغيل)). القيمة الافتراضية: sdk.

يحدد ما إذا كنت تريد تثبيت وقت التشغيل فقط أو SDK الكامل.

version - الإصدار
string. مطلوب القيمة الافتراضية: 2.2.x.

يحدد إصدار .NET Core SDK أو وقت التشغيل لتثبيته.

استخدم التنسيق التالي لتحديد الإصدار:

• 2.x: تثبيت أحدث إصدار في الإصدار الرئيسي.
• 2.2.x: يثبت أحدث إصدار في الإصدار الرئيسي والثانوي.
• 2.2.104: تثبيت الإصدار الدقيق.

ابحث عن قيمة version لتثبيت SDK/Runtime في ملف releases-index.

includePreviewVersions - تضمين إصدارات المعاينة
boolean. القيمة الافتراضية: false.

يحدد ما إذا كنت تريد تضمين إصدارات المعاينة أثناء البحث عن أحدث الإصدارات. يتم تجاهل هذا الإعداد إذا حددت إصدارا دقيقا، مثل 3.0.100-preview3-010431.

installationPath - مسار تثبيت .Net Core
string. القيمة الافتراضية: $(Agent.ToolsDirectory)/dotnet.

يحدد مكان تثبيت .NET Core SDK/Runtime. يمكن أن يكون للمسارات المختلفة التأثير التالي على . سلوك NET:

• $(Agent.ToolsDirectory): يحدد هذا الإصدار الذي سيتم تخزينه مؤقتا على العامل نظرا لأنه لم يتم تنظيف هذا الدليل عبر المسارات. سيكون لجميع البنية الأساسية لبرنامج ربط العمليات التجارية التي تعمل على العامل حق الوصول إلى الإصدارات المثبتة مسبقا باستخدام العامل.
• $(Agent.TempDirectory): يمكن أن يضمن هذا أن البنية الأساسية لبرنامج ربط العمليات التجارية لا تستخدم أي إصدار مخزن مؤقتا من .NET core حيث يتم تنظيف هذا المجلد بعد كل مسار.
• أي مسار آخر: يمكنك تكوين أي مسار آخر، نظرا لأن عملية العامل لديها حق الوصول إلى المسار. سيؤدي ذلك إلى تغيير حالة الجهاز والتأثير على جميع العمليات التي تعمل عليه.

يمكنك أيضا تكوين إعداد البحث متعدد المستويات. يمكن لهذا الإعداد تكوين مضيف .NET لفحص إصدار مناسب.

performMultiLevelLookup - إجراء بحث متعدد المستويات
boolean. القيمة الافتراضية: false.

ينطبق هذا الإدخال فقط على الوكلاء المستندين إلى Windows. يقوم هذا الإدخال بتكوين سلوك عمليات مضيف .NET للبحث عن إطار عمل مشترك مناسب. False يعني أن الإصدارات الموجودة في المجلد المحدد في هذه المهمة فقط سيتم البحث عنها بواسطة عملية المضيف. True يعني أن المضيف سيحاول البحث في مواقع عمومية محددة مسبقا باستخدام البحث متعدد المستويات.

بالنسبة لنظام التشغيل Windows، المواقع العمومية الافتراضية هي:

• C:\Program Files\dotnet (عمليات 64 بت)
• C:\Program Files (x86)\dotnet (عملية 32 بت)

لمزيد من المعلومات، راجع بحث SharedFX متعدد المستويات.

خيارات التحكم بالمهمة

تحتوي جميع المهام على خيارات التحكم بالإضافة إلى مدخلات المهام الخاصة بها. لمزيد من المعلومات، راجع خيارات التحكم وخصائص المهمة الشائعة.

متغيرات الإخراج

لا شيء

الملاحظات

تم إهمال هذه المهمة. استخدم @UseDotNet2.

ما الجديد في إصدار المهمة هذا.

• دعم تثبيت إصدارات متعددة جنبا إلى جنب.
• دعم الأنماط في الإصدار لجلب أحدث إصدار في الإصدار الثانوي/الرئيسي.
• تقييد البحث متعدد المستويات.

المتطلبات

المتطلبات	الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية	YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي
يعمل على	Agent, DeploymentGroup
المطالب	بلا
القدرات	يؤدي تشغيل هذه المهمة إلى تلبية الطلبات التالية لأي مهام لاحقة في نفس المهمة: DotNetCore
قيود الأوامر	أي
متغيرات Settable	أي
إصدار الوكيل	جميع إصدارات العامل المدعومة.
فئة المهمة	الأداة