AppCenterTest@1 - مهمة اختبار App Center v1

اختبار حزم التطبيقات باستخدام Visual Studio App Center.

بناء الجملة

# App Center test v1
# Test app packages with Visual Studio App Center.
- task: AppCenterTest@1
  inputs:
    appFile: # string. Alias: app. Required. Binary application file path. 
    artifactsDirectory: '$(Build.ArtifactStagingDirectory)/AppCenterTest' # string. Alias: artifactsDir. Required. Artifacts directory. Default: $(Build.ArtifactStagingDirectory)/AppCenterTest.
  # Prepare Tests
    #prepareTests: true # boolean. Alias: enablePrepare. Prepare tests. Default: true.
    frameworkOption: 'appium' # 'appium' | 'espresso' | 'calabash' | 'uitest' | 'xcuitest'. Alias: framework. Required when enablePrepare = true. Test framework. Default: appium.
    #appiumBuildDirectory: # string. Alias: appiumBuildDir. Required when enablePrepare = true && framework = appium. Build directory. 
    #espressoBuildDirectory: # string. Alias: espressoBuildDir. Optional. Use when enablePrepare = true && framework = espresso. Build directory. 
    #espressoTestApkFile: # string. Alias: espressoTestApkPath. Optional. Use when enablePrepare = true && framework = espresso. Test APK path. 
    #calabashProjectDirectory: # string. Alias: calabashProjectDir. Required when enablePrepare = true && framework = calabash. Project directory. 
    #calabashConfigFile: # string. Optional. Use when enablePrepare = true && framework = calabash. Cucumber config file. 
    #calabashProfile: # string. Optional. Use when enablePrepare = true && framework = calabash. Profile to run. 
    #calabashSkipConfigCheck: false # boolean. Optional. Use when enablePrepare = true && framework = calabash. Skip Configuration Check. Default: false.
    #uiTestBuildDirectory: # string. Alias: uitestBuildDir. Required when enablePrepare = true && framework = uitest. Build directory. 
    #uitestStorePath: # string. Optional. Use when enablePrepare = true && framework = uitest. Store file. 
    #uiTestStorePassword: # string. Alias: uitestStorePass. Optional. Use when enablePrepare = true && framework = uitest. Store password. 
    #uitestKeyAlias: # string. Optional. Use when enablePrepare = true && framework = uitest. Key alias. 
    #uiTestKeyPassword: # string. Alias: uitestKeyPass. Optional. Use when enablePrepare = true && framework = uitest. Key password. 
    #uiTestToolsDirectory: # string. Alias: uitestToolsDir. Optional. Use when enablePrepare = true && framework = uitest. Test tools directory. 
    #signInfo: # string. Optional. Use when framework = calabash || framework = uitest. Signing information. 
    #xcUITestBuildDirectory: # string. Alias: xcuitestBuildDir. Optional. Use when enablePrepare = true && framework = xcuitest. Build directory. 
    #xcUITestIpaFile: # string. Alias: xcuitestTestIpaPath. Optional. Use when enablePrepare = true && framework = xcuitest. Test IPA path. 
    #prepareOptions: # string. Alias: prepareOpts. Optional. Use when enablePrepare = true. Additional options. 
  # Run Tests
    #runTests: true # boolean. Alias: enableRun. Run tests. Default: true.
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required when enableRun = true. Authentication method. Default: serviceEndpoint.
    #serverEndpoint: # string. Required when enableRun = true && credsType = serviceEndpoint. App Center service connection. 
    #username: # string. Required when enableRun = true && credsType = inputs. App Center username. 
    #password: # string. Required when enableRun = true && credsType = inputs. App Center password. 
    appSlug: # string. Required when enableRun = true. App slug. 
    devices: # string. Required when enableRun = true. Devices. 
    #series: 'master' # string. Optional. Use when enableRun = true. Test series. Default: master.
    #dsymDirectory: # string. Alias: dsymDir. Optional. Use when enableRun = true. dSYM directory. 
    localeOption: 'en_US' # 'da_DK' | 'nl_NL' | 'en_GB' | 'en_US' | 'fr_FR' | 'de_DE' | 'ja_JP' | 'ru_RU' | 'es_MX' | 'es_ES' | 'user'. Alias: locale. Required when enableRun = true. System language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when enableRun = true && locale = user. Other locale. 
    #loginOptions: # string. Alias: loginOpts. Optional. Use when enableRun = true && credsType = inputs. Additional options for login. 
    #runOptions: # string. Alias: runOpts. Optional. Use when enableRun = true. Additional options for run. 
    #skipWaitingForResults: false # boolean. Alias: async. Optional. Use when enableRun = true. Do not wait for test result. Default: false.
  # Advanced
    #cliFile: # string. Alias: cliLocationOverride. App Center CLI location. 
    #showDebugOutput: false # boolean. Alias: debug. Enable debug output. Default: false.

