Xcode@5 - مهمة Xcode v5

استخدم هذه المهمة لإنشاء مساحة عمل Xcode أو اختبارها أو أرشفتها على macOS، وحزم تطبيق اختياريا.

بناء الجملة

# Xcode v5
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@5
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/project.xcworkspace' # string. Workspace or project path. Default: **/*.xcodeproj/project.xcworkspace.
    #scheme: # string. Scheme. 
    #xcodeVersion: 'default' # '8' | '9' | '10' | '11' | '12' | '13' | 'default' | 'specifyPath'. Xcode version. Default: default.
    #xcodeDeveloperDir: # string. Optional. Use when xcodeVersion == specifyPath. Xcode developer path. 
  # Package options
    #packageApp: false # boolean. Create app package. Default: false.
    #archivePath: # string. Optional. Use when packageApp == true. Archive path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageApp == true. Export path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageApp == true. Export options. Default: auto.
    #exportMethod: 'development' # string. Required when exportOptions == specify. Export method. Default: development.
    #exportTeamId: # string. Optional. Use when exportOptions == specify. Team ID. 
    #exportOptionsPlist: # string. Required when exportOptions == plist. Export options plist. 
    #exportArgs: # string. Optional. Use when packageApp == true. Export arguments. 
  # Signing & provisioning
    #signingOption: 'nosign' # 'nosign' | 'default' | 'manual' | 'auto'. Signing style. Default: nosign.
    #signingIdentity: # string. Optional. Use when signingOption = manual. Signing identity. 
    #provisioningProfileUuid: # string. Optional. Use when signingOption = manual. Provisioning profile UUID. 
    #provisioningProfileName: # string. Optional. Use when signingOption = manual. Provisioning profile name. 
    #teamId: # string. Optional. Use when signingOption = auto. Team ID. 
  # Devices & simulators
    #destinationPlatformOption: 'default' # 'default' | 'iOS' | 'tvOS' | 'macOS' | 'custom'. Destination platform. Default: default.
    #destinationPlatform: # string. Optional. Use when destinationPlatformOption == custom. Custom destination platform. 
    #destinationTypeOption: 'simulators' # 'simulators' | 'devices'. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS. Destination type. Default: simulators.
    #destinationSimulators: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. 
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #useXcpretty: true # boolean. Use xcpretty. Default: true.
    #xcprettyArgs: # string. Optional. Use when useXcpretty == true. Xcpretty arguments. 
    #publishJUnitResults: false # boolean. Publish test results to Azure Pipelines. Default: false.
    #testRunTitle: # string. Optional. Use when publishJUnitResults == true. Test run title.

الإدخالات

actions - الاجراءات
string. مطلوب القيمة الافتراضية: build.

تحديد قائمة إجراءات محددة بمسافة. بعض الخيارات الصالحة هي buildوtestcleananalyze.archive على سبيل المثال،clean build ينفذ بناء نظيفا. راجع Apple: الإنشاء من سطر الأوامر باستخدام الأسئلة المتداولة حول Xcode.

configuration - تكوين
string. القيمة الافتراضية: $(Configuration).

يحدد مشروع Xcode أو تكوين مساحة العمل المراد إنشائه. عند استخدام متغير، حدد قيمة (على سبيل المثال، Release) في علامة التبويب المتغيرات .

sdk - Sdk
string. القيمة الافتراضية: $(SDK).

يحدد SDK لاستخدامه عند إنشاء مشروع Xcode أو مساحة العمل. من تطبيق macOS Terminal، قم بتشغيل xcodebuild -showsdks لعرض القائمة الصالحة من SDKs. عند استخدام متغير، حدد قيمة (على سبيل المثال، iphonesimulator) في علامة التبويب المتغيرات .

