feat: Control the visibility of the Tab Bar and Smart App Banner

[zcmgyu]

Description

I attempt to click a web element on iPad with nativeWebTap and nativeWebTapStrict are enabled. Because of the existence of too many elements on the screen, it took me about 40 seconds to click that element. I figured out that finding the existence of tab bar and smart app banner for measuring offset takes almost time. So I thought that being able to control this through the Settings API would help.
After this PR, it takes me 10 seconds to click that element.

This feature may help bypass this issue: appium/appium#14988

Type of change

• New feature (non-breaking change which adds functionality)
• This change requires a documentation update

Usage

• If the tab bar is visible and there is no smart app banner.

driver.setSettings(new HashMap<>() {{
      put("nativeWebTap", true);
      put("nativeWebTapStrict", true);
      put("nativeWebTapTabBarVisibility", "visible");
      put("nativeWebTapSmartAppBannerVisibility", "invisible");
}});

• If you want to leave Appium check the existence of tab bar and smart app banner

driver.setSettings(new HashMap<>() {{
      put("nativeWebTap", true);
      put("nativeWebTapStrict", true);
      put("nativeWebTapTabBarVisibility", "detect");
      put("nativeWebTapSmartAppBannerVisibility", "detect");
}});

• Read more about usage in the document.

Test Configuration:

• Appium: 1.23.0-beta.0
• NodeJS: v14.18.1
• MacOS: 11.5

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented on my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes

[zcmgyu]

Actually, the smart app banner is not visible.

[zcmgyu]

This feature may help bypass this issue: appium/appium#14988

[zcmgyu]

Updated description and title as well.

[github-actions]

🎉 This PR is included in version 3.56.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