Xcode@4 - مهمة Xcode v4

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

إعراب

# Xcode v4
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@4
  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' | '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. 
    #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: 'iPhone 7' # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. Default: iPhone 7.
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #outputPattern: # string. Output directory. 
    #useXcpretty: false # boolean. Use xcpretty. Default: false.
    #publishJUnitResults: false # boolean. Publish test results to VSTS/TFS. Default: false.

المدخلات

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

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

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

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

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

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

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

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

نظام scheme -
Person.

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

إصدار xcodeVersion - Xcode
Person. القيم المسموح بها: 8 (Xcode 8) 9 (Xcode 9) defaultspecifyPath (تحديد المسار). القيمة الافتراضية: default.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

النظام الأساسي destinationPlatformOption - الوجهة
Person. القيم المسموح بها: defaultiOS (iOS و watchOS) tvOSmacOScustom. القيمة الافتراضية: default.

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

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

يحدد النظام الأساسي لجهاز الوجهة المستخدم لاختبار واجهة المستخدم عندما يكون جهاز البناء العام غير صالح.

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

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

محاكاة destinationSimulators -
Person. اختياري. استخدم عند destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. القيمة الافتراضية: iPhone 7.

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

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

يحدد اسم الجهاز المستخدم لاختبار واجهة المستخدم، مثل Raisa's iPad.

الوسيطات args -
Person.

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

دليل العمل
الاسم المستعار للإدخل: cwd. Person.

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

دليل الإخراج outputPattern -
Person.

اختياري. تحديد مسار نسبي إلى دليل العمل حيث يتم وضع إخراج البناء (الثنائيات). على سبيل المثال: output/$(SDK)/$(Configuration) أو output/$(TestSDK)/$(TestConfiguration). يتم تكوين مسارات الأرشيف والتصدير بشكل منفصل. حدد القيم في علامة التبويب المتغيرات.

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

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

publishJUnitResults - نشر نتائج الاختبار إلى VSTS/TFS
Person. القيمة الافتراضية: false.

إذا تم تمكين xcpretty، يحدد هذا الإدخال ما إذا كان سيتم نشر نتائج اختبار JUnit إلى VSTS/TFS.

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

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

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

اي.

ملاحظات

استخدم هذه المهمة لإنشاء مساحة عمل Xcode على macOS.

امثله

إنشاء تطبيقات Xcode واختبارها ونشرها

المتطلبات

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

الملاحظات

هل كانت هذه الصفحة مفيدة؟

Last updated on 2026-04-27