You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Jul 10, 2024. It is now read-only.
Once the installion is done, the plugin needs to be activated each time when the appium server is started using below command
31
31
32
32
```sh
33
-
appium --plugins=appium-dashboard
33
+
appium --use-plugin=appium-dashboard
34
34
```
35
35
36
36
Now navigate to `http://localhost:4723/dashboard` to open the client web app which will show the complete list of tests and its details that are being executed.
@@ -40,24 +40,28 @@ NOTE: This plugin is still in beta phase and heavy testing is being done to elim
40
40
## Troubleshooting
41
41
42
42
### Migrating from 1.x to 2.0
43
+
43
44
If you are migrating from 1.0 to 2.0 to try out this plugin, be aware that 2.0 has breaking changes as listed below.
If your tests stop working, you may think that it has got something to do with this plugin, but maybe it is not.
47
49
48
-
To fix/rule out the breaking changes due to 2.0; you have to make the below two minor changes in your code, for it to continue working on both 1.x and 2.0.
49
-
- Run this command `appium --base-path /wd/hub` to start the server (assuming your baseURL in 1.2 has /wd/hub as a part of hostURl)
- A quote From appium 2.0 `With Appium 2.0, the Appium server will enforce strict compability with the W3C WebDriver specification when it comes to Capabilities`
52
-
. Which means the existing appium capabilities are not supported in 2.0 and there are a couple of "easy" workarounds that users can do
53
-
to make tests run in both 2.0 and 1.x. For example, if you run your tests and you get an error similar to below.
54
-
`org.openqa.selenium.SessionNotCreatedException: Unable to create a new remote session. Please check the server log for more details. Original error: All non-standard capabilities should have a vendor prefix. The following capabilities did not have one: systemPort `.
55
-
You can prefix `appium:` in front of the capability and your tests should work fine. For example, in above case adding appium in front of systemPort `capabilities.setCapability("appium:systemPort ", 8200);`, fixes
56
-
the issue and tests run fine.
50
+
To fix/rule out the breaking changes due to 2.0; you have to make the below two minor changes in your code, for it to continue working on both 1.x and 2.0.
51
+
52
+
- Run this command `appium --base-path /wd/hub` to start the server (assuming your baseURL in 1.2 has /wd/hub as a part of hostURl)
- A quote From appium 2.0 `With Appium 2.0, the Appium server will enforce strict compability with the W3C WebDriver specification when it comes to Capabilities`
55
+
. Which means the existing appium capabilities are not supported in 2.0 and there are a couple of "easy" workarounds that users can do
56
+
to make tests run in both 2.0 and 1.x. For example, if you run your tests and you get an error similar to below.
57
+
`org.openqa.selenium.SessionNotCreatedException: Unable to create a new remote session. Please check the server log for more details. Original error: All non-standard capabilities should have a vendor prefix. The following capabilities did not have one: systemPort `.
58
+
You can prefix `appium:` in front of the capability and your tests should work fine. For example, in above case adding appium in front of systemPort `capabilities.setCapability("appium:systemPort ", 8200);`, fixes
59
+
the issue and tests run fine.
57
60
58
61
Once you have ruled out issues due to 1.0 to 2.0 migration, you can then:
62
+
59
63
- Close the server that you started without loading plugin above `appium --base-path /wd/hub`.
60
64
- Now run the server with plugin loaded as `appium --base-path /wd/hub --plugins=appium-dashboard`
61
65
- Open the dashboard `http://localhost:4723/dashboard`
62
66
- Run the tests again and if you now get any errors, there is now a high probability that you have found an issue with the dashboard-plugin.
63
-
- In that case, report it on the issues page of this repository: https://github.com/sudharsan-selvaraj/appium-dashboard-plugin/issues
67
+
- In that case, report it on the issues page of this repository: https://github.com/sudharsan-selvaraj/appium-dashboard-plugin/issues
0 commit comments