VSBuild@1 - مهمة الإصدار 1 من Visual Studio

استخدم هذه المهمة للبناء باستخدام MSBuild وتعيين خاصية إصدار Visual Studio. تعرف على المزيد حول تثبيت صور visual Studio على Azure.

# Visual Studio build v1
# Build with MSBuild and set the Visual Studio version property.
- task: VSBuild@1
  inputs:
    solution: '**\*.sln' # string. Required. Solution. Default: **\*.sln.
    #vsVersion: 'latest' # 'latest' | '17.0' | '16.0' | '15.0' | '14.0' | '12.0' | '11.0'. Visual Studio Version. Default: latest.
    #msbuildArgs: # string. MSBuild Arguments. 
    #platform: # string. Platform. 
    #configuration: # string. Configuration. 
    #clean: false # boolean. Clean. Default: false.
  # Advanced
    #maximumCpuCount: false # boolean. Build in Parallel. Default: false.
    #restoreNugetPackages: false # boolean. Restore NuGet Packages. Default: false.
    #msbuildArchitecture: 'x86' # 'x86' | 'x64'. MSBuild Architecture. Default: x86.
    #logProjectEvents: true # boolean. Record Project Details. Default: true.
    #createLogFile: false # boolean. Create Log File. Default: false.
    #logFileVerbosity: 'normal' # 'quiet' | 'minimal' | 'normal' | 'detailed' | 'diagnostic'. Optional. Use when createLogFile = true. Log File Verbosity. Default: normal.
    #enableDefaultLogger: true # boolean. Enable Default Logger. Default: true.
    #customVersion: # string. Custom Version.

# Visual Studio build v1
# Build with MSBuild and set the Visual Studio version property.
- task: VSBuild@1
  inputs:
    solution: '**\*.sln' # string. Required. Solution. Default: **\*.sln.
    #vsVersion: 'latest' # 'latest' | '16.0' | '15.0' | '14.0' | '12.0' | '11.0'. Visual Studio Version. Default: latest.
    #msbuildArgs: # string. MSBuild Arguments. 
    #platform: # string. Platform. 
    #configuration: # string. Configuration. 
    #clean: false # boolean. Clean. Default: false.
  # Advanced
    #maximumCpuCount: false # boolean. Build in Parallel. Default: false.
    #restoreNugetPackages: false # boolean. Restore NuGet Packages. Default: false.
    #msbuildArchitecture: 'x86' # 'x86' | 'x64'. MSBuild Architecture. Default: x86.
    #logProjectEvents: true # boolean. Record Project Details. Default: true.
    #createLogFile: false # boolean. Create Log File. Default: false.
    #logFileVerbosity: 'normal' # 'quiet' | 'minimal' | 'normal' | 'detailed' | 'diagnostic'. Optional. Use when createLogFile = true. Log File Verbosity. Default: normal.

حل solution -
string. مطلوب. القيمة الافتراضية: **\*.sln.

تحديد الحل للمهمة لاستخدامها في عملية الإنشاء.

إذا كنت ترغب في إنشاء حل واحد، فانقر فوق الزر ... وحدد الحل.

إذا كنت ترغب في إنشاء حلول متعددة، فحدد معايير البحث. يمكنك استخدام حرف بدل من مجلد واحد (*) وأحرف بدل متكررة (**). على سبيل المثال، يبحث **.sln عن جميع ملفات .sln في جميع الدلائل الفرعية.

تأكد من تنزيل الحلول التي تحددها بواسطة البنية الأساسية لبرنامج ربط العمليات التجارية للبناء هذا. في علامة التبويب Repository:

• إذا كنت تستخدم TFVC، فتأكد من أن الحل تابع لأحد التعيينات في علامة التبويب Repository.
• إذا كنت تستخدم Git، فتأكد من أن المشروع أو الحل موجود في مستودع Git الخاص بك، وفي فرع تقوم ببناءه.

إصدار vsVersion - Visual Studio
string. القيم المسموح بها: latest17.0 (Visual Studio 2022) 16.0 (Visual Studio 2019) 15.0 (Visual Studio 2017) 14.0 (Visual Studio 2015) 12.0 (Visual Studio 2013) 11.0 (Visual Studio 2012). القيمة الافتراضية: latest.

يجب أن تتطابق قيمة هذا الإدخال مع إصدار Visual Studio المستخدم لإنشاء الحل الخاص بك.

يضيف الوسيطة /p:VisualStudioVersion={numeric_visual_studio_version} إلى أمر MSBuild الذي يتم تشغيله بواسطة البنية. على سبيل المثال، إذا حددت Visual Studio 2015، تتم إضافة /p:VisualStudioVersion=14.0 إلى الأمر MSBuild.

