مشاركة عبر

UseDotNet@2 - استخدام مهمة dotnet v2

  • مقالة

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

بناء الجملة

# Use .NET Core v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #useGlobalJson: false # boolean. Optional. Use when packageType = sdk. Use global json. Default: false.
    #workingDirectory: # string. Optional. Use when useGlobalJson = true. Working Directory. 
    #version: # string. Optional. Use when useGlobalJson = false || packageType = runtime. Version. 
    #includePreviewVersions: false # boolean. Optional. Use when useGlobalJson = false  || packageType = runtime. Include Preview Versions. Default: false.
  # Advanced
    #vsVersion: # string. Compatible Visual Studio version. 
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

# Use .NET Core v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #useGlobalJson: false # boolean. Optional. Use when packageType = sdk. Use global json. Default: false.
    #workingDirectory: # string. Optional. Use when useGlobalJson = true. Working Directory. 
    #version: # string. Optional. Use when useGlobalJson = false || packageType = runtime. Version. 
    #includePreviewVersions: false # boolean. Optional. Use when useGlobalJson = false  || packageType = runtime. 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.

# Use dotnet v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #version: # string. Version. 
    #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.

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


useGlobalJson - استخدام json العمومي
boolean. ‏‏اختياري. استخدم عندما packageType = sdk. القيمة الافتراضية: false.

تثبيت جميع SDKs من global.json الملفات. يتم البحث في هذه الملفات من system.DefaultWorkingDirectory. يمكنك تغيير مسار جذر البحث عن طريق تعيين إدخال دليل العمل.

6.x التنسيق و 6.1.x (باستخدام .x كحرف بدل) الموضح في UseDotNet@2.version الإدخال للاستخدام في version الإدخال في المهمة، وليس المعلمة sdk.version في global.json.

إذا تلقيت رسالة خطأ مثل ##[error]Version 6.0.x is not allowed. Allowed version types are: majorVersion.x, majorVersion.minorVersion.x, majorVersion.minorVersion.patchVersion. More details: Only explicit versions and accepted, such as: 2.2.301. Version: 6.0.x is not valid. وكنت تستخدم global.json، فتحقق من sdk.version في .global.json

لمزيد من المعلومات حول global.json، راجع تحديد إصدار .NET لاستخدامه.


workingDirectory - دليل العمل
string. ‏‏اختياري. استخدم عندما useGlobalJson = true.

يحدد المسار الذي global.json يجب البحث فيه عن الملفات عند استخدام useGlobalJson. إذا كانت القيمة فارغة، system.DefaultWorkingDirectory فسيتم اعتبارها مسار الجذر.


version - الإصدار
string. ‏‏اختياري. استخدم عندما useGlobalJson = false || packageType = runtime.

يحدد إصدار .NET Core SDK أو وقت التشغيل المراد تثبيته. يتم عرض تنسيقات قيمة الإصدار مع أمثلة:

  • 2.x: تثبيت أحدث SDK أو وقت التشغيل مع الإصدار الرئيسي المحدد، 2.
  • 3.1.x: تثبيت أحدث SDK أو وقت التشغيل مع الإصدارات الرئيسية والثانوية المحددة، 3 و 1.
  • 3.1.402: تثبيت SDK المحدد أو إصدار وقت التشغيل، 3.1.402.

قيم الإصدار ل SDK أو عمليات تثبيت وقت التشغيل موجودة في releases.json الملف. يوجد الارتباط إلى releases.json إصدار رئيسي/ثانوي في ملف releases-index . على سبيل المثال، الارتباط إلى ملف releases.json للإصدار 3.1.


version - الإصدار
string.

يحدد إصدار .NET Core SDK أو وقت التشغيل المراد تثبيته. يتم عرض تنسيقات قيمة الإصدار مع أمثلة:

  • 2.x: تثبيت أحدث SDK أو وقت التشغيل مع الإصدار الرئيسي المحدد، 2.
  • 3.1.x: تثبيت أحدث SDK أو وقت التشغيل مع الإصدارات الرئيسية والثانوية المحددة، 3 و 1.
  • 3.1.402: تثبيت SDK المحدد أو إصدار وقت التشغيل، 3.1.402.

