एक एक्ससीटेस्ट चलाएं

यह मार्गदर्शिका बताती है कि फायरबेस टेस्ट लैब में परीक्षण के लिए XCTest कैसे तैयार किया जाए।

चरण 1 : अपने प्रोजेक्ट के व्युत्पन्न डेटा स्थान को कॉन्फ़िगर करें

Xcode आपके द्वारा बनाए गए किसी भी परीक्षण सहित संकलित iOS कलाकृतियों को व्युत्पन्न डेटा निर्देशिका में रखता है। यदि आप चाहें, तो उस निर्देशिका के लिए डिफ़ॉल्ट स्थान रखना संभव है, लेकिन फ़ाइलों के लिए अधिक आसानी से पहुंच योग्य स्थान चुनना अक्सर सहायक होता है, खासकर यदि आप अक्सर टेस्ट लैब के साथ परीक्षण चलाने जा रहे हैं:

1. अपना प्रोजेक्ट Xcode में खोलें.
2. MacOS मेनू बार में, फ़ाइल > प्रोजेक्ट सेटिंग्स... चुनें
3. व्युत्पन्न डेटा ड्रॉप-डाउन को डिफ़ॉल्ट स्थान से कस्टम स्थान में बदलें।
4. ड्रॉप-डाउन के नीचे फ़ील्ड में, अपने परीक्षणों को आउटपुट करने के लिए Xcode के लिए एक स्थान चुनें। (यह आपका FOLDER_WITH_TEST_OUTPUT है)

चरण 2 : एक सामान्य परीक्षण फ़ाइल बनाएँ

टेस्ट लैब XCTest फ्रेमवर्क का उपयोग करके यूनिट परीक्षण और यूआई परीक्षण चलाता है। अपने ऐप के XCTests को टेस्ट लैब डिवाइस पर चलाने के लिए, इसे जेनेरिक iOS डिवाइस पर परीक्षण के लिए बनाएं:

1. अपने Xcode कार्यक्षेत्र विंडो के शीर्ष पर डिवाइस ड्रॉप-डाउन से, जेनेरिक iOS डिवाइस चुनें।
2. MacOS मेनू बार में, Product > Build For > Testing चुनें।

वैकल्पिक रूप से, आप कमांड लाइन से अपना XCTest बना सकते हैं। टर्मिनल में निम्नलिखित कमांड का उपयोग करें:

xcodebuild -project PATH/TO/YOUR_WORKSPACE/YOUR_PROJECT.xcodeproj \
   -scheme YOUR_SCHEME \
   -derivedDataPath FOLDER_WITH_TEST_OUTPUT \
   -sdk iphoneos build-for-testing

xcodebuild -workspace PATH/TO/YOUR_WORKSPACE.xcworkspace \
   -scheme YOUR_SCHEME \
   -derivedDataPath FOLDER_WITH_TEST_OUTPUT \
   -sdk iphoneos build-for-testing

चरण 3 : अपने परीक्षण पर हस्ताक्षर करें और सत्यापित करें

1. सुनिश्चित करें कि ऐप और परीक्षण में सभी कलाकृतियाँ हस्ताक्षरित हैं। उदाहरण के लिए, आप प्रोविज़निंग प्रोफ़ाइल और पहचान जैसी हस्ताक्षर सेटिंग्स निर्दिष्ट करके Xcode के माध्यम से ऐसा कर सकते हैं। अधिक जानकारी के लिए, Apple कोड साइनिंग देखें।

2. codesign --verify --deep --verbose /path/to/MyApp.app चलाकर ऐप हस्ताक्षर सत्यापित करें जहां "MyApp" अनज़िप किए गए फ़ोल्डर के अंदर ऐप का नाम है। यह प्रत्येक प्रोजेक्ट के लिए भिन्न होता है. अपेक्षित आउटपुट MyApp.app: valid on disk ।

3. यदि आप XCUITest चला रहे हैं, तो आपको codesign --verify --deep --verbose /path/to/MyTest-Runner.app चलाकर टेस्ट और रनर को सत्यापित करना होगा, जहां "MyTest" रनर का नाम है। अनज़िप किया गया फ़ोल्डर. यह प्रत्येक प्रोजेक्ट के लिए भिन्न होता है. अपेक्षित आउटपुट MyTest-Runner.app: valid on disk है।

चरण 4 : अपने ऐप को पैकेज करें और अपलोड करने के लिए परीक्षण करें

1. आपका परीक्षण सफलतापूर्वक बन जाने के बाद, इसे परीक्षण लैब पर अपलोड करने के लिए ज़िप करें:

   cd FOLDER_WITH_TEST_OUTPUT/Build/Products : \
   zip -r MyTests.zip Debug-iphoneos YOUR_SCHEME_iphoneosDEPLOYMENT_TARGET-arm64.xctestrun
   

आप परीक्षण फ़ाइलों को मैन्युअल रूप से संपीड़ित करके भी अपने परीक्षण को पैकेज कर सकते हैं:

1. फाइंडर खोलें और FOLDER_WITH_TEST_OUTPUT पर नेविगेट करें।

2. वह फ़ोल्डर खोलें जिसमें आपके प्रोजेक्ट का नाम उपसर्ग के रूप में है, फिर अंदर Build/Products फ़ोल्डर पर जाएँ।

3. फ़ोल्डरों का चयन करें Debug-iphoneos और YOUR_SCHEME _iphoneos DEPLOYMENT_TARGET -arm64.xctestrun और फिर उन्हें संपीड़ित करें।

चरण 5 : (वैकल्पिक) अपना परीक्षण स्थानीय रूप से चलाएँ

टेस्ट लैब के साथ अपना परीक्षण चलाने से पहले, आप इसके व्यवहार की गुणवत्ता की जांच करने के लिए इसे यूएसबी-कनेक्टेड डिवाइस के साथ स्थानीय रूप से चला सकते हैं:

xcodebuild test-without-building \
    -xctestrun "Derived Data/Build/Products/YOUR_SCHEME.xctestrun" \
    -destination id=your-phone-id

अगले कदम

अपना परीक्षण फायरबेस कंसोल या जीक्लाउड सीएलआई में अपलोड करें और चलाएं।