👔 🔌 👡 Xcode और ट्रैविस: कई कॉन्फ़िगरेशन पर परीक्षण चल रहा है 🌿 👧🏿 👁️

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

परिचय

क्या आपको कीड़े पसंद हैं? मैं उनमें से कुछ को मानता हूं: वसा के रसदार घातक कीड़े एक वास्तविक आनंद हैं, उन्हें याद नहीं करना और उनके साथ एक रिलीज जारी करना असंभव है। हालांकि, ऐसे छोटे कीड़े होने की संभावना नहीं है जो नग्न आंखों के लिए दिखाई नहीं देते हैं, लेकिन जो कुछ विशिष्ट परिस्थितियों में खुद को प्रकट करने का प्रयास करते हैं, उदाहरण के लिए, केवल ओएस के एक विशिष्ट संस्करण पर, या विशेष रूप से जब कंपाइलर अनुकूलन चालू होता है। ये छोटे बदमाश, बिना पकड़े, डेवलपर के बहुत सारे खून पीने और रात में नींद खराब करने में सक्षम हैं। विरोधाभासी रूप से, कम अक्सर एक बग स्वयं प्रकट होता है, अधिक बल कभी-कभी इसके कब्जे और उन्मूलन में जाते हैं। यदि आप समझते हैं कि मेरा क्या मतलब है, तो यह विचार कि परीक्षण को ओएस संस्करणों, उपकरणों और संकलन सेटिंग्स के संभावित उपयोग किए गए संयोजनों के पूरे सेट पर चलाया जाना चाहिए, संभवतः आपको स्पष्ट प्रतीत होगा।

हालांकि, GitHub पर दर्जनों लोकप्रिय पुस्तकालयों के एक जोड़े के त्वरित निरीक्षण के रूप में, अधिकांश डेवलपर्स ने, यहां तक कि प्रत्येक कमिट ( ट्रैविस-सीआई के माध्यम से) के लिए स्वचालित परीक्षण रन का उपयोग करते हुए, अभी भी केवल iOS के नवीनतम संस्करण के लिए एक कॉन्फ़िगरेशन का परीक्षण किया। इसके अतिरिक्त इकाइयाँ OS X पर परीक्षण करती हैं, लेकिन यह सीमित है। आइए देखें कि इसे अलग तरीके से कैसे किया जा सकता है।

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

xcodebuild

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

एक सामान्य परीक्षण कमांड इस तरह दिखता है:

xcodebuild test -project {project}.xcodeproj -scheme {scheme} -sdk iphonesimulator -destination OS=6.0,name=iPhone -configuration Release

सब कुछ काफी स्पष्ट है: हम परियोजना (या कार्यक्षेत्र), योजना, एसडीके, ओएस संस्करण, सिम्युलेटर नाम और डीबग / रिलीज़ कॉन्फ़िगरेशन का संकेत देते हैं।

एक छोटी सी स्क्रिप्ट के साथ, हम आसानी से सभी संभावित विन्यासों का पुनरावृत्ति और परीक्षण कर सकते हैं (यह मानते हुए कि हमारे पास 5.0 परिनियोजन लक्ष्य है, और हम iOS और OS X के लिए एक सार्वभौमिक पुस्तकालय का परीक्षण कर रहे हैं):

 for configuration in Release Debug do for device in "iPhone" "iPad" do for iosversion in 6.0 6.1 5.0 5.1 do test_ios iOSTests "$iosversion" "$device" "$configuration" done done for device in "iPhone Retina (3.5-inch)" "iPhone Retina (4-inch)" "iPad Retina" do for iosversion in 6.0 6.1 7.0 do test_ios iOSTests "$iosversion" "$device" "$configuration" done done for device in "iPhone Retina (4-inch 64-bit)" "iPad Retina (64-bit)" do test_ios iOSTests-64bit 7.0 "$device" "$configuration" done test_osx OSXTests "$configuration" done

(test_ios और test_osx - परीक्षण के लिए कार्य करता है, स्क्रिप्ट का पूरा संस्करण GitHol पर परीक्षण परियोजना में उपलब्ध है)

यह हमें 40 संभव विन्यास देगा, जो शायद पहले से ही बेमानी लगता है। आखिरकार, अलग-अलग अनुकूलन सेटिंग्स के साथ विभिन्न प्रस्तावों या यूआई पर तर्क का परीक्षण करने का बहुत मतलब नहीं है। और अगर आप सिस्टम को OS X Mavericks में अपग्रेड करने में कामयाब रहे, तो आप यह ध्यान रखने में कामयाब रहे कि iOS 5 सिमुलेटर ने इस पर काम नहीं किया।

