Xcode@2 - مهمة Xcode Build v2

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

بناء الجملة

# Xcode Build v2
# Build an Xcode workspace on Mac OS.
- task: Xcode@2
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/*.xcworkspace' # string. Workspace/Project Path. Default: **/*.xcodeproj/*.xcworkspace.
    #scheme: # string. Scheme. 
    #packageApp: true # boolean. Create App Package. Default: true.
  # Package Options
    packageTool: 'xcodebuild' # 'xcrun' | 'xcodebuild'. Required. Create Package (IPA) using. Default: xcodebuild.
    #archivePath: # string. Optional. Use when packageTool == xcodebuild. Archive Path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageTool == xcodebuild. Export Path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageTool == xcodebuild. 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. 
  # Signing & Provisioning
    #xcode8AutomaticSigning: false # boolean. Automatic Signing. Default: false.
    #teamId: # string. Optional. Use when xcode8AutomaticSigning = true. Team ID. 
    #signMethod: 'file' # 'file' | 'id'. Override Using. Default: file.
    #iosSigningIdentity: # string. Optional. Use when signMethod = id. Signing Identity. 
    #unlockDefaultKeychain: false # boolean. Optional. Use when signMethod = id. Unlock Default Keychain. Default: false.
    #defaultKeychainPassword: # string. Optional. Use when signMethod = id. Default Keychain Password. 
    #provProfileUuid: # string. Optional. Use when signMethod = id. Provisioning Profile UUID. 
    #p12: # string. Optional. Use when signMethod = file. P12 Certificate File. 
    #p12pwd: # string. Optional. Use when signMethod = file. P12 Password. 
    #provProfile: # string. Optional. Use when signMethod = file. Provisioning Profile File. 
    #removeProfile: false # boolean. Optional. Use when signMethod = file. Remove Profile After Build. Default: false.
  # Advanced
    #args: # string. Arguments. 
    #cwd: # string. Working Directory. 
    outputPattern: 'output/$(SDK)/$(Configuration)' # string. Required. Output Directory. Default: output/$(SDK)/$(Configuration).
    #xcodeDeveloperDir: # string. Xcode Developer Path. 
    #useXcpretty: false # boolean. Use xcpretty. Default: false.
    #publishJUnitResults: false # boolean. Publish to VSTS/TFS. Default: false.
  # xctool (deprecated)
    #useXctool: # boolean. Use xctool. 
    #xctoolReporter: # string. xctool Test Reporter Format.

الإدخالات

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

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


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

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


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

ينشئ مشروع Xcode أو مساحة عمل مقابل SDK المحدد. قم بتشغيل xcodebuild -showsdks لمشاهدة قائمة صالحة من SDKs.


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

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


scheme - نظام
string.

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


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

يحدد ما إذا كان يتم إنشاء IPA كجزء من البنية. لتصدير الأرشيفات باستخدام Xcode 7 وXcode 8، راجع المدخلات الإضافية في قسم خيارات الحزمة .


packageTool - إنشاء حزمة (IPA) باستخدام
string. مطلوب القيم المسموح بها: xcrun (xcrun (مهملة بواسطة Apple))، xcodebuild (أرشيف xcodebuild وتصديره). القيمة الافتراضية: xcodebuild.

يحدد الأداة المراد استخدامها لإنشاء IPA.


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

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


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

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


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

يحدد طريقة لتمرير خيارات التصدير عند تصدير الأرشيف.


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

يحدد الأسلوب الذي يستخدمه Xcode لتصدير الأرشيف. على سبيل المثال، أو app-storepackageأو enterprisead-hoc.development


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

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


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

يحدد المسار إلى ملف plist الذي يقوم بتكوين تصدير الأرشيف.


xcode8AutomaticSigning - التوقيع التلقائي
boolean. القيمة الافتراضية: false.

استخدم هذا الإدخال إذا كان لديك مشروع Xcode 8 أو Xcode 9 تم تكوينه للتوزيع التلقائي.


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

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


signMethod - تجاوز استخدام
string. القيم المسموح بها: file (محتويات الملف)، id (المعرفات). القيمة الافتراضية: file.

استخدم هذا الإدخال إذا كان البناء يستخدم أسلوب توقيع أو توفير يختلف عن الافتراضي. اختر File Contents استخدام شهادة P12 وملف تعريف التوفير. اختر Identifiers استرداد إعدادات التوقيع من سلسلة المفاتيح الافتراضية وملفات التعريف المثبتة مسبقا. اترك الحقول المقابلة فارغة إذا كنت لا ترغب في تجاوز إعدادات الإنشاء الافتراضية.


iosSigningIdentity - هوية التوقيع
string. ‏‏اختياري. استخدم عندما signMethod = id.

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


unlockDefaultKeychain - إلغاء تأمين سلسلة المفاتيح الافتراضية
boolean. ‏‏اختياري. استخدم عندما signMethod = id. القيمة الافتراضية: false.

حل أخطاء تفاعل المستخدم غير مسموح بها عن طريق إلغاء تأمين سلسلة المفاتيح الافتراضية.


defaultKeychainPassword - كلمة مرور سلسلة المفاتيح الافتراضية
string. ‏‏اختياري. استخدم عندما signMethod = id.

يحدد كلمة المرور لإلغاء تأمين سلسلة المفاتيح الافتراضية.


provProfileUuid - توفير UUID لملف التعريف
string. ‏‏اختياري. استخدم عندما signMethod = id.

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


p12 - ملف شهادة P12
string. ‏‏اختياري. استخدم عندما signMethod = file.

يحدد المسار النسبي لملف شهادة PKCS12 منسق يحتوي على شهادة توقيع لاستخدامها في الإنشاء.


p12pwd - كلمة مرور P12
string. ‏‏اختياري. استخدم عندما signMethod = file.

يحدد كلمة المرور إلى ملف شهادة P12 إذا تم تحديده. استخدم متغير بناء للتشفير.


provProfile - توفير ملف تعريف
string. ‏‏اختياري. استخدم عندما signMethod = file.

يحدد المسار النسبي لملف يحتوي على تجاوز ملف تعريف توفير ليتم استخدامه للبناء. استخدم مهام إنشاء منفصلة مع أنظمة أو أهداف مختلفة لتحديد ملفات تعريف التوفير حسب الهدف في مساحة عمل واحدة (iOS و WatchKit وtvOS).


removeProfile - إزالة ملف التعريف بعد الإنشاء
boolean. ‏‏اختياري. استخدم عندما signMethod = file. القيمة الافتراضية: false.

يزيل محتويات ملف تعريف التوفير من عامل الإنشاء بعد اكتمال الإنشاء. تحقق فقط مما إذا كنت تقوم بتشغيل عامل واحد لكل مستخدم.


args - الحجج
string.

يحدد وسيطات سطر الأوامر الإضافية المستخدمة للبناء. هذا الإدخال مفيد إذا كنت تريد استخدام -target أو -project بدلا من تحديد مساحة عمل ونظام.


cwd - دليل العمل
string.

يحدد دليل العمل لتشغيلات الإنشاء. الإعدادات الافتراضية لجذر المستودع.


outputPattern - دليل الإخراج
string. مطلوب القيمة الافتراضية: output/$(SDK)/$(Configuration).

يحدد المسار النسبي حيث يتم وضع إخراج البناء (الثنائيات).


xcodeDeveloperDir - مسار مطور Xcode
string.

‏‏اختياري. يحدد المسار إلى مجلد مطور Xcode إذا لم يكن النظام الافتراضي. للاستخدام عند تثبيت إصدارات متعددة من Xcode على نظام. على سبيل المثال: /Applications/Xcode 7.app/Contents/Developer.


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

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


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

يتم نشر نتائج اختبار JUnit التي تم إنتاجها باستخدام xctool إلى VSTS/TFS.


useXctool - استخدام xctool
boolean.

يستخدم xctool بدلا من xcodebuild. يجب تثبيته على مضيفي العامل. تعرف على المزيد حول xctool.
ملاحظه:xctool مهمل ولا يعمل مع Xcode 8.


xctoolReporter - xctool Test Reporter Format
string.

يختبر تنسيق المراسل لاستخدامه عند تحديد إجراء الاختبار ويتم تحديد استخدام xctool . حدد junit:output-file-path-here.xml لإنشاء تنسيق ملف متوافق مع مهمة نشر نتائج الاختبار. عند تحديده، تتم إضافة عادي تلقائيا. xctool يجب تثبيته على مضيفي العامل. تعرف على المزيد حول xctool.
ملاحظه:xctool مهمل ولا يعمل مع Xcode 8.


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

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

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

لا شيء

المتطلبات

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