Skip to content

Commit

Permalink
Site checkin for project QA Automation
Browse files Browse the repository at this point in the history
  • Loading branch information
adrian-herscu committed Apr 18, 2024
1 parent 0f9dfa1 commit 637457f
Showing 1,480 changed files with 5,575 additions and 4,611 deletions.
4 changes: 2 additions & 2 deletions 404.html
Original file line number Diff line number Diff line change
@@ -2,7 +2,7 @@


<!--
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from src/site/markdown/404.md at 2024-04-17
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from src/site/markdown/404.md at 2024-04-18
| Rendered using Apache Maven Fluido Skin 2.0.0-M7
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -131,7 +131,7 @@

<div id="breadcrumbs">
<ul class="breadcrumb">
<li id="publishDate">Last Published: 2024-04-17<span class="divider">|</span>
<li id="publishDate">Last Published: 2024-04-18<span class="divider">|</span>
</li>
<li id="projectVersion">Version: 1.0.4-SNAPSHOT</li>
</ul>
4 changes: 2 additions & 2 deletions adding-tests.html
Original file line number Diff line number Diff line change
@@ -2,7 +2,7 @@


<!--
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from src/site/markdown/adding-tests.md at 2024-04-17
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from src/site/markdown/adding-tests.md at 2024-04-18
| Rendered using Apache Maven Fluido Skin 2.0.0-M7
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -131,7 +131,7 @@

<div id="breadcrumbs">
<ul class="breadcrumb">
<li id="publishDate">Last Published: 2024-04-17<span class="divider">|</span>
<li id="publishDate">Last Published: 2024-04-18<span class="divider">|</span>
</li>
<li id="projectVersion">Version: 1.0.4-SNAPSHOT</li>
</ul>
4 changes: 2 additions & 2 deletions ci-cd.html
Original file line number Diff line number Diff line change
@@ -2,7 +2,7 @@


<!--
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from src/site/markdown/ci-cd.md at 2024-04-17
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from src/site/markdown/ci-cd.md at 2024-04-18
| Rendered using Apache Maven Fluido Skin 2.0.0-M7
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -131,7 +131,7 @@

<div id="breadcrumbs">
<ul class="breadcrumb">
<li id="publishDate">Last Published: 2024-04-17<span class="divider">|</span>
<li id="publishDate">Last Published: 2024-04-18<span class="divider">|</span>
</li>
<li id="projectVersion">Version: 1.0.4-SNAPSHOT</li>
</ul>
4 changes: 2 additions & 2 deletions ci-management.html
Original file line number Diff line number Diff line change
@@ -2,7 +2,7 @@


<!--
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.4.5:ci-management at 2024-04-17
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.4.5:ci-management at 2024-04-18
| Rendered using Apache Maven Fluido Skin 2.0.0-M7
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -131,7 +131,7 @@

<div id="breadcrumbs">
<ul class="breadcrumb">
<li id="publishDate">Last Published: 2024-04-17<span class="divider">|</span>
<li id="publishDate">Last Published: 2024-04-18<span class="divider">|</span>
</li>
<li id="projectVersion">Version: 1.0.4-SNAPSHOT</li>
</ul>
4 changes: 2 additions & 2 deletions combining-tests.html
Original file line number Diff line number Diff line change
@@ -2,7 +2,7 @@


<!--
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from src/site/markdown/combining-tests.md at 2024-04-17
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from src/site/markdown/combining-tests.md at 2024-04-18
| Rendered using Apache Maven Fluido Skin 2.0.0-M7
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -131,7 +131,7 @@

<div id="breadcrumbs">
<ul class="breadcrumb">
<li id="publishDate">Last Published: 2024-04-17<span class="divider">|</span>
<li id="publishDate">Last Published: 2024-04-18<span class="divider">|</span>
</li>
<li id="projectVersion">Version: 1.0.4-SNAPSHOT</li>
</ul>
4 changes: 2 additions & 2 deletions dependency-convergence.html
Original file line number Diff line number Diff line change
@@ -2,7 +2,7 @@


<!--
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.4.5:dependency-convergence at 2024-04-17
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.4.5:dependency-convergence at 2024-04-18
| Rendered using Apache Maven Fluido Skin 2.0.0-M7
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -131,7 +131,7 @@

<div id="breadcrumbs">
<ul class="breadcrumb">
<li id="publishDate">Last Published: 2024-04-17<span class="divider">|</span>
<li id="publishDate">Last Published: 2024-04-18<span class="divider">|</span>
</li>
<li id="projectVersion">Version: 1.0.4-SNAPSHOT</li>
</ul>
4 changes: 2 additions & 2 deletions dependency-info.html
Original file line number Diff line number Diff line change
@@ -2,7 +2,7 @@