कुल, भविष्य में लेख में हम निम्नलिखित विन्यासों का परीक्षण करेंगे:

तर्क परीक्षण	iOS 6.0	iOS 6.1	iOS 7.0	iOS 7.0 64-बिट	ओएस एक्स
रिहाई	✓	✓	✓	✓	✓
डिबग	✓	✓	✓	✓	✓

यूआई टेस्ट	iPhone	आईपैड	iPhone रेटिना (3.5 इंच)	iPhone रेटिना (4 इंच)	आईपैड रेटिना
iOS 6.0	✓	✓	✓	✓	✓
iOS 7.0		✓	✓	✓	✓

वास्तविक परियोजनाओं के लिए, प्रासंगिक कॉन्फ़िगरेशन का एक सेट सभी के लिए अलग-अलग होगा, ज़ाहिर है।

सफलतापूर्वक परीक्षण किए गए कॉन्फ़िगरेशन को गिनने और पहली विफलता पर बाहर निकलने के लिए एक बंधन जोड़ना, हमें मिलता है
स्क्रिप्ट का अंतिम संस्करण:

test-main-configurations.sh

 #!/bin/sh # Global settings project=XCode/TravisCI.xcodeproj

स्वरूपण उत्पादन

 function red() { eval "$1=\"$(tput setaf 1)$2$(tput sgr 0)\"" } function green() { eval "$1=\"$(tput setaf 2)$2$(tput sgr 0)\"" } function yellow() { eval "$1=\"$(tput setaf 3)$2$(tput sgr 0)\"" } function bold() { eval "$1=\"$(tput bold)$2$(tput sgr 0)\"" } function echo_fmt() { local str=$1 local color=$2 local bold=$3 if [ "$color" != '' ]; then $color str "$str" fi if [ "$bold" != '' ]; then $bold str "$str" fi echo $str }

परीक्षण

 succeeded_count=0 function test() { local options="$@" echo_fmt "xcodebuild test -project $project $options" yellow xcodebuild test -project $project "$@" local exitcode=$? if [[ $exitcode != 0 ]] ; then echo_fmt "xcodebuild exited with code $exitcode" red echo_fmt "=== TESTS FAILED ===" red bold exit 1 else ((succeeded_count++)) fi } function test_ios() { local scheme=$1 local iosversion=$2 local device="$3" local configuration=$4 shift 4 echo_fmt "=== TEST SCHEME $scheme IOS $iosversion DEVICE $device CONFIGURATION $configuration ===" yellow bold test -scheme "$scheme" \ -sdk iphonesimulator \ -destination OS="$iosversion",name="$device" \ -configuration "$configuration" \ "$@" } function test_osx() { local scheme=$1 local configuration=$2 shift 2 echo_fmt "=== TEST SCHEME $scheme OSX CONFIGURATION $configuration ===" yellow bold test -scheme "$scheme" -configuration "$configuration" "$@" }

 # Logic tests for configuration in Release Debug do for iosversion in 6.0 6.1 7.0 #5.0 5.1 # Mavericks does not support iOS 5 Simulator do test_ios "iOSLogicTests" "$iosversion" "iPad Retina" "$configuration" done test_ios "iOSLogicTests-64bit" 7.0 "iPad Retina (64-bit)" "$configuration" ONLY_ACTIVE_ARCH=YES test_osx "OSXTests" "$configuration" done # UI tests test_ios "iOSUITests" 6.0 "iPhone" Debug for device in "iPad" "iPhone Retina (3.5-inch)" "iPhone Retina (4-inch)" "iPad Retina" do for iosversion in 6.0 7.0 do test_ios "iOSUITests" "$iosversion" "$device" Debug done done # Result echo_fmt "=== SUCCEEDED $succeeded_count CONFIGURATIONS. ===" green bold

कौन सा लॉन्च:

 ./Script/test-main-configurations.sh

हमें सफलतापूर्वक पारित परीक्षणों के बारे में एक संदेश देगा:

=== 19 मान्यताओं को स्वीकार किया ===

या त्रुटि संदेश:

=== TESTS फेल ===

IOS 64-बिट सिम्युलेटर पर परीक्षण के बारे में

कुछ प्रकार के बग के कारण, Xcode अक्सर 64-बिट सिम्युलेटर पर परीक्षण चलाने की अनुमति नहीं देता है और एक अजीब संदेश के साथ शपथ लेता है:

