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
وtest
clean
analyze
.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-store
package
أو enterprise
ad-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 | أي |
إصدار الوكيل | جميع إصدارات العامل المدعومة. |
فئة المهمة | البنية |
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