الإدخالات

appFile - مسار ملف التطبيق الثنائي
الاسم المستعار للإدخل: app. string. مطلوب

المسار النسبي من جذر المستودع إلى ملف APK أو IPA الذي تريد اختباره.

artifactsDirectory - دليل البيانات الاصطناعية
الاسم المستعار للإدخل: artifactsDir. string. مطلوب القيمة الافتراضية: $(Build.ArtifactStagingDirectory)/AppCenterTest.

يحدد مكان وضع البيانات الاصطناعية التي تنتجها خطوة الإعداد وتستخدمها خطوة التشغيل. سيتم إنشاء هذا الدليل إذا لم يكن موجودا بالفعل.

prepareTests - إعداد الاختبارات
الاسم المستعار للإدخل: enablePrepare. boolean. القيمة الافتراضية: true.

عند التعيين إلى true، يقوم هذا الإدخال بإعداد الاختبارات.

frameworkOption - إطار عمل الاختبار
الاسم المستعار للإدخل: framework. string. مطلوب عند enablePrepare = true. القيم المسموح بها: appium، espresso، calabash، uitest (اختبار واجهة مستخدم Xamarin)، xcuitest. القيمة الافتراضية: appium.

appiumBuildDirectory - إنشاء دليل
الاسم المستعار للإدخل: appiumBuildDir. string. مطلوب عند enablePrepare = true && framework = appium.

المسار إلى الدليل مع اختبارات Appium.

espressoBuildDirectory - إنشاء دليل
الاسم المستعار للإدخل: espressoBuildDir. string. ‏‏اختياري. استخدم عندما enablePrepare = true && framework = espresso.

المسار إلى دليل إخراج Espresso.

espressoTestApkFile - اختبار مسار APK
الاسم المستعار للإدخل: espressoTestApkPath. string. ‏‏اختياري. استخدم عندما enablePrepare = true && framework = espresso.

المسار إلى ملف APK مع اختبارات Espresso. إذا لم يتم تعيينه، build-dir يتم استخدامه لاكتشافه. يسمح بحرف بدل.

calabashProjectDirectory - دليل المشروع
الاسم المستعار للإدخل: calabashProjectDir. string. مطلوب عند enablePrepare = true && framework = calabash.

المسار إلى دليل مساحة عمل Calabash.

calabashConfigFile - ملف تكوين الخيار
string. ‏‏اختياري. استخدم عندما enablePrepare = true && framework = calabash.

المسار إلى ملف تكوين Cucumber، عادة ما cucumber.yml.

calabashProfile - ملف التعريف المراد تشغيله
string. ‏‏اختياري. استخدم عندما enablePrepare = true && framework = calabash.

ملف التعريف المراد تشغيله. يجب أن تكون هذه القيمة موجودة في ملف تكوين Cucumber.

calabashSkipConfigCheck - تخطي التحقق من التكوين
boolean. ‏‏اختياري. استخدم عندما enablePrepare = true && framework = calabash. القيمة الافتراضية: false.

عند التعيين إلى true، يتخطى هذا الإدخال فحص التكوين المحدد بواسطة ملف تعريف Cucumber.

uiTestBuildDirectory - إنشاء دليل
الاسم المستعار للإدخل: uitestBuildDir. string. مطلوب عند enablePrepare = true && framework = uitest.

المسار إلى الدليل مع تجميعات الاختبار المضمنة.

uitestStorePath - تخزين الملف
string. ‏‏اختياري. استخدم عندما enablePrepare = true && framework = uitest.

المسار إلى ملف المتجر المستخدم لتوقيع التطبيق.

uiTestStorePassword - كلمة مرور المتجر
الاسم المستعار للإدخل: uitestStorePass. string. ‏‏اختياري. استخدم عندما enablePrepare = true && framework = uitest.

