Sikuli Tutorial για Selenium Αυτοματοποίηση

Σε τι βρίσκεται ο Sikuli Selenium?

Σικούλι είναι ένα εργαλείο δοκιμής αυτοματισμού ανοιχτού κώδικα βασισμένο σε GUI. Χρησιμοποιείται κυρίως για την αλληλεπίδραση με στοιχεία ιστοσελίδων και το χειρισμό αναδυόμενων παραθύρων. Το Sikuli χρησιμοποιεί την τεχνική της «Αναγνώρισης εικόνας» και του «Control GUI» για να αλληλεπιδράσει με στοιχεία ιστοσελίδων και αναδυόμενα παράθυρα. Στο Sikuli, όλα τα στοιχεία Ιστού λαμβάνονται ως εικόνες και αποθηκεύονται μέσα στο έργο.

⚠️ Σημείωση ονομασίας: Το έργο διατηρείται σήμερα ως SikuliX, δημοσιεύτηκε στο Maven Central ως com.sikulix:sikulixapiΤα ονόματα των κλάσεων παρακάτω παραμένουν αμετάβλητα.

Πώς να χρησιμοποιήσετε το Sikuli με Selenium Πρόγραμμα οδήγησης Web

Το Sikuli μπορεί να ενσωματωθεί με Selenium WebDriver χρησιμοποιώντας το αρχείο JAR Sikuli, στα δύο παρακάτω βήματα.

Βήμα 1) Λήψη το αρχείο JAR Sikuli από το παρακάτω URLκαι πρώηνtracΜεταφέρετε τα περιεχόμενα του αρχείου ZIP σε έναν φάκελο.

https://mvnrepository.com/artifact/com.sikulix/sikulixapi/2.0.5

Βήμα 2) Δημιουργήστε ένα νέο έργο JAVA στο Eclipse και προσθέστε το αρχείο JAR στη διαδρομή δημιουργίας, μαζί με τα αρχεία jar selenium χρησιμοποιώντας δεξί κλικ στο έργο -> Διαδρομή δημιουργίας -> Ρύθμιση παραμέτρων διαδρομής δημιουργίας, όπως φαίνεται παρακάτω.

Μόλις προσθέσετε το αρχείο JAR στη διαδρομή δημιουργίας του έργου, μπορούν να χρησιμοποιηθούν οι κλάσεις που παρέχονται από το Sikuli. Ένα έργο Maven μπορεί να δηλώσει το ίδιο τεχνούργημα ως εξάρτηση.

Μάθημα οθόνης στο Sikuli

Η κλάση Screen είναι η βασική κλάση για όλες τις μεθόδους που παρέχονται από το Sikuli. Η κλάση Screen περιέχει προκαθορισμένες μεθόδους για όλες τις συνήθεις λειτουργίες που εκτελούνται σε στοιχεία οθόνης, όπως κλικ, διπλό κλικ, παροχή εισόδου σε ένα πλαίσιο κειμένου, τοποθέτηση του δείκτη του ποντικιού κ.λπ. Παρακάτω είναι η λίστα με τις συνήθεις μεθόδους που παρέχονται από την κλάση Screen.

Μάθημα μοτίβων στο Sikuli

Όπου η κλάση Screen ενεργεί με βάση ένα απλό όνομα εικόνας, η κλάση Pattern χρησιμοποιείται για να συσχετίσει το αρχείο εικόνας με πρόσθετα χαρακτηριστικά για την μοναδική αναγνώριση του στοιχείου. Λαμβάνει τη διαδρομή της εικόνας ως παράμετρο.

Pattern p = new Pattern(“Path of image”);

Οι παρακάτω είναι οι πιο συχνά χρησιμοποιούμενες μέθοδοι της κλάσης Pattern.

Code Παράδειγμα για μεταφόρτωση αρχείου χρησιμοποιώντας το Sikuli

Ο παρακάτω κώδικας εξηγεί τη χρήση του Sikuli για μεταφόρτωση αρχείων στο Chrome.

package com.sikuli.demo;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.sikuli.script.FindFailed;
import org.sikuli.script.Pattern;
import org.sikuli.script.Screen;
import org.openqa.selenium.chrome.ChromeDriver;

public class SikuliDemo {

    public static void main(String[] args) throws FindFailed {

        System.setProperty("webdriver.chrome.driver", "D:\\chromedriver.exe");
        String filepath = "D:\\Guru99Demo\\Files\\";
        String inputFilePath = "D:\\Guru99Demo\\Files\\";
        Screen s = new Screen();
        Pattern fileInputTextBox = new Pattern(filepath + "FileTextBox.PNG");
        Pattern openButton = new Pattern(filepath + "OpenButton.PNG");
        WebDriver driver;

        // Open Chrome browser    
        driver = new ChromeDriver();
        driver.get("https://demo.guru99.com/test/image_upload/index.php");

        // Click on Browse button and handle windows pop up using Sikuli
        driver.findElement(By.xpath(".//*[@id='photoimg']")).click();
        s.wait(fileInputTextBox, 20);
        s.type(fileInputTextBox, inputFilePath + "Test.docx");
        s.click(openButton);

        // Close the browser
        driver.close();
    }
}

Code εξήγηση

Βήμα 1) Η πρώτη δήλωση περιλαμβάνει τον ορισμό της εκτελέσιμης διαδρομής προγράμματος οδήγησης για το chrome.