यह अपमान परीक्षण कॉन्फ़िगरेशन (डीबग / रिलीज़) के लिए " केवल सक्रिय आर्किटेक्चर बनाएँ" = "हाँ" सेट करके तय किया गया है । इसलिए, 64-बिट परीक्षणों की स्क्रिप्ट में ONLY_ACTIVE_ARCH=YES एक अतिरिक्त विकल्प है।

XCode

कोई व्यक्ति स्क्रिप्ट को मैन्युअल रूप से चलाना पसंद नहीं कर सकता है, इसलिए आप एक अलग लक्ष्य बना सकते हैं जो इसे चलाएगा। ऐसा करने के लिए, Xcode में, लक्ष्य जोड़ें ... -> अन्य -> अलग-अलग जोड़तोड़ करें, फिर संपादक -> बिल्ड चरण जोड़ें -> रन स्क्रिप्ट बिल्ड चरण जोड़ें, और निम्न स्क्रिप्ट जोड़ें:

 cd ${SRCROOT}/.. #     scriptname="test-main-configurations" script="Script/${scriptname}.sh" log="Script/${scriptname}.log" $script > $log #  ,     if [[ $? != 0 ]] ; then #    , ... echo "error: TESTS FAILED" # ...     , ... exit 1 else rm $log # ...     fi

अब, यदि इस लक्ष्य (if + B ) की असेंबली सफलतापूर्वक पूरी हो गई है, तो परीक्षण सफलतापूर्वक पारित हो गए हैं, यदि नहीं, तो Scripts / test-main-configurations.log लॉग पर जाएं और देखें कि क्या कारण है।
बेशक, प्रत्येक प्रतिबद्धता से पहले मैन्युअल रूप से इस तरह के परीक्षण को चलाने के लिए पर्याप्त इच्छाशक्ति नहीं होगी, लेकिन नई रिलीज जारी करते समय इसे अनिवार्य कदम बनाना काफी संभव है, उदाहरण के लिए रिलीज डीवीसीएस शाखा में एक समान बिल्ड चरण जोड़कर।

ट्रैविस-सीआई

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

हमें केवल .travis.yml फ़ाइल को रिपॉजिटरी के रूट में जोड़ना है, जो यह संकेत देगा कि हमें अपनी स्क्रिप्ट चलाने की आवश्यकता है:

 language: objective-c script: Script/test-main-configurations.sh

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

यह जांचना न भूलें कि परीक्षण सर्किट रिपॉजिटरी में मौजूद हैं, अर्थात। साझा चेकबॉक्स उनके लिए निर्धारित है:

वैसे, ट्रैविस OS X 10.8.5 पर Xcode 5.0.2 का उपयोग करता है, इसलिए यह iOS 5.0 और iOS 5.1 पर परीक्षण चला सकता है।

डिवाइस पर परीक्षण।

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

 xcodebuild test -project XCode/TravisCI.xcodeproj -scheme iOSDeviceLogicTests -sdk iphoneos -destination name='iPad Yan' -configuration Release

यदि कुछ शुरू नहीं होता है, तो स्पॉइलर देखें

प्रोविजनिंग प्रोफाइल के साथ समस्या हो सकती है। जांचें कि एप्लिकेशन Xcode से डिवाइस पर शुरू हो रहा है या नहीं।
सत्यापित करें कि लक्ष्य निर्भरता में बिल्ड चरणों में परीक्षण लक्ष्य के लिए एक कंटेनर अनुप्रयोग है।
बिल्ड सेटिंग में बंडल लोडर पैरामीटर को इसके लिए सेट किया जाना चाहिए:
```
 $(BUILT_PRODUCTS_DIR)/MyExistingApp.app/MyExistingApp 
```
और टेस्ट होस्ट पैरामीटर का मान है:
```
 $(BUNDLE_LOADER) 
```
इसके अलावा, कंटेनर एप्लिकेशन की असेंबली सेटिंग्स में, डिफ़ॉल्ट पैरामीटर द्वारा छिपे हुए प्रतीक न के बराबर होना चाहिए।

वह सब है। एक अच्छा परीक्षण किया है!

Xcode और ट्रैविस: कई कॉन्फ़िगरेशन पर परीक्षण चल रहा है

परिचय

xcodebuild

XCode

ट्रैविस-सीआई

डिवाइस पर परीक्षण।

संदर्भ

More articles: