From 1c62e084d9411870708fc42735487c7fb35b2ad3 Mon Sep 17 00:00:00 2001 From: neiger Date: Wed, 31 May 2023 12:20:44 -0600 Subject: [PATCH] Readme update --- README.md | 62 ++++++++++++------ .../authsampleapp/AuthSampleLoginScreen.class | Bin 3442 -> 0 bytes .../authsampleapp/WebViewBrowserScreen.class | Bin 2419 -> 0 bytes .../AuthSampleLoginScreenTests.class | Bin 2839 -> 0 bytes 4 files changed, 42 insertions(+), 20 deletions(-) delete mode 100644 target/test-classes/screens/authsampleapp/AuthSampleLoginScreen.class delete mode 100644 target/test-classes/screens/authsampleapp/WebViewBrowserScreen.class delete mode 100644 target/test-classes/tests/authsampleapp/AuthSampleLoginScreenTests.class diff --git a/README.md b/README.md index 26f852e..c5f55b2 100644 --- a/README.md +++ b/README.md @@ -1,34 +1,56 @@ -# Mobile Automation Framework for Android +# ANDROID AUTOMATION WITH APPIUM ## Getting started -This is an upgrade version of the code that will be compatible with Appium v2. Also works -with appium v1. +This guide will show how to use the automation scripts written in Java using Appium. +The basics configuration needed as well as common tools that need to be modified in +order to do a proper setup. ### ==================================================== -#### REQUIREMENTS +#### SETUP REQUIREMENTS Appium server installation v1: -- brew install node -- npm install -g appium -- npm install wd -- appium & + +FOR MACOS + +_**NOTE**: Homebrew must be set previously. If is not, follow this link for instructions: +[Homebrew Setup](https://docs.brew.sh/Installation)_ +* brew install node +* npm install -g appium +* npm install wd +* appium & The needed dependencies are located in the ```pom.xml``` file. To take in consideration: -1. TestNG v7.5 still works with Java v8. A newer version requires Java v11. +1. TestNG v7.5 still works with Java v8, newer versions require Java v11 or above. 2. Selenium v4.8.1 still works with Java v8. Newer version are backward compatible. -3. For more info check this link [Java Client migration from 7 to 8](https://github.com/appium/java-client/blob/master/docs/v7-to-v8-migration-guide.md) +3. For more info check this link [Java Client migration from 7 to 8](https://github.com/appium/java-client/blob/master/docs/v7-to-v8-migration-guide.md). +4. This works with IntelliJ IDE as default. If another is used like Eclipse or VSCode, an effort research is required. + +#### HOW TO EXECUTE THE CODE? + +* Launch IntelliJ IDE +* Open the project +* Look for ```pom.xml``` file, right click then click "Reload project" +* Once is finished, look in "test>java>configMaps.xml" file +* Modify the section `````` with your devices + ``` + + + ``` +* Save the file +* Right click then click "Run '.../src/test/'configMaps.xml'" + + +#### ADDITIONAL NOTES -To execute the code, this framework must be downloaded first, -the dependencies are listed in the pom.xml maven file. +Keep in mind that this is for macOS supported configuration. If you are on windows, +the easiest way is to execute Appium GUI app. -#### CLONE OR DOWNLOAD THE CODE -$ git clone https://github.com/neiger/AndroidFramework.git -$ git pull -Then proceed as normal with the POM pattern. -Create a Screens package then a Tests package. -Locate all the UI elements and create the methods -Finally proceed with the test creation order -Use an xml config file to manage the executions. +#### HELPFUL LINKS +* http://appium.io/docs/en/2.0/ +* https://github.com/appium +* https://www.browserstack.com/guide/download-and-install-appium +* https://testng.org/doc/documentation-main.html +* https://www.selenium.dev/ \ No newline at end of file diff --git a/target/test-classes/screens/authsampleapp/AuthSampleLoginScreen.class b/target/test-classes/screens/authsampleapp/AuthSampleLoginScreen.class deleted file mode 100644 index 392f9bbf06655cbe6b728c25c87f8a971468e5d3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3442 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 diff --git a/target/test-classes/tests/authsampleapp/AuthSampleLoginScreenTests.class b/target/test-classes/tests/authsampleapp/AuthSampleLoginScreenTests.class deleted file mode 100644 index d2d4eb1777548bf71d4730e8fb61daf3da0b4c59..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2839 zcmb7G?Q+vb6uol393u#JNPt2>g+Lt>;)Ji#hC=Oxq;74J#!i6HHeK5rdqLKUm7Gi- zrBBe`ooPd-?eqcqzYo!8=uD?)B?Skt2l(S%t?u1(@45FL`LF+e`;&-nke{G)^yv`I zCuoB1Bq&Co4P$p#@9xFvbA6oCKY9JLppO^hbU#i@30kHv^m8FWU(#1`D(bZqrw4jn z(Qj7c^tE2s;#AgaB~I&l-H6k}A$l}Kj}01QZNFJ&E!XBn*$_^-rZ{&Dx?1#totM=H zUSPmnH=FBbK5x+A9pMQ7u0eh2sSShr7i66qG*T1}f6#7KxvH?LjgwSS)|kD)l+e%7 zVZYxLo-;)sVG$=tI?cB zmUZ4_^L$$>UgCaJ)^Yvh(!;G=TRU8d?Y&Bq1yK36?@OoPEeg-I*&eSOG|}ri9VV{1 zjcexS4&AfvaaHivxZhR|uUBMPfSl_V98{sf>jkHbV8Pc|y7-jsu&m7xY1vo8Y0PVa zPwevQhTyw-C3kVzLD{Bzl`YXp|4^Bqy+l|45o%^OGt9Yq|qXC>xFrMlQF)m5fg zi~C&ZvJC7nyNxTSk@)qSuO+_7d=@0H1mEHH1*sIT`SzYcSq>wMQv2wG)Er)JWJbitr2@6p*NZPF9%_l-&C$uj9% z`VOtN?&$8dd}-N|)h)ltt?*Klw&;747*$QG(FK$0+J2&A-{5{=UJbg)63({7@Ho<0 zE|rIfo3u?0lbR%k=&4E1wD&X;wmi{r3XX-UTRSMbwaYvU4ISX~x>Y+M(IlH%2BkZQ zHCxo4S<(q$A3cUgEf@oIC)LE8+y3Xwc4)5YBh;@GU>UtOdo^< zXyI6%?p14>3EK-$P<>GkKul8F{+71K3A46Qz>qH_6neMOzX#6Js&Y$l^to;glRWKx zt`nEfT%AgBWqD=2Vud6cG@~c^-F3sDGY#%=#q4ZJR?#|(3RI{Pb6A5bgN9M0@CYrL zo+=8Nh4hJbE33O`3xsmVhiuf96!mN_Ttf%+{%rca9P}_B2^FS@UV=D5K{qjYRpyD> zeWj!-c@2XucN2m)wE-i+JP_(vlpetG^yZs38ge+a%GowVG=wh)EtdD4L&|pibxA<8 z^5<=4BhFW(X{GuULp-k|Plmm!M>SF>R0uS7AG;pPlzDe+gGM_EtfGVwkK;k-ALwZ= zY~V-u<_)9^1s&)p8Vv%R^TNy{#hue{dj#86U{Le%P5=dGRl4hLSq~7nIQ$|4IE(hu z%H{<^2mw&7U{+Qk?mh~y>4Vf^Wbi?N^i1F{0+E3aHxvlFLF^%9_`QgyELH>SK;{J* zKVcK2$;gN(L6@*MLj$@@AK?kp3+Gtiyh;7RyUEP&6nmW6r@j}|{|oNQ{7eJ;G?*It zmE!v}j5mqS-6?nx9j6gWBBT^<8a;$F8R1MtQDg$lD=#sZsV~4Bi$IQ~%x)mZU`BKj zFsJAQojwFG_8P!+0C1INqNM&tc-psdC3SS4j{QJ)!fZxLndyBxo=Qe=)5+M`WbBW9 zN~K0$9`#wtp?~)21W5RiMxzkNQsa?9c+<($saHep3pme!Z$hz#!AcUPI)^gNA@6%& zC=ZJ@1YV^nNPH$p$3mD%gq@{XgpPot#Pn{Cu7RcNI31+ezmy+=AA#!_>2z=4-OVRt zc(8-I_T=_->VsDU4Vxq6b_U#L!R_o@x&62&z?sz9-T*fMa1#Kx-U@IVImPIc{{dUD B>QDdx