System.setProperty("webdriver.chrome.driver", "D:\\ chromedriver.exe");

⚠️ Σημείωση έκδοσης: Selenium 4 επιλύει το δυαδικό πρόγραμμα οδήγησης μέσω Selenium Διευθυντής, επομένως αυτή η γραμμή είναι πλέον προαιρετική. Διατηρείται όπως την έγραψε η πηγή.

Βήμα 2) Χρησιμοποιήστε ένα εργαλείο screengrab όπως π.χ Snipping Tool για να τραβήξετε στιγμιότυπα οθόνης του αναδυόμενου παραθύρου 'FileTextBox' και το κουμπί 'Άνοιγμα', όπως παρακάτω.

Έτσι θα πρέπει να φαίνεται το στιγμιότυπο οθόνης σας:

Οι εικόνες για το πλαίσιο κειμένου εισαγωγής αρχείου των Windows και το κουμπί ανοίγματος αποθηκεύονται στο "FileTextBox.PNG» και «OpenButton.PNG».

Παράδειγμα: Εάν θέλετε να αυτοματοποιήσετε τη λειτουργία ανοίγματος του σημειωματάριου, τότε πρέπει να αποθηκεύσετε την εικόνα ενός εικονιδίου επιφάνειας εργασίας για το σημειωματάριο σε ένα αρχείο PNG και να εκτελέσετε τη λειτουργία κλικ σε αυτό.

Στην περίπτωσή μας, αναγνωρίζει το πλαίσιο κειμένου εισαγωγής αρχείου και το κουμπί Άνοιγμα στο Windows αναδυόμενο παράθυρο χρησιμοποιώντας τις αποθηκευμένες εικόνες. Εάν η ανάλυση της οθόνης αλλάξει από τη λήψη εικόνας στη δοκιμαστική εκτέλεση σεναρίου, η συμπεριφορά του Sikuli θα ήταν ασυνεπής. Ως εκ τούτου, είναι πάντα σκόπιμο να εκτελείτε το δοκιμαστικό σενάριο στην ίδια ανάλυση στην οποία καταγράφονται οι εικόνες. Η αλλαγή στο μέγεθος των εικονοστοιχείων των εικόνων θα έχει ως αποτέλεσμα ο Sikuli να δημιουργήσει μια εξαίρεση FindFailed.

Βήμα 3) Οι επόμενες δηλώσεις περιλαμβάνουν τη δημιουργία αντικειμένων για κλάσεις Screen και Pattern. Δημιουργήστε ένα νέο αντικείμενο οθόνης. Ορίστε τη διαδρομή του αρχείου που θέλετε να ανεβάσετε ως παράμετρο στο αντικείμενο Pattern.

Screen s = new Screen();
Pattern fileInputTextBox = new Pattern(filepath + "FileTextBox.PNG");
Pattern openButton = new Pattern(filepath + "OpenButton.PNG");

Βήμα 4) Οι παρακάτω δηλώσεις αφορούν το άνοιγμα του προγράμματος περιήγησης Chrome με το URL μιας εφαρμογής μεταφόρτωσης αρχείων επίδειξης: https://demo.guru99.com/test/image_upload/index.php

driver = new ChromeDriver();
driver.get("https://demo.guru99.com/test/image_upload/index.php");

Βήμα 5) Κάντε κλικ στο κουμπί επιλογή αρχείου χρησιμοποιώντας την παρακάτω δήλωση

driver.findElement(By.xpath(".//*[@id='photoimg']")).click();

Βήμα 6) Περιμένετε να εμφανιστεί το αναδυόμενο παράθυρο των παραθύρων. Η μέθοδος αναμονής χρησιμοποιείται για τη διαχείριση της καθυστέρησης που σχετίζεται με το άνοιγμα των παραθύρων που εμφανίζονται αφού κάνετε κλικ στο κουμπί αναζήτησης.

s.wait(fileInputTextBox, 20);

Βήμα 7) Πληκτρολογήστε τη διαδρομή του αρχείου στο πλαίσιο κειμένου του αρχείου εισόδου και κάντε κλικ στο κουμπί Άνοιγμα

s.type(fileInputTextBox, inputFilePath + "Test.docx");
s.click(openButton);

Βήμα 8) Κλείστε το πρόγραμμα περιήγησης

driver.close();

Παραγωγή

Αρχικά, το σενάριο ανοίγει το πρόγραμμα περιήγησης chrome

Κάνοντας κλικ στο κουμπί "Επιλογή αρχείου", θα εμφανιστεί η αναδυόμενη οθόνη αρχείου των Windows. Εισάγει δεδομένα στο πλαίσιο κειμένου Εισαγωγή αρχείου και κάνει κλικ στο κουμπί «Άνοιγμα».

Η παρακάτω οθόνη εμφανίζεται μόλις ολοκληρωθεί η μεταφόρτωση του αρχείου και κλείνει το πρόγραμμα περιήγησης

Επειδή η αντιστοίχιση εξαρτάται από τα pixel, επανακτήστε κάθε εικόνα αναφοράς κάθε φορά που αναδιαμορφώνεται η διεπαφή. Αυτή η ευθραυστότητα είναι ο λόγος για τον οποίο οι ομάδες διατηρούν το Sikuli για αναδυόμενα παράθυρα. απλός χειρισμός αρχείων WebDriver δεν μπορεί να φτάσει.

Συχνές Ερωτήσεις