قيم الإصدار ل SDK أو عمليات تثبيت وقت التشغيل موجودة في releases.json الملف. يوجد الارتباط إلى releases.json إصدار رئيسي/ثانوي في ملف releases-index . على سبيل المثال، الارتباط إلى ملف releases.json للإصدار 3.1.


vsVersion - إصدار Visual Studio متوافق
string.

يحدد إصدار Visual Studio متوافقا لتثبيت .NET Core SDK المقابل. يجب أن تكون القيمة رقم إصدار كامل، مثل 16.6.4، الذي يحتوي على إصدار رئيسي وإصدار ثانوي ورقم تصحيح.

قيم الإصدار ل SDK أو عمليات تثبيت وقت التشغيل، والتي يتم استخدامها للسلسلة version ، موجودة في releases.json الملف. يوجد الارتباط إلى releases.json إصدار رئيسي/ثانوي في ملف releases-index . على سبيل المثال، الارتباط إلى ملف releases.json للإصدار 3.1.


includePreviewVersions - تضمين إصدارات المعاينة
boolean. ‏‏اختياري. استخدم عندما useGlobalJson = false || packageType = runtime. القيمة الافتراضية: false.

إذا تم تعيينه إلى true، يتضمن إصدارات المعاينة عندما تبحث المهمة عن أحدث إصدارات وقت التشغيل/SDK، مثل البحث عن 2.2.x أو 3.1.x. يتم تجاهل هذا الإعداد إذا حددت إصدارا دقيقا، مثل 3.0.100-preview3-010431.


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

إذا تم تعيينه إلى true، يتضمن إصدارات المعاينة عندما تبحث المهمة عن أحدث إصدارات وقت التشغيل/SDK، مثل البحث عن 2.2.x أو 3.1.x. يتم تجاهل هذا الإعداد إذا حددت إصدارا دقيقا، مثل 3.0.100-preview3-010431.


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

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

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

ملاحظة

يمكنك استخدام إعداد البحث متعدد المستويات ، performMultiLevelLookup، لتكوين كيفية بحث مضيف .NET عن الإصدارات.


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

تكوين سلوك عملية مضيف .NET عندما يبحث عن إطار عمل مشترك مناسب. القيم هي:

  • false: تبحث عملية المضيف فقط عن الإصدارات الموجودة في المجلد المحدد بواسطة المهمة.
  • true: ستبحث عملية المضيف في مواقع عمومية محددة مسبقا باستخدام البحث متعدد المستويات. المواقع العمومية الافتراضية هي:
    • C:\Program Files\dotnet (عمليات 64 بت)
    • C:\Program Files (x86)\dotnet (عمليات 32 بت)

تعرف على المزيد حول بحث SharedFX متعدد المستويات.

ملاحظة

performMultiLevelLookup ينطبق فقط على الوكلاء المستندين إلى Windows.


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

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

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

لا شيء

الملاحظات

تكتسب مهمة Use .NET Core إصدارا معينا من .NET Core من الإنترنت أو ذاكرة التخزين المؤقت للأدوات وتضيفها إلى PATH لعامل Azure Pipelines (مستضاف أو خاص). استخدم هذه المهمة لتغيير إصدار .NET Core المستخدم في المهام اللاحقة مثل DotNetCoreCLI@2. تضمن إضافة هذه المهمة قبل DotNetCoreCLI@2 في تعريف البنية توفر الإصدار في وقت إنشاء تطبيقك واختباره ونشره.

يسمح لك نهج مثبت الأداة أيضا بالفصل عن دورات تحديث العامل. إذا كان إصدار .NET Core الذي تبحث عنه مفقودا من عامل Azure Pipelines (مستضاف أو خاص)، فيمكنك استخدام هذه المهمة لتثبيت الإصدار الصحيح على العامل.

المتطلبات

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