كلمة مرور ملف المتجر المستخدم لتوقيع التطبيق. لتشفير هذه القيمة، استخدم متغيرا جديدا مع تمكين تأمينه في علامة التبويب المتغيرات.

uitestKeyAlias - الاسم المستعار للمفتاح
string. ‏‏اختياري. استخدم عندما enablePrepare = true && framework = uitest.

يحدد الاسم المستعار الذي يحدد زوج المفاتيح العام/الخاص المستخدم في ملف المتجر.

uiTestKeyPassword - كلمة المرور الرئيسية
الاسم المستعار للإدخل: uitestKeyPass. string. ‏‏اختياري. استخدم عندما enablePrepare = true && framework = uitest.

يحدد كلمة المرور الرئيسية للاسم المستعار وملف التخزين. لتشفير هذه القيمة، استخدم متغيرا جديدا مع تمكين تأمينه في علامة التبويب المتغيرات.

uiTestToolsDirectory - دليل أدوات الاختبار
الاسم المستعار للإدخل: uitestToolsDir. string. ‏‏اختياري. استخدم عندما enablePrepare = true && framework = uitest.

المسار إلى الدليل باستخدام أدوات اختبار واجهة مستخدم Xamarin التي تحتوي على test-cloud.exe.

signInfo - معلومات التوقيع
string. ‏‏اختياري. استخدم عندما framework = calabash || framework = uitest.

توقيع خادم الاختبار.

xcUITestBuildDirectory - إنشاء دليل
الاسم المستعار للإدخل: xcuitestBuildDir. string. ‏‏اختياري. استخدم عندما enablePrepare = true && framework = xcuitest.

المسار إلى دليل إخراج البناء (عادة $(ProjectDir)/Build/Products/Debug-iphoneos).

xcUITestIpaFile - اختبار مسار IPA
الاسم المستعار للإدخل: xcuitestTestIpaPath. string. ‏‏اختياري. استخدم عندما enablePrepare = true && framework = xcuitest.

المسار إلى ملف .ipa مع اختبارات XCUITest.

prepareOptions - خيارات إضافية
الاسم المستعار للإدخل: prepareOpts. string. ‏‏اختياري. استخدم عندما enablePrepare = true.

الوسيطات الإضافية التي يتم تمريرها إلى خطوة إعداد اختبار App Center.

runTests - تشغيل الاختبارات
الاسم المستعار للإدخل: enableRun. boolean. القيمة الافتراضية: true.

تشغيل الاختبارات.

credentialsOption - أسلوب المصادقة
الاسم المستعار للإدخل: credsType. string. مطلوب عند enableRun = true. القيم المسموح بها: serviceEndpoint (اتصال خدمة App Center)، inputs (بيانات الاعتماد). القيمة الافتراضية: serviceEndpoint.

يستخدم اتصال خدمة App Center أو يدخل بيانات الاعتماد للاتصال ب Visual Studio App Center.

serverEndpoint - اتصال خدمة App Center
string. مطلوب عند enableRun = true && credsType = serviceEndpoint.

تحديد اتصال الخدمة ل Visual Studio App Center. إذا لزم الأمر، انقر فوق الارتباط إدارة لإنشاء اتصال خدمة جديد.

username - اسم مستخدم App Center
string. مطلوب عند enableRun = true && credsType = inputs.

أنشئ اسم المستخدم الخاص بك عن طريق زيارة صفحة تسجيل الدخول إلى App Center، وقدم القيمة هنا.

password - كلمة مرور App Center
string. مطلوب عند enableRun = true && credsType = inputs.

قم بتعيين كلمة المرور الخاصة بك عن طريق زيارة صفحة تسجيل الدخول إلى App Center، وتوفير القيمة هنا. المتغيرات المحددة في البنية الأساسية لبرنامج ربط العمليات التجارية للإنشاء أو الإصدار كما $(passwordVariable) هو مقبول. يمكنك وضع علامة على نوع المتغير على أنه secret لتأمينه.

appSlug - مائل التطبيق
string. مطلوب عند enableRun = true.

مائل التطبيق بتنسيق <username>/<app_identifier>. لتحديد موقع <username> و <app_identifier> لتطبيق، انقر فوق اسمه من Visual Studio App Center. عنوان URL الناتج بالتنسيق https://appcenter.ms/users/<username>/apps/<app_identifier>.

