🛀🏽 ♋️ 📯 XCTestplan और Xcode 11 का उपयोग कर स्वचालित iOS स्क्रीनशॉट 🕴🏽 👨‍💼 🐟

Raiffeisenbank में कई मोबाइल एप्लिकेशन हैं जो विभिन्न प्रकार के उपकरणों और ऑपरेटिंग सिस्टम पर चलना चाहिए, इसलिए हम परीक्षण में नियमित प्रक्रियाओं को स्वचालित करने का प्रयास करते हैं। यह लेख हमें उपयोगी लगा, और हमने इसका अनुवाद करने का निर्णय लिया। foto source: unsplash.com यदि आपका एप्लिकेशन बहुभाषी, सार्वभौमिक है और विभिन्न उपकरणों के लिए डिज़ाइन किया गया है, तो आप प्रत्येक कॉन्फ़िगरेशन के लिए स्क्रीनशॉट बनाने में बहुत समय बिता सकते हैं। कल्पना कीजिए कि आपके पास चार भाषाएँ हैं, iPad और iPhone के लिए समर्थन और आपको प्रत्येक को 4 स्क्रीन को बचाने की आवश्यकता है - ये 32 स्क्रीनशॉट हैं। प्रक्रिया को स्वचालित किया जाना चाहिए ताकि समय हर बार बर्बाद न हो ताकि इंटरफेस अपडेट हो।

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

XCTestplan लॉन्च करें

चलो स्क्रीनशॉट के निर्माण को स्वचालित करने के लिए एक अलग यूआईटी लक्ष्य निर्धारित करते हैं, जो विशेष रूप से उपयोगी है यदि आप इन कॉन्फ़िगरेशन के साथ अपने मुख्य परीक्षण चलाने की योजना नहीं बनाते हैं। एक नया लक्ष्य बनाने के लिए, फ़ाइल -> नया -> लक्ष्य चुनें और एक नया UI परीक्षण बंडल बनाएं । उसके बाद, आपको इस लक्ष्य में एक नया XCTestplan जोड़ना होगा । ऐसा करने के लिए, आप या तो मेनू का उपयोग कर सकते हैं उत्पाद -> परीक्षण योजना -> नई परीक्षण योजना , या योजना संपादक में कन्वर्ट योजनाओं का उपयोग करने के लिए कन्वर्ट का चयन करें । यदि आप मेनू के माध्यम से ऐसा करते हैं, तो आपको यह सुनिश्चित करने की आवश्यकता है कि नया लक्ष्य `टेस्ट` टैब पर है।

चूंकि हम केवल भाषा सेटिंग्स को कॉन्फ़िगर करना चाहते हैं, हम साझा सेटिंग्स को अपरिवर्तित छोड़ सकते हैं और बस प्रत्येक भाषा के लिए एक नया कॉन्फ़िगरेशन जोड़ सकते हैं जिसका हम समर्थन करते हैं। यह अंग्रेजी, जर्मन और फ्रेंच का समर्थन करने वाले एप्लिकेशन के लिए सेटिंग है जैसे:

यह XCTestplan का सभी आवश्यक सेटअप और लॉन्च है।

स्क्रीनशॉट स्वचालन

स्क्रीनशॉट बनाने वाले आपके UI परीक्षण व्यावहारिक रूप से आपके सामान्य परीक्षणों से भिन्न नहीं होंगे सिवाय इसके कि वे अटैचमेंट बनाएंगे। आप XCTAssert चेक भी जोड़ सकते हैं ताकि कुछ गलत होने पर परीक्षण विफल हो जाएं।

एक अन्य महत्वपूर्ण बिंदु: यदि आपका यूआई स्क्रीनशॉट लेने ( कीबोर्ड को दिखाने / छिपाने के लिए, अंत एनीमेशन) के समय तक तैयार नहीं है, तो आपको प्रतीक्षा करने की आवश्यकता हो सकती है ।

नीचे सभी सहायक विधियों के साथ एक उदाहरण दिया गया है:

func testScreenshots() {
    let app = XCUIApplication()
    let searchButton = app.buttons["search"]
    searchButton.tap()
    
    let keyboard = app.keyboards.firstMatch
    waitForExistence(of: keyboard)
    app.typeText("Cupertino")
    add(takePromoShot(name: "Search"))
    
    let firstResult = app.cells.firstMatch
    firstResult.tap()
    waitForDisappearance(of: keyboard)
    add(takePromoShot(name: "Result"))
}

