पोको - एयरटेस्ट आईडीई के भाग के रूप में मोबाइल गेम्स के लिए पायथन-आधारित यूआई स्वचालन

आज हम पोको नाम के दूसरे मुख्य UI स्वचालन ढांचे के बारे में बात करेंगे। पोको पायथन का उपयोग करता है, और यहां आप कोड लिखे बिना नहीं कर सकते हैं, लेकिन आइए पहले देखें कि इसका उपयोग किस लिए किया जाता है, जब यह इसे एक्सेस करने के लायक है और यह सब कैसे दिखता है।

यह लेख AirTest IDE श्रृंखला का अंतिम है। इस लिंक पर पहला, अवलोकन, काम पाया जा सकता है, और दूसरा, जो छवि मान्यता ढांचे के बारे में बात करता है, यहां पाया जा सकता है ।

पोको एक गेम ऑटोमेशन यूआई फ्रेमवर्क है जो पायथन को अपने इमेज रिकग्निशन फ्रेमवर्क (एयरटेस्ट) के साथ कार्यक्षमता को संयोजित करने की क्षमता के साथ एयरटेस्ट आईडीई के हिस्से के रूप में उपयोग करता है। यह उल्लेखनीय है कि AirTest IDE को अन्य भाषाओं (JS, Lua, C #, Java) के लिए समर्थन प्राप्त है, लेकिन आगे के उदाहरण पायथन में होंगे, जैसे इस भाषा को मुख्य माना जाता है।

बातचीत के मुख्य तत्व इस प्रकार हैं:

यह समझा जाता है कि पोको का उपयोग उन स्थानों पर किया जाएगा जहां एयरटेस्ट सामना नहीं करता है, लेकिन, जैसा कि डेवलपर्स खुद नोटिस करते हैं, आप केवल पोको का उपयोग करके सभी परीक्षण लिख सकते हैं और उनकी रन गति बहुत अधिक होगी, लेकिन फिर आपको पायथन को बुनियादी स्तर पर कम से कम जानना होगा।

अपने खेल के लिए पोको-एसडीके का परिचित और कनेक्शन

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

खेल को AirTest IDE और आपके पहले परीक्षणों से जोड़ना

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

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

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

बिगाड़ने के तहत उपरोक्त चरणों का एक उदाहरण।

स्क्रीन पर किसी भी तत्व के साथ बातचीत करने के लिए, आपको उसका UI पथ कोड जानना होगा। ऐसा करने के लिए, पोको असिस्टेंट में ऑब्जेक्ट पर डबल-क्लिक करें या सही माउस बटन पर क्लिक करें और उचित आइटम का चयन करें। चयनित तत्व तक पहुंचने के लिए स्क्रिप्ट एडिटर विंडो में एक कोड दिखाई देगा और आपको बिंदु के माध्यम से केवल इंटरैक्शन (फ़ंक्शन) का तरीका जोड़ना होगा।

उदाहरण के लिए, यदि आपको पदानुक्रम में "btn_start" के रूप में निर्दिष्ट बटन पर क्लिक करने की आवश्यकता है, तो एक क्लिक के लिए आपको इस कोड की तरह कुछ की आवश्यकता होगी।

poco("btn_start").click() 

यानी एक डेमो गेम पर आधारित सबसे सरल परीक्षण जो स्टार्ट और बैक मुख्य स्क्रीन (ग्लोबलकंट्रोल सेक्शन) से बटन दबाने पर इस तरह दिखेगा

 # -*- encoding=utf8 -*- __author__ = "authorName" from airtest.core.api import * auto_setup(__file__) from poco.drivers.unity3d import UnityPoco poco = UnityPoco() poco("btn_start").click() poco("btn_back").click() 

वास्तव में क्या होता है: कार्यक्रम कोड में संकेतित तत्व को पाता है और स्क्रीन पर अपना स्थान खोजने के बाद, वांछित कार्य करता है। ये सभी ऑपरेशन और आवश्यक डेटा (उदाहरण के लिए, ऑब्जेक्ट का स्थान, उस पर क्लिक की संख्या, आदि) रिपोर्ट में पाए जा सकते हैं, और रिपोर्ट स्वयं कीबोर्ड शॉर्टकट Ctrl + L का उपयोग करके बनाई जा सकती है। ध्यान दें कि बटन के नाम / पते वर्तमान स्क्रीन पर उनके अस्तित्व की गणना से लिए गए हैं।

यह सब AirTest IDE (1.2.2) के नवीनतम संस्करण में कैसे दिखता है, यह स्पॉइलर के नीचे देखा जा सकता है।

आइटम प्रकार

मुझे प्रलेखन नहीं मिला जो तत्वों के प्रकारों का वर्णन करेगा, इसलिए मैं उपयोग के बाद अपनी टिप्पणियों और टिप्पणियों को साझा करूंगा। उसके बाद, मैं एक उदाहरण दूंगा कि कैसे विशिष्ट तत्वों का उपयोग किया जाए और प्रलेखन के लिए एक लिंक छोड़ दिया जाए, जिसमें कई गुना अधिक विस्तृत जानकारी शामिल है।

तत्वों के उदाहरण डेमो गेम की एक स्क्रीन के आधार पर दिए जाएंगे।

इस उदाहरण में निम्नलिखित तत्व शामिल हैं:

• पाठ - इस स्क्रीन में इसकी 3 किस्में शामिल हैं। स्पॉइलर के नीचे उदाहरण छिपाए जाएंगे।

• छवि - ऊपर के उदाहरण में - एक सितारा है।

• इनपुट फ़ील्ड - हमारे मामले में टेक्स्ट इनपुट फ़ील्ड

• बटन हमारे उदाहरण में बैक बटन है, लेकिन स्पॉइलर के नीचे एक और बटन का एक उदाहरण होगा, क्योंकि बैक बिल्ट-इन स्क्रीन पर पूरी तरह से फिट नहीं है

• नोड - निश्चित नहीं कि इसका वर्णन कैसे किया जाए, लेकिन, वास्तव में, यह तत्वों का एक कंटेनर है।

उपरोक्त उदाहरण से सभी तत्वों का विस्तारित पेड़ इस प्रकार है

और कोडिंग के बारे में थोड़ा और

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

 add_post_action_callback add_pre_action_callback agent click freeze get_screen_size long_click sleep_for_polling_interval snapshot wait_for_all swipe wait_for_any wait_stableattr child children click (   ,     ) drag_to exists focus get_bounds get_name get_position get_size get_text invalidate nodes offspring set_text setattr sibling swipe (   ,     ) wait wait_for_appearance wait_for_disappearance 

यहाँ चरों का उपयोग करना अत्यधिक अनुशंसित है और यहाँ तक कि कुछ समस्याओं से भी बचाता है। बाद में बस चर नाम निर्दिष्ट करके तत्वों को एक्सेस करना संभव होगा। नीचे आप एक चर को एक तत्व को बचाने और इसे एक्सेस करने के कुछ उदाहरण पा सकते हैं:

 star = poco("star_single") if star.exists(): pos = star.get_position() 

 input_field = poco("pos_input") time.sleep(1) input_field.set_text('x={:.02f}, y={:.02f}'.format(*pos)) time.sleep(3) 

 title = poco('title').get_text() if title == "Basic test": back = poco('btn_back', type='Button') back.click() back.click() 

मैंने ऊपर उल्लेख किया है कि चर आपको कुछ परेशानी से बचा सकते हैं। विशेष रूप से, मुझे डेमो गेम के ड्रैग एंड ड्रॉप मॉड्यूल में एक समस्या का सामना करना पड़ा। इसमें 5 स्टार (चित्र) शामिल हैं और खिलाड़ी का कार्य उन्हें शेल में स्थानांतरित करना है, जो तारों की पंक्ति के ठीक नीचे स्थित है। यह तुरंत ध्यान देने योग्य है कि समस्या तब उत्पन्न होती है जब आप सीधे "स्टार" तत्वों की सरणी तक पहुंचते हैं: तत्व को वांछित स्थिति में खींचने के बाद, यह गायब हो जाता है। AirTest IDE केवल दृश्य तत्वों पर विचार करता है और इसलिए, हस्तांतरित तारा अदृश्य हो जाने के बाद, कोड इसे सीधे एक्सेस नहीं कर सकता है। यदि आप सीधे तारों की सरणी तक पहुंचते हैं, तो इसे पुनर्निवेशित किया जाएगा, क्योंकि इसमें तत्वों की संख्या बदल गई है। यानी निम्न प्रविष्टि शेल में सभी 5 तत्वों को स्थानांतरित नहीं करेगी

 poco("playDragAndDrop").child("star")[0].drag_to(poco("shell")) poco("playDragAndDrop").child("star")[1].drag_to(poco("shell")) poco("playDragAndDrop").child("star")[2].drag_to(poco("shell")) poco("playDragAndDrop").child("star")[3].drag_to(poco("shell")) poco("playDragAndDrop").child("star")[4].drag_to(poco("shell")) 

किसी चर में सरणी के आरंभीकरण को संग्रहीत करने से आपको इसके दृश्य तत्वों की संख्या में प्रत्येक परिवर्तन के बाद सरणी को पुन: व्यवस्थित करने से बचने में मदद मिलेगी। इस मामले में, इसके तत्वों की अपील इस तरह दिखाई देगी:

 stars = poco("playDragAndDrop").child("star") stars[0].drag_to(poco("shell")) stars[1].drag_to(poco("shell")) 

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

परिणाम क्या है?

AirTest IDE विंडोज़ और मोबाइल ओएस पर गेम्स और अन्य जटिल प्रणालियों में UI का परीक्षण करने के लिए उपकरणों का एक काफी शक्तिशाली सेट है। आवश्यक तत्वों का पता लगाना ज्यादातर मामलों में सही तरीके से काम करता है, खरोंच से परीक्षण लिखने की क्षमता, कई प्रोग्रामिंग भाषाओं के लिए समर्थन, रिपोर्ट में परीक्षण के परिणामों के बारे में काफी विस्तृत जानकारी, जो आईडीई का उपयोग करके बनाई जा सकती है, साथ ही साथ उपकरण का मुफ्त सेट (मैं आपको याद दिलाता हूं कि एयरटेस्ट आईडीई एक ओपन-सोर्स एप्लिकेशन है) - यह सब एयरटेस्ट आईडीई के हाथों में खेलता है और कम से कम कोशिश करने का एक अच्छा कारण है, और बहुत कम से कम, इस उपकरण को अपने स्वचालन प्रणाली में लागू करें। यह ध्यान में रखा जाना चाहिए कि यद्यपि एयरटेस्ट को गेम का परीक्षण करने के लिए डिज़ाइन किया गया था, यह गेमप्ले को स्वचालित करने का इरादा नहीं है। Airtest IDE "स्थिर" चीजों का एक उत्कृष्ट काम करता है, उदाहरण के लिए, स्क्रीन पर कुछ तत्वों को ढूंढना, यूआई तत्वों के साथ काम करना, उदाहरण के लिए, गेम स्टोर में खरीदारी करना आदि। यह IDE पूरी तरह से इन कार्यों का सामना करता है और इस व्यवसाय में शुरुआती लोगों के लिए कम प्रविष्टि सीमा के साथ आपके अनुप्रयोगों के काफी सरल और विश्वसनीय स्वचालन के लिए सलाह दी जा सकती है!

आप उपयोग पर अधिक जानकारी पा सकते हैं, डेमो गेम पर आधारित उदाहरणों के साथ-साथ पोको उदाहरणों और ट्यूटोरियल अनुभाग में आधिकारिक डेवलपर्स पेज पर नेटएसे से खेल।

यदि आपके पास पहले से एयरटेस्ट आईडीई का उपयोग करने का अनुभव है, तो यह बहुत अच्छा होगा यदि आप इसे टिप्पणियों में साझा करते हैं, और यदि आपको बग मिलते हैं, तो आप उनकी बग रिपोर्ट को संबंधित पृष्ठ पर छोड़ सकते हैं!