<!--
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.4.5:dependency-info at 2024-04-17
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.4.5:dependency-info at 2024-04-18
| Rendered using Apache Maven Fluido Skin 2.0.0-M7
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -131,7 +131,7 @@

<div id="breadcrumbs">
<ul class="breadcrumb">
<li id="publishDate">Last Published: 2024-04-17<span class="divider">|</span>
<li id="publishDate">Last Published: 2024-04-18<span class="divider">|</span>
</li>
<li id="projectVersion">Version: 1.0.4-SNAPSHOT</li>
</ul>
4 changes: 2 additions & 2 deletions dependency-management.html
Original file line number Diff line number Diff line change
@@ -2,7 +2,7 @@


<!--
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.4.5:dependency-management at 2024-04-17
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.4.5:dependency-management at 2024-04-18
| Rendered using Apache Maven Fluido Skin 2.0.0-M7
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -131,7 +131,7 @@

<div id="breadcrumbs">
<ul class="breadcrumb">
<li id="publishDate">Last Published: 2024-04-17<span class="divider">|</span>
<li id="publishDate">Last Published: 2024-04-18<span class="divider">|</span>
</li>
<li id="projectVersion">Version: 1.0.4-SNAPSHOT</li>
</ul>
4 changes: 2 additions & 2 deletions distribution-management.html
Original file line number Diff line number Diff line change
@@ -2,7 +2,7 @@


<!--
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.4.5:distribution-management at 2024-04-17
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.4.5:distribution-management at 2024-04-18
| Rendered using Apache Maven Fluido Skin 2.0.0-M7
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -131,7 +131,7 @@

<div id="breadcrumbs">
<ul class="breadcrumb">
<li id="publishDate">Last Published: 2024-04-17<span class="divider">|</span>
<li id="publishDate">Last Published: 2024-04-18<span class="divider">|</span>
</li>
<li id="projectVersion">Version: 1.0.4-SNAPSHOT</li>
</ul>
4 changes: 2 additions & 2 deletions elasticsearch-tests.html
Original file line number Diff line number Diff line change
@@ -2,7 +2,7 @@


<!--
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from src/site/markdown/elasticsearch-tests.md at 2024-04-17
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from src/site/markdown/elasticsearch-tests.md at 2024-04-18
| Rendered using Apache Maven Fluido Skin 2.0.0-M7
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -131,7 +131,7 @@

<div id="breadcrumbs">
<ul class="breadcrumb">
<li id="publishDate">Last Published: 2024-04-17<span class="divider">|</span>
<li id="publishDate">Last Published: 2024-04-18<span class="divider">|</span>
</li>
<li id="projectVersion">Version: 1.0.4-SNAPSHOT</li>
</ul>
126 changes: 42 additions & 84 deletions environment-setup.html
Original file line number Diff line number Diff line change
@@ -2,7 +2,7 @@


<!--
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from src/site/markdown/environment-setup.md at 2024-04-17
| Generated by Apache Maven Doxia Site Renderer 2.0.0-M12 from src/site/markdown/environment-setup.md at 2024-04-18
| Rendered using Apache Maven Fluido Skin 2.0.0-M7
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -131,7 +131,7 @@

<div id="breadcrumbs">
<ul class="breadcrumb">
<li id="publishDate">Last Published: 2024-04-17<span class="divider">|</span>
<li id="publishDate">Last Published: 2024-04-18<span class="divider">|</span>
</li>
<li id="projectVersion">Version: 1.0.4-SNAPSHOT</li>
</ul>
@@ -142,7 +142,9 @@
<h1>Environment Setup</h1>
<p>More complex testing scenarios may require running multiple types of browsers
on multiple types of operating systems and running multiple types of mobile
emulators or even real devices.</p><section>
emulators or even real devices.</p>
<p>Assuming Windows 10
with <a href="https://docs.chocolatey.org/en-us/choco/setup" class="externalLink">Chocolatey installed</a>.</p><section>
<h2>Self-Signed Certificates</h2>
<p>Some services may require special root CA installed. While
on <code>$JAVA_HOME/jre/lib/security</code> run:</p>
@@ -152,83 +154,25 @@ <h2>Self-Signed Certificates</h2>
</code></pre></div>
<p>The default password is <code>changeit</code>.</p></section><section>
<h2>Selenium</h2>
<p>For a quick standalone Selenium Grid with several Nodes, refer
to <a href="selenium-hub-docker.yml">Selenium Hub Docker</a>. The Grid UI will be
at <a href="http://localhost:4444/ui" class="externalLink">http://localhost:4444/ui</a>.</p><section>
<h3>Selenium Hub</h3>
<ol style="list-style-type: decimal;">

