स्पंदन एकीकरण टेस्ट - यह आसान है

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

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

final SerializableFinder button = find.byValueKey("button"); 

फिर उनके साथ कुछ क्रियाएं करें:

 driver = await FlutterDriver.connect(); ... await driver.tap(button); 

और सत्यापित करें कि आवश्यक UI तत्व वांछित स्थिति में हैं:

 final SerializableFinder text = find.byValueKey("text"); expect(await driver.getText(text), "some text"); 

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

स्क्रीन वस्तुओं

एंड्रॉइड ( काकाओ ) में, इस समस्या को प्रत्येक स्क्रीन से स्क्रीन (पेज-ऑब्जेक्ट) में यूआई तत्वों को समूहीकृत करके हल किया जाता है। इसी तरह के दृष्टिकोण को इस अपवाद के साथ लागू किया जा सकता है कि फ़्लटर में, UI तत्वों के साथ क्रिया करने के लिए, आपको न केवल Finder (UI तत्व की खोज करने के लिए) की आवश्यकता होती है, बल्कि FlutterDriver (एक क्रिया करने के लिए), इसलिए आपको FlutterDriver में एक लिंक संग्रहीत करने की आवश्यकता FlutterDriver । Screen ।

प्रत्येक UI तत्व को परिभाषित करने के लिए, हम DWidget वर्ग (D - इस मामले में Dart शब्द से) को जोड़ते हैं। एक DWidget बनाने के लिए DWidget एक FlutterDriver आवश्यकता होगी, जिसके साथ इस UI तत्व पर क्रियाएं की जाएंगी, साथ ही एक ValueKey , जो उस एप्लिकेशन से विजेट के ValueKey स्पंदन के साथ मेल खाता है जिसके साथ हम बातचीत करना चाहते हैं:

 class DWidget { final FlutterDriver _driver; final SerializableFinder _finder; DWidget(this._driver, dynamic valueKey) : _finder = find.byValueKey(valueKey); ... 

find.byValueKey(…) मैन्युअल रूप से प्रत्येक DWidget बनाते समय असुविधाजनक है, इसलिए ValueKey लिए DWidget मूल्य को पास करना बेहतर होता है, और DWidget को वांछित SerializableFinder प्राप्त होगा। प्रत्येक DWidget बनाते समय FlutterDriver को मैन्युअल रूप से पास करना बहुत सुविधाजनक नहीं है, इसलिए आप FlutterDriver को BaseScreen में संग्रहीत कर सकते हैं और इसे FlutterDriver में स्थानांतरित कर सकते हैं, और BaseScreen बनाने के लिए BaseScreen लिए एक नई विधि जोड़ BaseScreen :

 abstract class BaseScreen { final FlutterDriver _driver; BaseScreen(this._driver); DWidget dWidget(dynamic key) => DWidget(_driver, key); ... 

इस प्रकार, स्क्रीन कक्षाएं बनाना और उनमें UI तत्व प्राप्त करना बहुत आसान हो जाएगा:

 class MainScreen extends BaseScreen { MainScreen(FlutterDriver driver) : super(driver); DWidget get button => dWidget('button'); DWidget get textField => dWidget('text_field'); ... } 

await से छुटकारा

एक और बहुत सुविधाजनक बात नहीं है जब FlutterDriver साथ परीक्षण लिखना प्रत्येक कार्रवाई से पहले await जोड़ने की आवश्यकता है:

 await driver.tap(button); await driver.scrollUntilVisible(list, checkBox); await driver.tap(checkBox); await driver.tap(text); await driver.enterText("some text"); 

await को भूलना आसान है, और इसके बिना, परीक्षण सही ढंग से काम नहीं करेंगे, क्योंकि driver तरीके Future<void> वापस करते हैं और जब उन्हें बिना await बुलाया जाता है await विधि के अंदर पहले await तक निष्पादित किया जाता है, और बाकी विधि "बाद में स्थगित कर दी जाती है"।

आप इसे Future "लपेटो" होगा कि एक TestAction बनाकर TestAction कर सकते हैं ताकि हम अगले पर जाने से पहले एक कार्रवाई पूरी होने तक इंतजार कर सकें:

 typedef TestAction = Future<void> Function(); 

(अनिवार्य रूप से, TestAction किसी भी फ़ंक्शन (या लैम्ब्डा) है जो एक Future<void> लौटाता है)

अब आप आसानी से अनावश्यक प्रतीक्षा के बिना TestAction अनुक्रम चला सकते हैं:

 Future<void> runTestActions(Iterable<TestAction> actions) async { for (final action in actions) { await action(); } } 

एक DWidget में TestAction का उपयोग करना

DWidget उपयोग UI तत्वों के साथ बातचीत करने के लिए किया जाता है, और यह बहुत सुविधाजनक होगा यदि ये क्रियाएं TestAction ताकि उनका उपयोग runTestAction पद्धति में किया जा सके। ऐसा करने के लिए, DWidget वर्ग में कार्य विधियाँ होंगी:

 class DWidget { final FlutterDriver _driver; final SerializableFinder _finder; ... TestAction tap({Duration timeout}) => () => _driver.tap(_finder, timeout: timeout); TestAction setText(String text, {Duration timeout}) => () async { await _driver.tap(_finder, timeout: timeout); await _driver.enterText(text ?? "", timeout: timeout); }; ... } 

अब आप निम्नानुसार परीक्षण लिख सकते हैं:

 class MainScreen extends BaseScreen { MainScreen(FlutterDriver driver) : super(driver); DWidget get field_1 => dWidget('field_1'); DWidget get field_2 => dWidget('field_2'); DWidget field2Variant(int i) => dWidget('variant_$i'); DWidget get result => dWidget('result'); } … final mainScreen = MainScreen(driver); await runTestActions([ mainScreen.result.hasText("summa = 0"), mainScreen.field_1.setText("3"), mainScreen.field_2.tap(), mainScreen.field2Variant(2).tap(), mainScreen.result.hasText("summa = 5"), ]); 

यदि आपको runTestActions में कुछ कार्रवाई करने की आवश्यकता है जो runTestActions से संबंधित नहीं है, तो आपको केवल एक DWidget बनाने की आवश्यकता है जो Future<void> लौटाएगा:

 await runTestActions([ mainScreen.result.hasText("summa = 0"), () => driver.requestData("some_message"), () async => print("some_text"), mainScreen.field_1.setText("3"), ]); 

FlutterDriverHelper

FlutterDriver में यूआई तत्वों के साथ बातचीत करने के लिए कई तरीके हैं (टेक्स्ट को स्क्रॉल करना, प्राप्त करना और दर्ज करना, स्क्रॉल करना आदि) और इन तरीकों के लिए DWidget में इसी तरीके हैं जो TestAction ।

सुविधा के लिए, इस आलेख में वर्णित कोड को FlutterDriverHelper पर फ़्लटरड्राइवर FlutterDriverHelper पुस्तकालय के रूप में प्रकाशित किया गया है।

स्क्रॉलिंग सूचियों के लिए, जिसमें तत्व गतिशील रूप से बनाए गए हैं (उदाहरण के लिए, ListView.builder ), FlutterDriver में एक scrollUntilVisible विधि है:

 Future<void> scrollUntilVisible( SerializableFinder scrollable, SerializableFinder item, { double alignment = 0.0, double dxScroll = 0.0, double dyScroll = 0.0, Duration timeout, }) async { ... } 

यह विधि स्क्रॉल विजेट को निर्दिष्ट दिशा में स्क्रॉल करती है जब तक कि स्क्रीन पर item विजेट प्रकट नहीं होता है (या जब तक कोई timeout )। प्रत्येक scrollable पर scrollable करने scrollable पास नहीं करने के लिए, DScrollItem वर्ग जोड़ा गया था, जो एक DWidget विरासत में DWidget और एक सूची आइटम का प्रतिनिधित्व करता है। इसमें scrollable करने scrollable लिंक शामिल है, इसलिए स्क्रॉल करते समय यह केवल dyScroll या dxScroll को निर्दिष्ट करने के लिए बना रहता है:

 class SecondScreen extends BaseScreen { SecondScreen(FlutterDriver driver) : super(driver); DWidget get list => dWidget("list"); DScrollItem item(int index) => dScrollItem('item_$index', list); } ... final secondScreen = SecondScreen(driver); await runTestActions([ secondScreen.item(42).scrollUntilVisible(dyScroll: -300), ... ]); 

परीक्षणों के दौरान, आप एप्लिकेशन के स्क्रीनशॉट ले सकते हैं, और FlutterDriverHelper में एक Screenshoter जो स्क्रीनशॉट को वर्तमान समय के साथ सही फ़ोल्डर में सहेजता है और TestAction साथ काम कर सकता है।

अन्य समस्याओं और उनके समाधान

• मुझे समय / दिनांक संवादों में बटन पर क्लिक करने का एक मानक तरीका नहीं मिला - मुझे TestHooks का उपयोग TestHooks । TestHooks टेस्ट के दौरान वर्तमान समय / तिथि को बदलने के लिए भी उपयोगी हो सकता है।
• DropdownButtonFormField के लिए ड्रॉपडाउन सूची में DropdownButtonFormField आपको DropdownMenuItem के लिए नहीं, बल्कि इस DropdownMenuItem के child लिए key निर्दिष्ट करने की आवश्यकता है, अन्यथा Flutter Driver इसे खोजने में सक्षम नहीं होगा। इसके अलावा, ड्रॉप-डाउन सूची में स्क्रॉल करना अभी तक काम नहीं करता है ( github.com पर जारी )।
• FlutterDriver.getCenter पद्धति से Future<DriverOffset> , लेकिन DriverOffset सार्वजनिक API ( github.com पर जारी ) का हिस्सा नहीं है
• कुछ और समस्याग्रस्त और स्पष्ट चीजें नहीं हैं जो पहले से मौजूद हैं। आप उनके बारे में एक अद्भुत लेख में पढ़ सकते हैं। विशेष रूप से उपयोगी डेस्कटॉप पर परीक्षण चलाने और प्रत्येक परीक्षण की शुरुआत से पहले आवेदन की स्थिति को रीसेट करने की क्षमता थी।
• आप Github Actions का उपयोग करके परीक्षण चला सकते हैं। अधिक जानकारी यहाँ ।

यह करें

FlutterDriverHelper भविष्य के FlutterDriverHelper में शामिल हैं:

• वांछित सूची आइटम पर स्वचालित स्क्रॉलिंग यदि इसे एक्सेस करने के समय यह स्क्रीन पर दिखाई नहीं दे रहा है (जैसा कि एंड्रॉइड के लिए कास्पेरो लाइब्रेरी में किया गया है)। यदि संभव हो, तो दोनों दिशाओं में भी।
• एक Dwidget या DscrollItem साथ किए गए कार्यों के लिए इंटरसेप्टर।

टिप्पणियाँ और रचनात्मक प्रतिक्रिया का स्वागत करते हैं।

अद्यतन ( TestAction ) : संस्करण १.१.० में TestAction एक वर्ग बन गया, जिसमें String name फ़ील्ड है। और इसके लिए, runTestActions मेथड में की गई सभी क्रियाओं की लॉगिंग को runTestActions ।