BREAKING CHANGE: AndroidDriver to use modern mobile: commands for Lock, IsLocked and Unlock

[Dor-bl]

List of changes

• Replaced deprecated JSONWP commands with mobile: lock, mobile: isLocked, and mobile: unlock extensions.
• Updated the Lock method to accept an optional seconds parameter for auto-unlock functionality.
• Updated the Unlock method to support required key and type parameters, with optional strategy and timeoutMs arguments.
• Improved code robustness with null checks and parameter validation.

Types of changes

What types of changes are you proposing/introducing to the .NET client?
Put an x in the boxes that apply

• Bugfix (non-breaking change which fixes an issue)
• New feature (non-breaking change that adds functionality or value)
• Breaking change (fix or feature that would cause existing functionality not to work as expected)
• Test fix (non-breaking change that improves test stability or correctness)

Documentation

• Have you proposed a file change/ PR with Appium to update documentation?

This can be done by navigating to the documentation section on http://appium.io selecting the appropriate command/endpoint and clicking the 'Edit this doc' link to update the C# example

Integration tests

• Have you provided integration tests for your changes? (required for Bugfix, New feature, or Test fix)

Details

Please provide more details about changes if necessary. You can provide code samples showing how they work and possible use cases if there are new features. Also, you can create gists with pasted C# code samples or put them here using markdown.
About markdown please read Mastering markdown and Writing on GitHub

[KazuCocoa]

You could add try/except and fallback to the legacy one like https://github.com/appium/python-client/blob/e4f06abf1f6bc302bde373071d1e3c007a67c03a/appium/webdriver/extensions/hw_actions.py#L40-L47 does. Then, maybe the change doesn't need to be a "breaking" one since the existing one will do the same

[Dor-bl]

The "breaking" is more for the unlock method that now requires additional parameters

[Dor-bl]

I also see there is a a todo on that fallback
https://github.com/appium/python-client/blob/e4f06abf1f6bc302bde373071d1e3c007a67c03a/appium%2Fwebdriver%2Fextensions%2Fhw_actions.py#L45
So isn't it redundant?

[KazuCocoa]

Yea, the todo is correct. We haven't decided when we completely remove them, though. I'm good either, just I brought up the idea here

[KazuCocoa]

lgtm.

Perhaps it would be nice to include similar breaking changes in one release if we have others

[Dor-bl]

I'll try to find some time, sure