مشاركة عبر

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.

# 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.

الإدخالات

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

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

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

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

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

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

تلميح

  • يمكنك أيضا إنشاء ملفات مشروع MSBuild (.*proj).
  • إذا كنت تقوم بإنشاء ملف مشروع MSBuild مخصص، نوصيك باستخدام مهمة MSBuild بدلا من مهمة Visual Studio Build.

vsVersion - إصدار Visual Studio
string. القيم المسموح بها: latest، 17.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-latest كتجمع إنشاء افتراضي. راجع العوامل المستضافة من 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-latest كتجمع إنشاء افتراضي. راجع العوامل المستضافة من Microsoft.


msbuildArgs - وسيطات MSBuild
string.

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


platform - منصه
string.

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

تلميح

  • إذا كنت تستهدف ملف مشروع MSBuild (.*proj) بدلا من حل، فحدد AnyCPU (بدون مسافة بيضاء).
  • قم بتعريف متغير بناء مثل BuildPlatform في علامة التبويب المتغيرات (تحديد السماح في وقت قائمة الانتظار) والإشارة إليه هنا ك $(BuildPlatform). بهذه الطريقة يمكنك تعديل النظام الأساسي عند وضع البنية في قائمة الانتظار وتمكين إنشاء تكوينات متعددة.

configuration - تكوين
string.

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

تلميح

قم بتعريف متغير بناء مثل BuildConfiguration في علامة التبويب المتغيرات (تحديد السماح في وقت قائمة الانتظار) والإشارة إليه هنا ك $(BuildConfiguration). بهذه الطريقة يمكنك تعديل النظام الأساسي عند وضع البنية في قائمة الانتظار وتمكين إنشاء تكوينات متعددة.


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

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

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


maximumCpuCount - الإنشاء بالتوازي
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 للتشغيل.

تلميح

نظرا لأن Visual Studio يعمل كتطبيق 32 بت، فقد تواجه مشكلات عند معالجة الإصدار بواسطة عامل بناء يقوم بتشغيل الإصدار 64 بت من Team Foundation Build Service. بتحديد MSBuild x86، يمكنك حل هذه المشكلات.


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

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


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

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


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

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


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

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


customVersion - إصدار مخصص
string.

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

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


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

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

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

لا شيء

الملاحظات

تعرف على المزيد حول تثبيت صور Visual Studio على Azure.

هام

هذه المهمة مدعومة فقط على الوكلاء الذين يقومون بتشغيل Windows.

المتطلبات

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