<li><code>choco install -y selenium --params &quot;'/role:hub /service /autostart'&quot;</code>
<blockquote>

<p>Now, Selenium Grid should be available
at <a href="http://localhost:4444/grid/console" class="externalLink">http://localhost:4444/grid/console</a></p>
<p>Additional reading <a href="https://github.com/dhoer/choco-selenium#hub" class="externalLink">https://github.com/dhoer/choco-selenium#hub</a></p>
</blockquote></li>
</ol></section><section>
<h3>Selenium Node</h3>
<p>TBD</p></section></section><section>
<h2>Appium Node</h2>
<ol style="list-style-type: decimal;">

<li><code>choco install -y nodejs</code> &#x2013; and restart the console to refresh the env vars</li>
<li><code>npm --proxy http(s)://&lt;host&gt;:&lt;port&gt; install -g appium</code>
<blockquote>

<p>Now, <strong>Appium</strong> should be at <code>%APPDATA%\npm</code>.</p>
</blockquote></li>
<li>Configure Appium
<ol style="list-style-type: decimal;">

<li>add <code>nodeconfig.json</code> to Appium's installation directory

<div class="verbatim">
<pre><code class="language-json"> {
&quot;capabilities&quot;: [
{
&quot;browserName&quot;: &quot;&quot;,
&quot;version&quot;: &quot;&quot;,
&quot;maxInstances&quot;: 1,
&quot;platform&quot;: &quot;WINDOWS&quot;
}
],
&quot;configuration&quot;: {
&quot;cleanUpCycle&quot;: 2000,
&quot;timeout&quot;: 30000,
&quot;proxy&quot;: &quot;org.openqa.grid.selenium.proxy.DefaultRemoteProxy&quot;,
&quot;url&quot;: &quot;http://&lt;machine-hostname&gt;:4723/wd/hub&quot;,
&quot;host&quot;: &quot;&lt;machine-hostname&gt;&quot;,
&quot;port&quot;: 4723,
&quot;maxSession&quot;: 1,
&quot;register&quot;: true,
&quot;registerCycle&quot;: 5000,
&quot;hubPort&quot;: 4444,
&quot;hubHost&quot;: &quot;&lt;grid-hostname&gt;&quot;,
&quot;hubProtocol&quot;: &quot;http&quot;
}
}
</code></pre></div></li>
<li>add <code>appium-startup.cmd</code> to Appium's installation directory
<p><a href="https://www.selenium.dev/documentation/grid/" class="externalLink">Selenium Grid</a> 4 is required.</p>
<p>See <a href="https://www.selenium.dev/documentation/grid/getting_started/" class="externalLink">https://www.selenium.dev/documentation/grid/getting_started/</a></p>
<p>After downloading the apropriate JAR, starting a standalone grid is done via:</p>

<div class="verbatim">
<pre><code class="language-shell">appium.cmd --nodeconfig %APPDATA%\npm\nodeconfig.json ^
--log %APPDATA%\npm\appium.log ^
--log-timestamp ^
--log-level error:debug ^
--log-no-colors
</code></pre></div></li>
</ol></li>
<li>add Appium to Windows' Start-up Tasks:
<pre><code class="language-shell">java -jar selenium-server-&lt;version&gt;.jar standalone --selenium-manager true
</code></pre></div>
<p>The grid's UI should be available at <a href="http://localhost:4444/ui/" class="externalLink">http://localhost:4444/ui/</a></p>
<p>Assuming Google Chrome and/or Mozilla Firefox are installed, these will become
available for automation via the grid.</p></section><section>
<h2>Appium</h2>
<p><a href="https://appium.io/docs/en/2.5/" class="externalLink">Appium 2</a> is required.</p>
<p>See <a href="https://appium.io/docs/en/2.5/quickstart/install/" class="externalLink">https://appium.io/docs/en/2.5/quickstart/install/</a></p>
<ol style="list-style-type: decimal;">

<li>open <code>%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup</code></li>
<li>create shortcut to <code>appium-startup.cmd</code></li>
<li>run it</li>
</ol>
<blockquote>