xcWorkspacePath - مساحة العمل أو مسار المشروع
string. القيمة الافتراضية: **/*.xcodeproj/project.xcworkspace.

‏‏اختياري. يحدد مسارا نسبيا من جذر المستودع إلى مساحة عمل أو مشروع Xcode. على سبيل المثال، MyApp/MyApp.xcworkspace أو MyApp/MyApp.xcodeproj. يمكن استخدام أحرف البدل. تعرف على المزيد حول أنماط مطابقة الملفات.

scheme - نظام
string.

‏‏اختياري. يحدد اسم نظام Xcode. يجب أن يكون مخططا مشتركا (خانة اختيار مشتركة ضمن أنظمة مدارة في Xcode). إذا لم تحدد مخططا، وكانت مساحة العمل المحددة تحتوي على نظام مشترك واحد، فسيتم استخدام نظام مساحة العمل.

xcodeVersion - إصدار Xcode
string. القيم المسموح بها: 8 (Xcode 8)، 9 (Xcode 9)، 10 (Xcode 10)، 11 (Xcode 11)، 12 (Xcode 12)، 13 (Xcode 13)، default، specifyPath (تحديد المسار). القيمة الافتراضية: default.

يحدد الإصدار الهدف من Xcode. حدد Default لاستخدام الإصدار الافتراضي من Xcode على جهاز العامل. يعتمد تحديد رقم إصدار (على سبيل المثال، Xcode 9) على موقع الإصدار الذي سيتم تعيينه بواسطة متغيرات البيئة على جهاز العامل (على سبيل المثال، XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer). حدد Specify path لتوفير مسار معين إلى دليل مطور Xcode.

xcodeDeveloperDir - مسار مطور Xcode
string. ‏‏اختياري. استخدم عندما xcodeVersion == specifyPath.

يحدد مسارا إلى دليل مطور Xcode محدد (على سبيل المثال، /Applications/Xcode_9.0.0.app/Contents/Developer). يكون هذا الإدخال مفيدا عند تثبيت إصدارات متعددة من Xcode على جهاز العامل.

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

يحدد ما إذا كان يتم إنشاء ملف حزمة تطبيق IPA كجزء من البنية.

archivePath - مسار الأرشيف
string. ‏‏اختياري. استخدم عندما packageApp == true.

يحدد دليلا حيث يتم وضع الأرشيفات التي تم إنشاؤها.

exportPath - مسار التصدير
string. ‏‏اختياري. استخدم عندما packageApp == true. القيمة الافتراضية: output/$(SDK)/$(Configuration).

تحديد وجهة المنتج الذي تم تصديره من الأرشيف.

exportOptions - خيارات التصدير
string. ‏‏اختياري. استخدم عندما packageApp == true. القيم المسموح بها: auto (تلقائي)، plist، . specify القيمة الافتراضية: auto.

تحديد خيارات لتصدير الأرشيف. عند تحديد القيمة الافتراضية، Automatic يتم الكشف عن أسلوب التصدير تلقائيا من الأرشيف. حدد Plist لتحديد ملف plist يحتوي على خيارات التصدير. حدد Specify لتوفير أسلوب تصدير محدد ومعرف الفريق.

exportMethod - أسلوب التصدير
string. مطلوب عند exportOptions == specify. القيمة الافتراضية: development.

يحدد الأسلوب الذي يستخدمه Xcode لتصدير الأرشيف. على سبيل المثال: app-store أو package أو ad-hoc أو enterprise أو development.

exportTeamId - معرف الفريق
string. ‏‏اختياري. استخدم عندما exportOptions == specify.

يحدد معرف فريق Apple Developer Portal المكون من 10 أحرف لاستخدامه أثناء التصدير.

exportOptionsPlist - قائمة خيارات التصدير
string. مطلوب عند exportOptions == plist.

يحدد المسار إلى ملف plist الذي يحتوي على خيارات لاستخدامها أثناء التصدير.

exportArgs - تصدير الوسيطات
string. ‏‏اختياري. استخدم عندما packageApp == true.

يحدد وسيطات سطر الأوامر الإضافية المستخدمة أثناء التصدير.

signingOption - نمط التوقيع
string. القيم المسموح بها: nosign (عدم توقيع التعليمات البرمجية)، default (الإعدادات الافتراضية للمشروع)، manual (توقيع يدوي)، auto (توقيع تلقائي). القيمة الافتراضية: nosign.

يحدد أسلوب توقيع البنية. حدد Do not code sign لتعطيل التوقيع. حدد Project defaults لاستخدام تكوين توقيع المشروع فقط. حدد Manual signing لفرض التوقيع اليدوي وتحديد هوية التوقيع وملف تعريف التوفير اختياريا. حدد Automatic signing لفرض التوقيع التلقائي وتحديد معرف فريق التطوير اختياريا. إذا كان مشروعك يتطلب التوقيع، فاستخدم مهام تثبيت Apple... لتثبيت الشهادات وملفات تعريف التزويد قبل إنشاء Xcode.

signingIdentity - هوية التوقيع
string. ‏‏اختياري. استخدم عندما signingOption = manual.

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

provisioningProfileUuid - توفير ملف تعريف UUID
string. ‏‏اختياري. استخدم عندما signingOption = manual.

يحدد UUID لملف تعريف توفير مثبت يستخدم للإنشاء. استخدم مهام بناء منفصلة مع أنظمة أو أهداف مختلفة لتحديد ملفات تعريف التوفير حسب الهدف في مساحة عمل واحدة (iOS، tvOS، watchOS).

provisioningProfileName - توفير اسم ملف التعريف
string. ‏‏اختياري. استخدم عندما signingOption = manual.

يحدد اسم ملف تعريف التوفير المثبت المستخدم للبناء. إذا تم تحديده، فإن هذا له الأسبقية على UUID لملف تعريف التوفير. استخدم مهام بناء منفصلة مع أنظمة أو أهداف مختلفة لتحديد ملفات تعريف التوفير حسب الهدف في مساحة عمل واحدة (iOS، tvOS، watchOS).

teamId - معرف الفريق
string. ‏‏اختياري. استخدم عندما signingOption = auto.

مطلوب إذا كنت عضوا في فرق تطوير متعددة. يحدد معرف فريق التطوير المكون من 10 أحرف.

destinationPlatformOption - النظام الأساسي الوجهة
string. القيم المسموح بها: default، iOS (iOS و watchOS)، tvOS، ، macOS، . custom القيمة الافتراضية: default.

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

destinationPlatform - النظام الأساسي للوجهة المخصصة
string. ‏‏اختياري. استخدم عندما destinationPlatformOption == custom.

يحدد النظام الأساسي للجهاز الوجهة المستخدم لاختبار واجهة المستخدم عندما يكون جهاز الإنشاء العام غير صالح. اختر Custom تحديد نظام أساسي غير مضمن في القائمة. عند Default تحديده، لا يتم استهداف أجهزة محاكاة أو أجهزة.

destinationTypeOption - نوع الوجهة
string. ‏‏اختياري. استخدم عندما destinationPlatformOption != default && destinationPlatformOption != macOS. القيم المسموح بها: simulators (جهاز محاكاة)، devices (جهاز متصل). القيمة الافتراضية: simulators.

يحدد نوع الوجهة الذي يجب استخدامه لاختبار واجهة المستخدم. يجب توصيل الأجهزة بجهاز Mac الذي يقوم بالبناء عبر كبل أو اتصال بالشبكة. راجع الأجهزة وأجهزة المحاكاة في Xcode لمزيد من المعلومات.

destinationSimulators - محاكاه
string. ‏‏اختياري. استخدم عندما destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators.

يحدد اسم محاكي Xcode المستخدم لاختبار واجهة المستخدم. على سبيل المثال، iPhone X (iOS و watchOS) أو Apple TV 4K (tvOS). يمكن تحديد إصدار نظام التشغيل الهدف الاختياري بالتنسيق OS=<versionNumber>، مثل iPhone X,OS=11.1. راجع قائمة المحاكيات المثبتة على عامل macOS المستضاف للحصول على مزيد من المعلومات.

destinationDevices - الجهاز
string. ‏‏اختياري. استخدم عندما destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices.

يحدد اسم الجهاز المستخدم لاختبار واجهة المستخدم، مثل Raisa's iPad. جهاز واحد فقط مدعوم حاليا. لاحظ أن Apple لا تسمح بعلامات اقتباس (') في أسماء الأجهزة. بدلا من ذلك، يمكن استخدام علامات اقتباس مفردة لليمين (').

args - الحجج
string.

‏‏اختياري. يحدد وسيطات سطر الأوامر الإضافية التي سيتم الإنشاء بها. هذا الإدخال مفيد لتحديد -target أو -project وسيطات بدلا من مساحة عمل/مشروع ونظام. راجع Apple: الإنشاء من سطر الأوامر باستخدام الأسئلة المتداولة حول Xcode.

workingDirectory - دليل العمل
الاسم المستعار للإدخل: cwd. string.

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

useXcpretty - استخدام xcpretty
boolean. القيمة الافتراضية: true.

يحدد ما إذا كان يجب استخدامه xcpretty لتنسيق xcodebuild الإخراج. xcpretty يجب تثبيته على جهاز العامل (مثبت مسبقا على عوامل الإنشاء المستضافة في Azure Pipelines). إذا xcpretty لم يتم تثبيته، يتم عرض الإخراج الخام xcodebuild . راجع xcpretty لمزيد من المعلومات.

xcprettyArgs - وسيطات Xcpretty
string. ‏‏اختياري. استخدم عندما useXcpretty == true.

إذا xcpretty تم تمكينه، يحدد هذا الإدخال وسيطات ل xcpretty. راجع قائمة كوسيطات xcpretty على GitHub.

publishJUnitResults - نشر نتائج الاختبار إلى Azure Pipelines
boolean. القيمة الافتراضية: false.

يحدد ما إذا كان سيتم نشر نتائج اختبار JUnit إلى Azure Pipelines. يتطلب xcpretty ذلك تمكين لإنشاء نتائج اختبار JUnit.

testRunTitle - عنوان تشغيل الاختبار
string. ‏‏اختياري. استخدم عندما publishJUnitResults == true.

إذا تم xcpretty تمكين و publishJUnitResults ، يمكنك تحديد عنوان تشغيل الاختبار.

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

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

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

لا شيء

الملاحظات

استخدم هذه المهمة لإنشاء مساحة عمل Xcode أو اختبارها أو أرشفتها على macOS، وحزم تطبيق اختياريا.

استخدام ملفات تعريف تزويد متعددة

حاليا لا يوجد دعم لملفات تعريف تزويد متعددة لمهمة Xcode (على سبيل المثال لملحق تطبيق iOS).

أمثلة

إنشاء تطبيق Xcode الخاص بك

المتطلبات

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