Skip to content

Latest commit

 

History

History
61 lines (40 loc) · 2.86 KB

CONTRIBUTING.md

File metadata and controls

61 lines (40 loc) · 2.86 KB
Raw

Developer instructions

How to build and run

Build and run using CLI

  1. Clone this repo to your local machine
  2. Build the solution by executing build.bat in Windows or ./build.bat in Git Bash
  3. Run it by executing run.bat in Windows or ./run.bat in Git Bash
  4. Go to http://localhost:8080/KitchenSink

Build and run using Visual Studio

  1. Clone this repo to your local machine
  2. Open the .sln file in Visual Studio
  3. Build and run it using Debug in Visual Studio (Debug > Start debugging or F5)
  4. Go to http://localhost:8080/KitchenSink

Contributing code

To contribute code to this repository, follow the instructions in the guidelines.

How to release a package

To release the app to the warehouse, follow the instructions in the guidelines.

Testing

Prepare your environment

Before running the steps, you need to:

  • Download and install Visual Studio 2017 to run the tests
  • Download and install Java, required by Selenium Standalone Server
  • Download Selenium Standalone Server and the drivers [Microsoft WebDriver (Edge), Google ChromeDriver (Chrome) and Mozilla GeckoDriver (Firefox)] using these instructions.
  • Add path to the folder with drivers to system path on your computer

Run the test (from Visual Studio)

  1. Start Selenium Remote Driver: java -jar selenium-server-standalone-3.*.jar
  2. Open KitchenSink.sln in Visual Studio and enable Test Explorer (Test > Window > Test Explorer)
  3. You need to install NUnit 3 Test Adapter in VS (Tools > Extensions and Updates... > Online) in order to see tests in Test Explorer window
  4. Start the KitchenSink app
  5. Press "Run all" in Test Explorer
    • If you get an error about some packages not installed, right click on the project in Solution Explorer. Choose "Manage NuGet Packages" and click on "Restore".

Run the test (from command line)

  1. Start Selenium Remote Driver with the enablePassThrough option off: java -jar selenium-server-standalone-3.*.jar -enablePassThrough false
  2. Build the solution (build.bat)
  3. Start the KitchenSink.Test runner (test.bat)

To run a specific test, add the param --test="<testname>".

To connect to a remote web driver on a different host, add the param --params="Server=<Uri>"

To run in a specific browser, add the param --params="Browsers=<BrowserName>" (case sensitive). Possible values: Chrome, Firefox, Edge (separated by a comma).

test --params="Server=http://192.168.1.49:4444/wd/hub" --params="Browsers=Chrome" --test="KitchenSink.Tests.Test.TextareaPageTest(Chrome).TextareaPage_WriteToTextArea"