<p>Open the Selenium Grid Console to ensure proper registration.</p>
</blockquote></li>
<li><code>choco install -y nodejs</code> &#x2013; and restart the console to refresh the env vars</li>
<li><code>npm --proxy http(s)://&lt;host&gt;:&lt;port&gt; install -g appium</code></li>
<li><code>npm --proxy http(s)://&lt;host&gt;:&lt;port&gt; update -g appium</code></li>
<li><code>appium</code> - configuration files will be scanned from working dir upwards</li>
</ol></section><section>
<h2>Mobile Testing</h2><section>
<h3>Android Emulator</h3>
@@ -241,10 +185,13 @@ <h3>Android Emulator</h3>
</blockquote>
<ol style="list-style-type: decimal;">

<li><code>choco install -y jdk8</code> &#x2013; is required for current <code>android-sdk</code></li>
<li><code>choco install -y android-sdk</code></li>
<li><code>cd %ANDROID_HOME%</code></li>
<li><code>.\tools\bin\sdkmanager.bat --no_https --proxy=http --proxy_host=&lt;host&gt; --proxy_port=&lt;port&gt; --install &quot;system-images;android-30;google_apis_playstore;x86&quot;</code></li>
<li><code>.\tools\bin\sdkmanager.bat --no_https --proxy=http --proxy_host=&lt;host&gt; --proxy_port=&lt;port&gt; --install &quot;platform-tools&quot;</code></li>
<li><code>.\tools\bin\sdkmanager --no_https --proxy=http --proxy_host=&lt;host&gt; --proxy_port=&lt;port&gt; --install &quot;platform-tools&quot;</code></li>
<li><code>.\tools\bin\sdkmanager --no_https --proxy=http --proxy_host=&lt;host&gt; --proxy_port=&lt;port&gt; --install &quot;system-images;android-30;google_apis_playstore;x86_64&quot;</code></li>
<li><code>.\tools\bin\avdmanager create avd --name &quot;google_apis_playstore&quot; --package &quot;system-images;android-30;google_apis_playstore;x86_64&quot;</code></li>
<li><code>.\tools\emulator @google_apis_playstore</code></li>
</ol>
<blockquote>

@@ -261,19 +208,30 @@ <h3>iOS Simulator</h3>
<p>For hybrid applications, check DOM Inspector connects to application
via <a href="chrome://inspect/#devices" class="externalLink">chrome://inspect/#devices</a></p></section></section><section>
<h2>Windows Applications Testing</h2>
<p>Since Selenium 4 it is no longer possible to access WinAppDriver directly,
and Appium 2 is required to act as a bridge in between.</p>
<ol style="list-style-type: decimal;">

<li>Enable Windows Developer Mode</li>
<li><code>choco install -y winappdriver</code>
<li><code>appium driver install --source=npm appium-windows-driver</code></li>
<li><code>appium</code> - start/restart; should list <code>windows@2.12.21 (automationName ' Windows')</code>
<blockquote>

<p>Now, <strong>WinAppDriver</strong> should be
at <code>%ProgramFiles(x86)%\Windows Application Driver</code>.</p>
<p>The endpoint should be available at <a href="http://127.0.0.1:4723" class="externalLink">http://127.0.0.1:4723</a>.</p>
</blockquote></li>
<li>for GUI element discovery &#x2013;
<a href="https://github.com/microsoft/WinAppDriver/releases/tag/UIR-v1.1" class="externalLink">https://github.com/microsoft/WinAppDriver/releases/tag/UIR-v1.1</a> or similar
tool</li>
<li>optional: install Appium Inspector &#x2013;
<a href="https://appium.github.io/appium-inspector/latest/quickstart/installation/" class="externalLink">https://appium.github.io/appium-inspector/latest/quickstart/installation/</a></li>
<li>optional: check the setup by starting a session using a profile like this:</li>
</ol>

<div class="verbatim">
<pre><code class="language-json">{
&quot;appium:automationName&quot;: &quot;windows&quot;,
&quot;appium:platformName&quot;: &quot;windows&quot;,
&quot;appium:app&quot;: &quot;Microsoft.WindowsCalculator_8wekyb3d8bbwe!App&quot;
}
</code></pre></div>
<p><code>mvn verify -Ptesting-windows</code> should lauch the Calculator test.</p>
<p>If remote file access is required, then OpenSSH, or similar, is required:</p>
<p><code>Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0</code></p></section><section>
<h2>Running GUI Tests on a Remote Windows Machine</h2>
Loading

0 comments on commit 637457f

Please sign in to comment.