func waitForExistence(of element: XCUIElement) {
    let predicate = NSPredicate(format: "exists == TRUE")
    expectation(for: predicate, evaluatedWith: element, handler: nil)
    waitForExpectations(timeout: 5.0, handler: nil)
}

func waitForDisappearance(of element: XCUIElement) {
    let predicate = NSPredicate(format: "exists == FALSE")
    expectation(for: predicate, evaluatedWith: element, handler: nil)
    waitForExpectations(timeout: 5.0, handler: nil)
}

func takePromoShot(name: String) -> XCTAttachment {
    let lang = Locale.preferredLanguages[0]
    let screenshot = XCUIScreen.main.screenshot()
    let attachment = XCTAttachment(screenshot: screenshot)
    attachment.lifetime = .keepAlways
    attachment.name = "\(lang)-\(name)"
    return attachment
}

नवीनतम सुविधा पर ध्यान दें। यह स्नैपशॉट का नाम लेता है, भाषा पहचानकर्ता को जोड़ता है, स्क्रीनशॉट लेता है और .Acways पैरामीटर के मान के साथ एक XCTAttachment देता है । यह महत्वपूर्ण है क्योंकि डिफ़ॉल्ट रूप से, परीक्षण के दौरान लिए गए स्क्रीनशॉट हटा दिए जाते हैं यदि परीक्षण सफल होते हैं। Lifiteme एक महत्वपूर्ण पैरामीटर है क्योंकि यह सुनिश्चित करता है कि परीक्षण पूरा होने के बाद स्क्रीनशॉट को बचाया जाए। यूआई परीक्षणों के दौरान, स्क्रीनशॉट लगातार लिया जाता है। वे बहुत उपयोगी होते हैं जब आपको यह निर्धारित करने की आवश्यकता होती है कि परीक्षण क्यों और कब गिर गया; लेकिन डिफ़ॉल्ट रूप से स्क्रीनशॉट हटा दिए जाएंगे यदि परीक्षण सफल थे। इस प्रकार, जब टेस्टस्क्रीशॉट्स () सफल होता है, तो आपके पास केवल आवश्यक स्क्रीनशॉट होंगे।

आदतन स्थिति पट्टी

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

xcrun simctl status_bar booted override --time 9:41 --operatorName ' ' --cellularMode active --cellularBar 4 --wifiBars 3 --batteryState charged

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

परिणामी स्क्रीनशॉट एकत्र करना

अब हम अपने UI परीक्षण चला सकते हैं। जब वे पास हो जाएंगे, तो हम Xcode में रिपोर्ट नेविगेटर में परिणाम देखेंगे । भाषा विन्यास द्वारा समूहीकृत प्रक्रियाओं वाले परीक्षण भी होंगे। जिन प्रक्रियाओं में संलग्नक हैं, उन्हें एक पेपर क्लिप के साथ चिह्नित किया गया है। छवियां खुद QuickLook में खोली जा सकती हैं ।

अलग-अलग सभी परिणामी चित्रों को एकत्रित करना बहुत समय लेने वाला हो सकता है, खासकर अगर आपका एप्लिकेशन कई भाषाओं का समर्थन करता है। दुर्भाग्य से, ये अटैचमेंट परीक्षा परिणाम (Xcode 11 में एक और बदलाव) के बीच png या jpg के रूप में प्रकट नहीं होते हैं। लेकिन आप परीक्षा परिणामों को पार्स कर सकते हैं और JSON को ढूंढ सकते हैं जो वास्तविक अनुलग्नकों को इंगित करता है और उन्हें इकट्ठा करता है। यह xcparse उपयोगिता का उपयोग करके किया जा सकता है ।। यह Homebrew का उपयोग करके स्थापित किया गया है और कमांड द्वारा लॉन्च किया गया है:

xcparse screenshots /path/to/Test.xcresult /path/to/outputDirectory

अतिरिक्त झंडे डिवाइस, ओएस या कॉन्फ़िगरेशन द्वारा फ़ाइलों को समूहित करेंगे। हमारी फ़ाइलों के नामों में एक भाषा पहचानकर्ता होता है, इसलिए आप उन्हें केवल नाम से क्रमबद्ध कर सकते हैं।

निष्कर्ष

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

XCTestplan और Xcode 11 का उपयोग कर स्वचालित iOS स्क्रीनशॉट

XCTestplan लॉन्च करें

स्क्रीनशॉट स्वचालन

आदतन स्थिति पट्टी

परिणामी स्क्रीनशॉट एकत्र करना

निष्कर्ष

More articles: