XamarinAndroid@1 - مهمة Xamarin.Android v1

استخدم هذه المهمة لإنشاء تطبيق Android باستخدام Xamarin.

بناء الجملة

# Xamarin.Android v1
# Build an Android app with Xamarin.
- task: XamarinAndroid@1
  inputs:
    projectFile: '**/*.csproj' # string. Alias: project. Required. Project. Default: **/*.csproj.
    #target: # string. Target. 
    #outputDirectory: # string. Alias: outputDir. Output directory. 
    #configuration: # string. Configuration. 
    #createAppPackage: true # boolean. Create app package. Default: true.
    #clean: false # boolean. Clean. Default: false.
  # MSBuild Options
    #msbuildLocationOption: 'version' # 'version' | 'location'. Alias: msbuildLocationMethod. MSBuild. Default: version.
    #msbuildVersionOption: '15.0' # 'latest' | '17.0' | '16.0' | '15.0' | '14.0' | '12.0' | '4.0'. Alias: msbuildVersion. Optional. Use when msbuildLocationMethod = version. MSBuild version. Default: 15.0.
    #msbuildFile: # string. Alias: msbuildLocation. Required when msbuildLocationMethod = location. MSBuild location. 
    #msbuildArchitectureOption: 'x86' # 'x86' | 'x64'. Alias: msbuildArchitecture. Optional. Use when msbuildLocationMethod = version. MSBuild architecture. Default: x86.
    #msbuildArguments: # string. Additional arguments. 
  # JDK Options
    jdkOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: jdkSelection. Required. Select JDK to use for the build. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when jdkSelection = JDKVersion. JDK version. Default: default.
    #jdkDirectory: # string. Alias: jdkUserInputPath. Required when jdkSelection = Path. JDK path. 
    #jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK architecture. Default: x64.
# Xamarin.Android v1
# Build an Android app with Xamarin.
- task: XamarinAndroid@1
  inputs:
    projectFile: '**/*.csproj' # string. Alias: project. Required. Project. Default: **/*.csproj.
    #target: # string. Target. 
    #outputDirectory: # string. Alias: outputDir. Output directory. 
    #configuration: # string. Configuration. 
    #createAppPackage: true # boolean. Create app package. Default: true.
    #clean: false # boolean. Clean. Default: false.
  # MSBuild Options
    #msbuildLocationOption: 'version' # 'version' | 'location'. Alias: msbuildLocationMethod. MSBuild. Default: version.
    #msbuildVersionOption: '15.0' # 'latest' | '15.0' | '14.0' | '12.0' | '4.0'. Alias: msbuildVersion. Optional. Use when msbuildLocationMethod = version. MSBuild version. Default: 15.0.
    #msbuildFile: # string. Alias: msbuildLocation. Required when msbuildLocationMethod = location. MSBuild location. 
    #msbuildArchitectureOption: 'x86' # 'x86' | 'x64'. Alias: msbuildArchitecture. Optional. Use when msbuildLocationMethod = version. MSBuild architecture. Default: x86.
    #msbuildArguments: # string. Additional arguments. 
  # JDK Options
    jdkOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: jdkSelection. Required. Select JDK to use for the build. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when jdkSelection = JDKVersion. JDK version. Default: default.
    #jdkDirectory: # string. Alias: jdkUserInputPath. Required when jdkSelection = Path. JDK path. 
    #jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK architecture. Default: x64.

الإدخالات

projectFile - المشروع
الاسم المستعار للإدخل: project. string. مطلوب القيمة الافتراضية: **/*.csproj.

يحدد المسار النسبي من جذر Xamarin.Android المستودع للمشروع (المشاريع) للبناء. يمكن استخدام أحرف البدل. لمزيد من المعلومات، راجع مرجع أنماط مطابقة الملف. على سبيل المثال، **/*.csproj لجميع ملفات csproj في جميع المجلدات الفرعية. يجب أن يكون للمشروع PackageForAndroid هدف إذا Create App Package تم تحديده.


target - الهدف
string.

يحدد الأهداف التي يجب إنشائها في هذا المشروع. استخدم فاصلة منقوطة لفصل أهداف متعددة.


outputDirectory - دليل الإخراج
الاسم المستعار للإدخل: outputDir. string.

‏‏اختياري. يوفر دليل الإخراج للبناء. مثال: $(build.binariesDirectory)/bin/Release.


configuration - تكوين
string.

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

تلميح

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


createAppPackage - إنشاء حزمة تطبيق
boolean. القيمة الافتراضية: true.

