Skip to content

docs: Document the migration guide from v9 to v10 #2331

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Aug 13, 2025
+22 −0
Merged

docs: Document the migration guide from v9 to v10 #2331

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
6b0c5bd
docs: Document the migration guide from v9 to v10
mykola-mokhnach Aug 13, 2025
e0c1e4c
link the guide
mykola-mokhnach Aug 13, 2025
add55e3
line break
mykola-mokhnach Aug 13, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,11 @@

This is the Java language bindings for writing Appium Tests that conform to [WebDriver Protocol](https://w3c.github.io/webdriver/)


## v9 to v10 Migration

Follow the [v9 to v10 Migration Guide](./docs/v9-to-v10-migration-guide.md) to streamline the migration process.

## v8 to v9 Migration

Since v9 the client only supports Java 11 and above.
Expand Down
17 changes: 17 additions & 0 deletions docs/v9-to-v10-migration-guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
This is the list of main changes between major versions 9 and 10 of Appium
java client. This list should help you to successfully migrate your
existing automated tests codebase.


## The minimum supported Selenium version is set to 4.35.0

- Selenium versions below 4.35.0 won't work with Appium java client 10+.
Check the [Compatibility Matrix](../README.md#compatibility-matrix) for more
details about versions compatibility.

## Removed previously deprecated items

- `org.openqa.selenium.remote.html5.RemoteLocationContext`, `org.openqa.selenium.html5.Location` and
`org.openqa.selenium.html5.LocationContext` imports have been removed since they don't exist
in Selenium lib anymore. Use appropriate replacements from this library instead for APIs and
interfaces that were using deprecated classes, like `io.appium.java_client.Location`.