Azure Pipelines: إذا كان فريقك يريد استخدام Visual Studio مع الوكلاء المستضافين من Microsoft، فحدد أحدث windows كتجمع بناء افتراضي. راجع العوامل المستضافة من Microsoft.

إصدار vsVersion - Visual Studio
string. القيم المسموح بها: latest، 16.0 (Visual Studio 2019)، 15.0 (Visual Studio 2017)، 14.0 (Visual Studio 2015)، 12.0 (Visual Studio 2013)، 11.0 (Visual Studio 2012). القيمة الافتراضية: latest.

يجب أن تتطابق قيمة هذا الإدخال مع إصدار Visual Studio المستخدم لإنشاء الحل الخاص بك.

يضيف الوسيطة /p:VisualStudioVersion={numeric_visual_studio_version} إلى أمر MSBuild الذي يتم تشغيله بواسطة البنية. على سبيل المثال، إذا حددت Visual Studio 2015، تتم إضافة /p:VisualStudioVersion=14.0 إلى الأمر MSBuild.

Azure Pipelines: إذا كان فريقك يريد استخدام Visual Studio مع الوكلاء المستضافين من Microsoft، فحدد أحدث windows كتجمع بناء افتراضي. راجع العوامل المستضافة من Microsoft.

وسائط msbuildArgs - MSBuild
string.

تمرير وسيطات إضافية إلى MSBuild. للحصول على بناء الجملة، راجع مرجعMSBuild Command-Line .

النظام الأساسي platform -
string.

يحدد النظام الأساسي الذي تريد إنشاءه، مثل Win32أو x86أو x64أو any cpu.

تكوين configuration -
string.

يحدد التكوين الذي تريد إنشاءه، مثل debug أو release.

clean - تنظيف
boolean. القيمة الافتراضية: false.

إذا تم تعيينها إلى false، فإن المهمة تقوم بإنشاء تزايدي. قد يقلل هذا الإعداد من وقت الإنشاء، خاصة إذا كانت قاعدة التعليمات البرمجية كبيرة. هذا الخيار ليس له أي تأثير عملي إلا إذا قمت أيضا بتعيين مستودع Clean إلى false.

إذا تم تعيينها إلى true، فإن المهمة تعيد إنشاء كافة التعليمات البرمجية في مشاريع التعليمات البرمجية. وهذا يعادل وسيطة /target:clean MSBuild.

maximumCpuCount - Build in Parallel
boolean. القيمة الافتراضية: false.

اختياري. إذا كان تكوين هدف MSBuild متوافقا مع الإنشاء بالتوازي، يمكنك التحقق من هذا الإدخال لتمرير /m التبديل إلى MSBuild (Windows فقط). إذا لم يكن التكوين الهدف متوافقا مع الإنشاء بالتوازي، فقد يؤدي التحقق من هذا الخيار إلى حدوث أخطاء في استخدام الملف أو فشل متقطع أو غير متناسق في البناء.

restoreNugetPackages - استعادة حزم NuGet
boolean. القيمة الافتراضية: false.

تم إهمال هذا الإدخال. لاستعادة حزم NuGet، أضف NuGet Tool Installer المهمة قبل الإنشاء.

هندسة msbuildArchitecture - MSBuild
string. القيم المسموح بها: x86 (MSBuild x86)، x64 (MSBuild x64). القيمة الافتراضية: x86.

اختياري. يوفر بنية (x86 أو x64) من MSBuild للتشغيل.

logProjectEvents - تسجيل تفاصيل المشروع
boolean. القيمة الافتراضية: true.

اختياري. سجلات تفاصيل المخطط الزمني لكل مشروع.

createLogFile - إنشاء ملف السجل
boolean. القيمة الافتراضية: false.

اختياري. إنشاء ملف سجل (Windows فقط).

إسهاب ملف سجل logFileVerbosity -
string. اختياري. استخدم عند createLogFile = true. القيم المسموح بها: quietminimalnormaldetaileddiagnostic. القيمة الافتراضية: normal.

تحديد مستوى الإسهاب في ملفات السجل.

enableDefaultLogger - تمكين المسجل الافتراضي
boolean. القيمة الافتراضية: true.

إذا تم تعيينه إلى true، فقم بتمكين المسجل الافتراضي ل MSBuild.

الإصدار المخصص
string.

تعيين إصدار مخصص من Visual Studio. أمثلة: 15.0، 16.0، 17.0. يجب تثبيت الإصدار المطلوب من Visual Studio في النظام.

Azure Pipelines: إذا كان فريقك يريد استخدام Visual Studio 2022 مع العوامل المستضافة من Microsoft، فحدد windows-2022 كتجمع بناء افتراضي. لمزيد من المعلومات، راجع العوامل المستضافة من Microsoft.

اي.