AppCenterDistribute@3 - توزيع مهمة v3 في App Center

استخدم هذه المهمة لتوزيع إصدارات التطبيق على المختبرين والمستخدمين عبر Visual Studio App Center.

بناء الجملة

# App Center distribute v3
# Distribute app builds to testers and users via Visual Studio App Center.
- task: AppCenterDistribute@3
  inputs:
    serverEndpoint: # string. Required. App Center service connection. 
    appSlug: # string. Required. App slug. 
    appFile: # string. Alias: app. Required. Binary file path. 
    #buildVersion: # string. Build version. 
    releaseNotesOption: 'input' # 'input' | 'file'. Alias: releaseNotesSelection. Required. Create release notes. Default: input.
    releaseNotesInput: # string. Required when releaseNotesSelection = input. Release notes. 
    #releaseNotesFile: # string. Required when releaseNotesSelection = file. Release notes file. 
    #isMandatory: false # boolean. Require users to update to this release. Default: false.
    destinationType: 'groups' # 'groups' | 'store'. Required. Release destination. Default: groups.
    #distributionGroupId: # string. Alias: destinationGroupIds. Optional. Use when destinationType = groups. Destination IDs. 
    #destinationStoreId: # string. Required when destinationType = store. Destination ID. 
    #isSilent: # boolean. Optional. Use when destinationType = groups. Do not notify testers. Release will still be available to install. 
  # Symbols
    #symbolsOption: 'Apple' # 'Apple' | 'Android' | 'UWP'. Alias: symbolsType. Symbols type. Default: Apple.
    #symbolsPath: # string. Optional. Use when symbolsType == AndroidNative || symbolsType = Windows. Symbols path. 
    #appxsymPath: # string. Optional. Use when symbolsType = UWP. Symbols path (*.appxsym). 
    #symbolsDsymFiles: # string. Alias: dsymPath. Optional. Use when symbolsType = Apple. dSYM path. 
    #symbolsMappingTxtFile: # string. Alias: mappingTxtPath. Optional. Use when symbolsType = Android. Mapping file. 
    #nativeLibrariesPath: # string. Optional. Use when symbolsType == Android. Native Library File Path. 
    #symbolsIncludeParentDirectory: # boolean. Alias: packParentFolder. Optional. Use when symbolsType = Apple. Include all items in parent folder.

الإدخالات

serverEndpoint - اتصال خدمة App Center
string. مطلوب

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

appSlug - مائل التطبيق
string. مطلوب

مائل التطبيق بتنسيق {username}/{app_identifier}. لتحديد موقع {username} تطبيق وله {app_identifier} ، انقر فوق اسمه من App Center، وعنوان URL الناتج بتنسيق https://appcenter.ms/users/**{username}**/apps/**{app_identifier}**. إذا كنت تستخدم المؤسسات، فإن تطبيق slug بالتنسيق {orgname}/{app_identifier}.

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

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

buildVersion - إصدار البناء
string.

إصدار البناء من ثنائي التحميل الذي يجب تحديده ل .zip و .msi. سيتم تجاهل هذه القيمة ما لم يكن النظام الأساسي WPF أو WinForms.

symbolsOption - نوع الرموز
الاسم المستعار للإدخل: symbolsType. string. القيم المسموح بها: Apple، ، AndroidUWP. القيمة الافتراضية: Apple.

يتضمن ملفات الرموز لتلقي تتبعات المكدس الرمزية في App Center Diagnostics.

symbolsPath - مسار الرموز
string. ‏‏اختياري. استخدم عندما symbolsType == AndroidNative || symbolsType = Windows.

المسار النسبي من جذر المستودع إلى مجلد الرموز.

appxsymPath - مسار الرموز (*.appxsym)
string. ‏‏اختياري. استخدم عندما symbolsType = UWP.

المسار النسبي لملف رموز APPXSYM. قد يحتوي المسار على أحرف بدل.

symbolsDsymFiles - مسار dSYM
الاسم المستعار للإدخل: dsymPath. string. ‏‏اختياري. استخدم عندما symbolsType = Apple.

المسار النسبي من جذر المستودع إلى مجلد dSYM. قد يحتوي المسار على أحرف بدل.

symbolsMappingTxtFile - ملف التعيين
الاسم المستعار للإدخل: mappingTxtPath. string. ‏‏اختياري. استخدم عندما symbolsType = Android.

المسار النسبي من جذر المستودع إلى ملف Android mapping.txt .

nativeLibrariesPath - مسار ملف المكتبة الأصلية
string. ‏‏اختياري. استخدم عندما symbolsType == Android.

