{"id":70,"date":"2016-02-24T23:34:42","date_gmt":"2016-02-25T03:34:42","guid":{"rendered":"http:\/\/vanilton.net\/blog\/?p=70"},"modified":"2016-03-13T18:54:14","modified_gmt":"2016-03-13T22:54:14","slug":"sikulix-parte-2-scripts-api-java","status":"publish","type":"post","link":"https:\/\/www.vanilton.net\/blog\/automacao\/sikuli\/2016\/02\/24\/sikulix-parte-2-scripts-api-java\/","title":{"rendered":"SikuliX Parte 2 &#8211; Scripts (API Java)"},"content":{"rendered":"<p>Ol\u00e1 galera!<\/p>\n<p>Seguindo com a S\u00e9rie de Posts sobre a ferramenta de automatiza\u00e7\u00e3o SikuliX neste post abordarei o uso da SikuliX Script API em Java que proporciona usar todos os recursos da ferramenta em conjunto com a linguagem Java, isto \u00e9 bom pois podemos integrar com muitas outras ferramentas que tamb\u00e9m s\u00e3o desenvolvidas na linguagem Java.<\/p>\n<p>Como j\u00e1 visto no <a href=\"http:\/\/vanilton.net\/blog\/2016\/02\/04\/sikulix-parte-1-ide\/\" target=\"_blank\">post anterior<\/a> usamos da SikuliX IDE para realizar os recortes das imagens ao qual desejamos interagir, continuaremos a utiliz\u00e1-la para realizar os recortes quando necess\u00e1rio, al\u00e9m de abordar detalhes que a IDE ainda pode nos prov\u00ea \ud83d\ude42<\/p>\n<p>Seguindo o racioc\u00ednio do post anterior utilizarei o app exemplo criando os mesmos scripts na API Java do SikuliX. Para gerenciamento do projeto e depend\u00eancias ser\u00e1 utilizado o Maven.<\/p>\n<p>Ent\u00e3o, deixando de bl\u00e1 bl\u00e1 bl\u00e1 vamos \u00e0 a\u00e7\u00e3o!<\/p>\n<h1>Requisitos do projeto de teste<\/h1>\n<ol>\n<li>Possuir Eclipse.<\/li>\n<li>Possuir o Maven configurado.<\/li>\n<li>Importar o projeto em:\u00a0<a href=\"https:\/\/github.com\/Vanilton18\/examples-sikuli-scriptapi\" target=\"_blank\">https:\/\/github.com\/Vanilton18\/examples-sikuli-scriptapi<\/a><\/li>\n<\/ol>\n<p>OBS: A configura\u00e7\u00e3o pode ser verificada em:\u00a0<a href=\"http:\/\/vanilton.net\/blog\/2016\/02\/01\/configurando-um-projeto-de-testes-sikuli-com-maven\/\" target=\"_blank\">http:\/\/vanilton.net\/blog\/2016\/02\/01\/configurando-um-projeto-de-testes-sikuli-com-maven\/<\/a><\/p>\n<h1>Criando o primeiro script com SikuliX API<\/h1>\n<div class=\"oembed-gist\"><script src=\"https:\/\/gist.github.com\/Vanilton18\/084418ee779e7bd58c14.js\"><\/script><noscript>View the code on <a href=\"https:\/\/gist.github.com\/Vanilton18\/084418ee779e7bd58c14\">Gist<\/a>.<\/noscript><\/div>\n<p>No c\u00f3digo\u00a0acima foi\u00a0implementado uma breve valida\u00e7\u00e3o se o app exemplo foi ou n\u00e3o aberto. Tamb\u00e9m\u00a0j\u00e1 podemos observar o uso da classe <em>Screen,\u00a0<\/em>que proporcionar\u00e1 o uso dos m\u00e9todos principais da SikuliX\u00a0API, como na SikuliX IDE os m\u00e9todos da Classe Screen seguem o mesmo nome, como find, exist, hover, click e etc.<\/p>\n<p>Para\u00a0os m\u00e9todos detectarem\u00a0as imagens que\u00a0devem interagir,\u00a0no par\u00e2metro\u00a0deve ser passado o <em>path<\/em> onde o arquivo de imagem se encontra, \u00a0como exemplificado em:<\/p>\n<pre>screen<span class=\"pl-k\">.<\/span>exists(<span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>src\/\/test\/\/resources\/\/pictures\/\/main.png<span class=\"pl-pds\">\"<\/span><\/span>)<\/pre>\n<p>Outra observa\u00e7\u00e3o \u00e9 que no uso de SikuliX\u00a0API a forma pela qual validamos se um elemento foi ou n\u00e3o detectado \u00e9 atrav\u00e9s da verifica\u00e7\u00e3o de <em>null,<\/em> pois apenas podemos observar se o objeto n\u00e3o est\u00e1 nulo.<\/p>\n<p>Os m\u00e9todos que utilizam busca\/intera\u00e7\u00e3o de imagem, exceto o m\u00e9todo &#8220;<em>exist<\/em>&#8221; retornando <em>null<\/em>, tem uma exce\u00e7\u00e3o chamada\u00a0<span style=\"color: #ff0000;\"><span class=\"pl-smi\"><i>FindFailed<\/i><span style=\"color: #000000;\"><em>,<\/em><\/span><\/span><\/span><em><span style=\"color: #ff0000;\"><span class=\"pl-smi\">\u00a0 <span style=\"color: #000000;\">caso o elemento n\u00e3o seja localizado. \u00a0<\/span><\/span><\/span><\/em><\/p>\n<p>Para realizar os testes execute a classe acima como <em>Java Application.<\/em><\/p>\n<h1>Intera\u00e7\u00f5es<\/h1>\n<div class=\"oembed-gist\"><script src=\"https:\/\/gist.github.com\/Vanilton18\/58ab7213f8c68c507483.js\"><\/script><noscript>View the code on <a href=\"https:\/\/gist.github.com\/Vanilton18\/58ab7213f8c68c507483\">Gist<\/a>.<\/noscript><\/div>\n<p>No c\u00f3digo acima j\u00e1 pode ser observado o uso de m\u00e9todos\u00a0de intera\u00e7\u00e3o como <em>click<\/em> e <em>hover.<\/em><\/p>\n<p>Tamb\u00e9m \u00e9 mostrado\u00a0a\u00a0classe <em>Settings<\/em>\u00a0da SikuliX\u00a0API, onde \u00e9 redefinido a vari\u00e1vel <em>BundlePath, est\u00e1 vari\u00e1vel nativamente \u00e9 nula e ao receber uma string &#8220;path&#8221;, utiliza este caminho como padr\u00e3o para a localiza\u00e7\u00e3o das imagens, como pode ser observado nos m\u00e9todos de intera\u00e7\u00e3o n\u00e3o se faz mais necess\u00e1rio passar todo o caminho at\u00e9 o arquivo da imagem e sim apenas o nome da imagem e sua extens\u00e3o.\u00a0<\/em><\/p>\n<p>Outras funcionalidades interessantes da classe Settings seria:<\/p>\n<ul>\n<li class=\"p1\">Settings.<span class=\"s3\">Highlight<\/span> = <span class=\"s2\">true<\/span>; \/\/Ativa a borda na imagem detectada<\/li>\n<li class=\"p1\"><span class=\"s1\">Settings.<\/span>DefaultHighlightTime<span class=\"s1\"> = (<\/span><span class=\"s2\">float<\/span><span class=\"s1\"><span class=\"s1\">) 1.0; \u00a0<\/span><\/span>\/\/Defini o tempo da borda sobre a imagem detectada<\/li>\n<li class=\"p2\">Settings.<span class=\"s1\">MoveMouseDelay<\/span> = (<span class=\"s2\">float<\/span>) 0.1; \/\/Redefine a velocidade de transi\u00e7\u00e3o do mouse at\u00e9 o elemento<\/li>\n<li class=\"p1\">Settings.<span class=\"s1\">MinSimilarity<\/span> = 0.9; \/\/Redefine a Similaridade das imagens(padr\u00e3o 0,7 ou 70%), para\u00a0(0,9 ou 90%)<\/li>\n<\/ul>\n<p>Para realizar os testes execute a classe acima como <em>Java Application.<\/em><\/p>\n<h1>Intera\u00e7\u00f5es com Type e Paste<\/h1>\n<div class=\"oembed-gist\"><script src=\"https:\/\/gist.github.com\/Vanilton18\/27357aebe484134439ec.js\"><\/script><noscript>View the code on <a href=\"https:\/\/gist.github.com\/Vanilton18\/27357aebe484134439ec\">Gist<\/a>.<\/noscript><\/div>\n<p>O c\u00f3digo acima realiza inser\u00e7\u00e3o de texto, colagem de texto e valida na tela de Input e Paste do app exemplo se o nome esperado \u00e9 correto ou incorreto.\u00a0Tamb\u00e9m\u00a0\u00e9 poss\u00edvel observar o\u00a0m\u00e9todo\u00a0<em>wait <\/em>ainda n\u00e3o visto em outros exemplos<em>.<\/em><\/p>\n<p>Como j\u00e1 dito no <a href=\"http:\/\/vanilton.net\/blog\/2016\/02\/04\/sikulix-parte-1-ide\/\">post anterior<\/a> o\u00a0m\u00e9todo <em>wait <\/em>por padr\u00e3o<em>\u00a0<\/em>faz a espera pela imagem passada por par\u00e2metro durante 2 segundos, caso seja necess\u00e1rio aumentar a espera apenas se faz necess\u00e1rio adicionar um segundo par\u00e2metro como inteiro, segue o exemplo:<\/p>\n<pre>screen<span class=\"pl-k\">.<\/span>wait(<span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>enter.png<span class=\"pl-pds\">\",<span style=\"color: #ff0000;\">20<\/span><\/span><\/span>);\/\/Espera alterada para 20 segundos<\/pre>\n<p>Outros m\u00e9todos que podem ser utilizados por meio da classe <em>Screen<\/em>.<\/p>\n<ul>\n<li class=\"p1\"><span class=\"s1\">screen<\/span>.<span class=\"s1\">h<\/span> = 1; \/\/ Define a altura do elemento a ser clicado<\/li>\n<li class=\"p1\"><span class=\"s1\">screen<\/span>.<span class=\"s1\">w<\/span> = 1; \/\/ Deine a largura do elemento a ser clicado<\/li>\n<li class=\"p1\"><span class=\"s1\">screen<\/span>.<span class=\"s1\">x<\/span> = 200; \/\/ Define a coordenada X<\/li>\n<li class=\"p1\"><span class=\"s1\">screen<\/span>.<span class=\"s1\">y<\/span> = 200; \/\/ Define \u00a0coordenada Y<\/li>\n<li class=\"p1\"><span class=\"s1\">screen<\/span>.click(); \/\/ Clica no centro do elemento criado (h,w) na posi\u00e7\u00e3o x =200 y = 200 come\u00e7ando do canto superior esquerdo (ponto 0) para baixo.<\/li>\n<li class=\"p1\"><span class=\"s1\">screen<\/span>.doubleClick(); \/\/Clique duplo<\/li>\n<li class=\"p1\">\n<p class=\"p1\"><span class=\"s1\">screen<\/span>.dragDrop(<span class=\"s2\">&#8220;img1&#8221;<\/span>, <span class=\"s2\">&#8220;img2&#8221;<\/span>); \/\/ Arrasta a img1 para a img2<\/p>\n<\/li>\n<li class=\"p1\">\n<p class=\"p1\"><span class=\"s1\">screen<\/span>.type(<span class=\"s2\">&#8220;a&#8221;<\/span>,Key.<span class=\"s1\">CTRL<\/span>); \/\/ Atalho CTRL + a<\/p>\n<\/li>\n<\/ul>\n<p>Ent\u00e3o \u00e9 isso pessoal, neste post j\u00e1 tivemos uma pr\u00e9via de como montar um ambiente SikuliX Script usando sua API na linguagem Java. No pr\u00f3ximo post da s\u00e9rie continuarei abordando a SikuliX Script API com maiores detalhes do uso da API num projeto de teste, integrando com o framework\u00a0de teste JUnit e usando o Padr\u00e3o PageObjects para melhor organiza\u00e7\u00e3o e reaproveitamento.<\/p>\n<p>At\u00e9 mais galera!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Ol\u00e1 galera! Seguindo com a S\u00e9rie de Posts sobre a ferramenta de automatiza\u00e7\u00e3o SikuliX neste post abordarei o uso da SikuliX Script API em Java que proporciona usar todos os recursos da ferramenta em conjunto<a class=\"read-more\" href=\"https:\/\/www.vanilton.net\/blog\/automacao\/sikuli\/2016\/02\/24\/sikulix-parte-2-scripts-api-java\/\">Continue reading<\/a><\/p>\n","protected":false},"author":1,"featured_media":119,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[6,9,5,15,10],"tags":[18,21],"wppr_data":[],"_links":{"self":[{"href":"https:\/\/www.vanilton.net\/blog\/wp-json\/wp\/v2\/posts\/70"}],"collection":[{"href":"https:\/\/www.vanilton.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.vanilton.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.vanilton.net\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.vanilton.net\/blog\/wp-json\/wp\/v2\/comments?post=70"}],"version-history":[{"count":8,"href":"https:\/\/www.vanilton.net\/blog\/wp-json\/wp\/v2\/posts\/70\/revisions"}],"predecessor-version":[{"id":142,"href":"https:\/\/www.vanilton.net\/blog\/wp-json\/wp\/v2\/posts\/70\/revisions\/142"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.vanilton.net\/blog\/wp-json\/wp\/v2\/media\/119"}],"wp:attachment":[{"href":"https:\/\/www.vanilton.net\/blog\/wp-json\/wp\/v2\/media?parent=70"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.vanilton.net\/blog\/wp-json\/wp\/v2\/categories?post=70"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.vanilton.net\/blog\/wp-json\/wp\/v2\/tags?post=70"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}