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 - الاجراءات
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. إذا قمت بتحديد قيمة، يجب عليك أيضا تحديد النظام. لا تحدد قيمة إذا كنت تحددها -target flag في وسيطات متقدمة. على سبيل المثال، MyApp/MyApp.xcworkspace أو MyApp/MyApp.xcodeproj.

scheme - نظام
string.

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

xcodeVersion - إصدار Xcode
string. القيم المسموح بها: 8 (Xcode 8)، 9 (Xcode 9)، 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).

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

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

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

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

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

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

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

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

destinationSimulators - محاكاه
string. ‏‏اختياري. استخدم عندما 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 - الجهاز
string. ‏‏اختياري. استخدم عندما destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices.

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

args - الحجج
string.

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

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

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

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

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

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

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

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

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

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

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

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

لا شيء

الملاحظات

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

أمثلة

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

المتطلبات

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