المسار النسبي من جذر المستودع إلى المكتبات الأصلية الإضافية التي تريد نشرها (مثل ملفات .so).

symbolsIncludeParentDirectory - تضمين كافة العناصر في المجلد الأصل
الاسم المستعار للإدخل: packParentFolder. boolean. ‏‏اختياري. استخدم عندما symbolsType = Apple.

تحميل ملف أو مجلد الرموز المحددة وجميع العناصر الأخرى داخل المجلد الأصل نفسه. هذا مطلوب لتطبيقات React Native.

releaseNotesOption - إنشاء ملاحظات حول الإصدار
الاسم المستعار للإدخل: releaseNotesSelection. string. مطلوب القيم المسموح بها: input (أدخل ملاحظات الإصدار)، file (حدد ملف ملاحظات الإصدار). القيمة الافتراضية: input.

سيتم إرفاق ملاحظات الإصدار إلى الإصدار وعرضها على المختبرين في صفحة التثبيت.

releaseNotesInput - ملاحظات الإصدار
string. مطلوب عند releaseNotesSelection = input.

ملاحظات الإصدار لهذا الإصدار.

releaseNotesFile - إصدار ملف ملاحظات
string. مطلوب عند releaseNotesSelection = file.

تحديد ملف نصي مشفر UTF-8 يحتوي على ملاحظات الإصدار لهذا الإصدار.

isMandatory - مطالبة المستخدمين بتحديث هذا الإصدار
boolean. القيمة الافتراضية: false.

يقوم App Center بتوزيع SDK المطلوب لتفويض التحديث. تتم مطالبة المختبرين تلقائيا للتحديث.

destinationType - وجهة الإصدار
string. مطلوب القيم المسموح بها: groups، . store القيمة الافتراضية: groups.

يتم توزيع كل إصدار على المجموعات أو المتجر.

distributionGroupId - معرفات الوجهة
الاسم المستعار للإدخل: destinationGroupIds. string. ‏‏اختياري. استخدم عندما destinationType = groups.

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

destinationStoreId - معرف الوجهة
string. مطلوب عند destinationType = store.

معرفات مخزن التوزيع التي ستتلقى إصدار البناء.

isSilent - لا تقم بإعلام المختبرين. سيظل الإصدار متوفرا للتنصيب.
boolean. ‏‏اختياري. استخدم عندما destinationType = groups.

لا يتلقى المختبرون رسالة بريد إلكتروني للإصدارات الجديدة.

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

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

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

لا شيء

الملاحظات

استخدم هذه المهمة لتوزيع إصدارات التطبيق على المختبرين والمستخدمين من خلال App Center.

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

أمثلة

ينشئ هذا المثال البنية الأساسية لبرنامج ربط العمليات التجارية تطبيق Android، ويشغل الاختبارات، وينشر التطبيق باستخدام App Center Distribute.

# Android
# Build your Android project with Gradle.
# Add steps that test, sign, and distribute the APK, save build artifacts, and more:
# https://learn.microsoft.com/azure/devops/pipelines/ecosystems/android

pool:
  vmImage: 'macOS-latest'
steps:

- script: sudo npm install -g appcenter-cli
- script: appcenter login --token {YOUR_TOKEN}

- task: Gradle@2
  inputs:
    workingDirectory: ''
    gradleWrapperFile: 'gradlew'
    gradleOptions: '-Xmx3072m'
    publishJUnitResults: false
    testResultsFiles: '**/TEST-*.xml'
    tasks: build

- task: CopyFiles@2
  inputs:
    contents: '**/*.apk'
    targetFolder: '$(build.artifactStagingDirectory)'

- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: '$(build.artifactStagingDirectory)'
    artifactName: 'outputs'
    artifactType: 'container'

# Run tests using the App Center CLI
- script: appcenter test run espresso --app "{APP_CENTER_SLUG}" --devices "{DEVICE}" --app-path {APP_FILE} --test-series "master" --locale "en_US" --build-dir {PAT_ESPRESSO} --debug

# Distribute the app
- task: AppCenterDistribute@3
  inputs:
    serverEndpoint: 'AppCenter'
    appSlug: '$(APP_CENTER_SLUG)'
    appFile: '$(APP_FILE)' # Relative path from the repo root to the APK or IPA file you want to publish
    symbolsOption: 'Android'
    releaseNotesOption: 'input'
    releaseNotesInput: 'Here are the release notes for this version.'
    destinationType: 'groups'

المتطلبات

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