يمرر الهدف، ، (/t:PackageForAndroid)أثناء الإنشاء لإنشاء APK.


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

يمرر الهدف النظيف، ، (/t:clean)أثناء الإنشاء.


msbuildLocationOption - Msbuild
الاسم المستعار للإدخل: msbuildLocationMethod. string. القيم المسموح بها: version، location (تحديد الموقع). القيمة الافتراضية: version.

يحدد المسار إلى MSBuild (على Windows) أو xbuild (على macOS). السلوك الافتراضي هو البحث عن أحدث إصدار.


msbuildVersionOption - إصدار MSBuild
الاسم المستعار للإدخل: msbuildVersion. string. ‏‏اختياري. استخدم عندما msbuildLocationMethod = version. القيم المسموح بها: latest، 17.0 (MSBuild 17.0)، 16.0 (MSBuild 16.0)، 15.0 (MSBuild 15.0)، 14.0 (MSBuild 14.0)، 12.0 (MSBuild 12.0)، 4.0 (MSBuild 4.0). القيمة الافتراضية: 15.0.

يحدد استخدام أحدث إصدار إذا تعذر العثور على الإصدار المفضل. على macOS، سيتم استخدام xbuild (Mono) أو MSBuild (Visual Studio for Mac).


msbuildVersionOption - إصدار MSBuild
الاسم المستعار للإدخل: msbuildVersion. string. ‏‏اختياري. استخدم عندما msbuildLocationMethod = version. القيم المسموح بها: latest، 15.0 (MSBuild 15.0)، 14.0 (MSBuild 14.0)، 12.0 (MSBuild 12.0)، 4.0 (MSBuild 4.0). القيمة الافتراضية: 15.0.

يحدد استخدام أحدث إصدار إذا تعذر العثور على الإصدار المفضل. على macOS، سيتم استخدام xbuild (Mono) أو MSBuild (Visual Studio for Mac).


msbuildFile - موقع MSBuild
الاسم المستعار للإدخل: msbuildLocation. string. مطلوب عند msbuildLocationMethod = location.

‏‏اختياري. يوفر المسار إلى MSBuild (على Windows) أو xbuild (على macOS).


msbuildArchitectureOption - بنية MSBuild
الاسم المستعار للإدخل: msbuildArchitecture. string. ‏‏اختياري. استخدم عندما msbuildLocationMethod = version. القيم المسموح بها: x86 (MSBuild x86)، x64 (MSBuild x64). القيمة الافتراضية: x86.

يوفر بنية (x86، x64) من MSBuild التي تريد تشغيلها.


msbuildArguments - وسيطات إضافية
string.

تحديد وسيطات إضافية تم تمريرها إلى MSBuild (على Windows) أو xbuild (على macOS).


jdkOption - حدد JDK لاستخدامه للبناء
الاسم المستعار للإدخل: jdkSelection. string. مطلوب القيم المسموح بها: JDKVersion (إصدار JDK)، Path. القيمة الافتراضية: JDKVersion.

يحدد إصدار JDK الذي تستخدمه المهمة أثناء عملية الإنشاء. JDKVersion تحدد القيمة إصدار JDK الذي تكتشفه المهمة أثناء الإصدارات. Path تحدد القيمة مسار ملف لإصدار JDK.


jdkVersionOption - إصدار JDK
الاسم المستعار للإدخل: jdkVersion. string. ‏‏اختياري. استخدم عندما jdkSelection = JDKVersion. القيم المسموح بها: default، 1.11 (JDK 11)، 1.10 (JDK 10 (خارج الدعم))، 1.9 (JDK 9 (خارج الدعم))، 1.8 (JDK 8)، 1.7 (JDK 7)، 1.6 (JDK 6 (خارج الدعم)). القيمة الافتراضية: default.

يحدد إصدار JDK لاستخدامه أثناء الإنشاء.


jdkDirectory - مسار JDK
الاسم المستعار للإدخل: jdkUserInputPath. string. مطلوب عند jdkSelection = Path.

يحدد إصدار JDK لاستخدامه أثناء الإنشاء في jdkSelection المسار.


jdkArchitectureOption - بنية JDK
الاسم المستعار للإدخل: jdkArchitecture. string. ‏‏اختياري. استخدم عندما jdkVersion != default. القيم المسموح بها: x86، . x64 القيمة الافتراضية: x64.

يوفر البنية (x86، x64) من JDK.


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

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

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

لا شيء

الملاحظات

استخدم هذه المهمة لإنشاء تطبيق Android باستخدام Xamarin.

أمثلة

المتطلبات

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