devices - الاجهزه
string. مطلوب عند enableRun = true.

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

series - سلسلة الاختبار
string. ‏‏اختياري. استخدم عندما enableRun = true. القيمة الافتراضية: master.

اسم السلسلة لتنظيم عمليات تشغيل الاختبار (على سبيل المثال: رئيسي، إنتاج، بيتا).

dsymDirectory - دليل dSYM
الاسم المستعار للإدخل: dsymDir. string. ‏‏اختياري. استخدم عندما enableRun = true.

المسار إلى ملفات رموز iOS.

localeOption - لغة النظام
الاسم المستعار للإدخل: locale. string. مطلوب عند enableRun = true. القيم المسموح بها: da_DK (الدنماركية (الدنمارك))، nl_NL (الهولندية (هولندا))، en_GB (الإنجليزية (المملكة المتحدة))، en_US (الإنجليزية (الولايات المتحدة))، fr_FR (الفرنسية (فرنسا))، de_DE (الألمانية (ألمانيا))، ja_JP (اليابانية (اليابان))، ru_RU (الروسية (روسيا))، es_MX (الإسبانية (المكسيك))، es_ES (الإسبانية (إسبانيا))، user (أخرى). القيمة الافتراضية: en_US.

استخدم إذا لم يتم عرض لغتك. حدد Other إعداداته المحلية وأدخلها، مثل en_US.

userDefinedLocale - إعدادات محلية أخرى
string. ‏‏اختياري. استخدم عندما enableRun = true && locale = user.

إدخال أي رمز لغة ISO-639 مكون من حرفين مع أي رمز بلد ISO 3166 مكون من حرفين بالتنسيق <language>_<country>، مثل en_US.

loginOptions - خيارات إضافية لتسجيل الدخول
الاسم المستعار للإدخل: loginOpts. string. ‏‏اختياري. استخدم عندما enableRun = true && credsType = inputs.

الوسيطات الإضافية التي يتم تمريرها إلى خطوة تسجيل الدخول إلى مركز تطبيقات Visual Studio.

runOptions - خيارات إضافية للتشغيل
الاسم المستعار للإدخل: runOpts. string. ‏‏اختياري. استخدم عندما enableRun = true.

الوسيطات الإضافية التي يتم تمريرها إلى تشغيل اختبار Visual Studio App Center.

skipWaitingForResults - لا تنتظر نتيجة الاختبار
الاسم المستعار للإدخل: async. boolean. ‏‏اختياري. استخدم عندما enableRun = true. القيمة الافتراضية: false.

ينفذ الأمر بشكل غير متزامن ويخرج عند تحميل الاختبارات دون انتظار نتائج الاختبار.

cliFile - موقع App Center CLI
الاسم المستعار للإدخل: cliLocationOverride. string.

المسار إلى Visual Studio App Center CLI على عامل الإنشاء أو الإصدار.

showDebugOutput - تمكين إخراج تتبع الأخطاء
الاسم المستعار للإدخل: debug. boolean. القيمة الافتراضية: false.

--debug يضيف إلى Visual Studio App Center CLI.

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

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

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

لا شيء

الملاحظات

تتيح لك هذه المهمة تشغيل مجموعات الاختبار مقابل تطبيق ثنائي (ملف .apk أو .ipa ) باستخدام App Center Test.

• قم بالتسجيل باستخدام App Center أولا.
• للحصول على تفاصيل حول استخدام هذه المهمة، راجع مقالة وثائق مركز التطبيقات باستخدام Azure DevOps لاختبار واجهة المستخدم.

أمثلة

يقوم هذا المثال بتشغيل اختبارات Espresso على تطبيق Android باستخدام مهمة App Center Test.

steps:
- task: AppCenterTest@1
  displayName: 'Espresso Test - Synchronous'
  inputs:
    appFile: 'Espresso/espresso-app.apk'
    artifactsDirectory: '$(Build.ArtifactStagingDirectory)/AppCenterTest'
    frameworkOption: espresso
    espressoBuildDirectory: Espresso
    serverEndpoint: 'myAppCenterServiceConnection'
    appSlug: 'xplatbg1/EspressoTests'
    devices: a84c93af

المتطلبات

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