chore: publish

- appium@2.12.1 - @appium/base-driver@9.12.1 - @appium/base-plugin@2.2.47 - @appium/doctor@2.1.13 - @appium/docutils@1.0.23 - @appium/driver-test-support@0.6.11 - @appium/fake-plugin@3.1.51 - @appium/images-plugin@3.0.21 - @appium/support@5.1.6 - @appium/test-support@3.0.51
chore(deps): update dependency @types/node to v20.17.0 (#20695 )
2026-11-14 06:44:19 +08:00 · 2024-10-24 12:04:12 -07:00 · 2024-10-24 09:07:03 +02:00 · 2024-10-23 12:34:55 +02:00 · 2024-10-23 12:34:36 +02:00 · 2024-10-23 10:19:07 +00:00
67 changed files with 1014 additions and 1186 deletions
@@ -44,7 +44,7 @@ jobs:
          useRollingCache: true
          install-command: npm ci
      - name: Install dependencies (Python)
-        run: pip install -r packages/docutils/requirements.txt
+        run: PIP_BREAK_SYSTEM_PACKAGES=1 pip install -r packages/docutils/requirements.txt
      - name: Configure Git User
        run: |
          git config --local user.email "github-actions[bot]@users.noreply.github.com"
@@ -31,7 +31,7 @@ jobs:
        useRollingCache: true
        install-command: npm ci
    - name: Install dependencies (Python)
-      run: pip install -r packages/docutils/requirements.txt
+      run: PIP_BREAK_SYSTEM_PACKAGES=1 pip install -r packages/docutils/requirements.txt
    - name: Publish docs
      run: |
        cd packages/appium
@@ -194,11 +194,6 @@ rely on. [Become a sponsor](https://opencollective.com/appium) via our OpenColle
 Appium is incredibly grateful to our Development and Strategic Partners for their sustained
 contribution of project development and leadership!

-<p align="center">
-  <a href="https://www.headspin.io/solutions/appium-mobile-test-automation"><img src="packages/appium/docs/overrides/assets/images/sponsor-logo-headspin.png"
-width="275" alt="HeadSpin" /></a>
-</p>
-
 <p align="center">
  <a href="https://www.browserstack.com/browserstack-appium?utm_campaigncode=701OW00000AoUTQYA3&utm_medium=partnered&utm_source=appium">
    <picture>
@@ -216,7 +211,7 @@ width="300" alt="Sauce Labs" /></a>

 ### Other Sponsors

-A full list of sponsors is available at our [Sponsors page](SPONSORS.md).
+A full list of sponsors is available at our [Sponsors page](https://appium.io/docs/en/latest/sponsors/).

 ## License

@@ -1,48 +1,3 @@
 # Sponsors & Backers

-Appium is an Apache-2 licensed open source project whose development is made possible entirely by
-donations of time and money by individuals and companies who benefit from our software and our
-mission. If you'd like to join this amazing group and help ensure Appium's continued development
-and maintenance, you can contribute via [Appium's OpenCollective
-Hub](https://opencollective.com/appium).
-
-## Development Partners
-
-We are very grateful for the support of our Development Partners, who donate Appium development and
-maintenance as part of their employees' core job duties!
-
-<a href="https://www.headspin.io/solutions/appium-mobile-test-automation" target="_blank"><img
-src="packages/appium/docs/overrides/assets/images/sponsor-logo-headspin.png" width="250"/></a>
-
-## Strategic Partners
-
-We are very grateful for the financial and marketing support of our exclusive Strategic Partners,
-who contribute a significant ongoing investment of funds to help the project attract and reward
-contributors!
-
-<a href="https://www.browserstack.com/browserstack-appium?utm_campaigncode=701OW00000AoUTQYA3&utm_medium=partnered&utm_source=appium">
-  <picture>
-    <source srcset="packages/appium/docs/overrides/assets/images/sponsor-logo-browserstack-dark.png" media="(prefers-color-scheme: dark)"/>
-    <source srcset="packages/appium/docs/overrides/assets/images/sponsor-logo-browserstack-light.png" media="(prefers-color-scheme: light)"/>
-    <img src="packages/appium/docs/overrides/assets/images/sponsor-logo-browserstack-dark.png" width="250" alt="Browserstack"/>
-  </picture>
-</a>
-<a style="padding-left: 1em" href="https://saucelabs.com/resources/blog/appium-strategic-partner" target="_blank"><img src="packages/appium/docs/overrides/assets/images/sponsor-logo-sauce.png" width="250"/></a>
-
-## Gold Sponsors
-
-<a href="https://opencollective.com/appium" target="_blank"><img src="https://opencollective.com/appium/tiers/gold-sponsor.svg?avatarHeight=100&button=false&random=1"/></a>
-
-[Become a Gold Sponsor](https://opencollective.com/appium/contribute/gold-sponsor-72877/checkout?interval=month&amount=500&contributeAs=me)
-
-## Silver Sponsors
-
-<a href="https://opencollective.com/appium" target="_blank"><img src="https://opencollective.com/appium/tiers/silver-sponsor.svg?avatarHeight=80&button=false&random=1"/></a>
-
-[Become a Silver Sponsor](https://opencollective.com/appium/contribute/silver-sponsor-72876/checkout?interval=month&amount=250&contributeAs=me)
-
-## Bronze Sponsors
-
-<a href="https://opencollective.com/appium" target="_blank"><img src="https://opencollective.com/appium/tiers/sponsors.svg?avatarHeight=60&button=false&random=1"/></a>
-
-[Become a Bronze Sponsor](https://opencollective.com/appium/contribute/sponsors-70690/checkout?interval=month&amount=100&contributeAs=me)
+Please check [Sponsors & Backers](https://appium.io/docs/en/latest/sponsors/)
@@ -86,9 +86,9 @@
    "@tsconfig/node14": "14.1.2",
    "@types/chai": "5.0.0",
    "@types/chai-as-promised": "8.0.1",
-    "@types/diff": "5.2.2",
-    "@types/mocha": "10.0.8",
-    "@types/node": "20.16.9",
+    "@types/diff": "5.2.3",
+    "@types/mocha": "10.0.9",
+    "@types/node": "20.17.0",
    "@types/semver": "7.5.8",
    "@types/sinon": "17.0.3",
    "@types/sinon-chai": "4.0.0",
@@ -99,15 +99,15 @@
    "@typescript-eslint/eslint-plugin": "7.18.0",
    "@typescript-eslint/parser": "7.18.0",
    "asyncbox": "3.0.0",
-    "chai": "5.1.1",
+    "chai": "5.1.2",
    "chai-as-promised": "8.0.0",
    "conventional-changelog-conventionalcommits": "7.0.2",
    "cpy-cli": "5.0.0",
    "eslint": "8.57.1",
    "eslint-config-prettier": "9.1.0",
-    "eslint-find-rules": "4.1.0",
+    "eslint-find-rules": "4.2.0",
    "eslint-import-resolver-typescript": "3.6.3",
-    "eslint-plugin-import": "2.30.0",
+    "eslint-plugin-import": "2.31.0",
    "eslint-plugin-mocha": "10.5.0",
    "eslint-plugin-promise": "6.6.0",
    "finalhandler": "1.3.1",
@@ -119,7 +119,7 @@
    "mjpeg-consumer": "2.0.0",
    "mjpeg-server": "0.3.1",
    "mocha": "10.7.3",
-    "npm-run-all2": "6.2.3",
+    "npm-run-all2": "6.2.6",
    "prettier": "3.3.3",
    "rewiremock": "3.14.5",
    "rimraf": "5.0.10",
@@ -128,9 +128,9 @@
    "sync-monorepo-packages": "1.0.2",
    "ts-node": "10.9.2",
    "tsd": "0.31.2",
-    "typescript": "5.6.2",
+    "typescript": "5.6.3",
    "validate.js": "0.13.1",
-    "webdriverio": "8.40.5",
+    "webdriverio": "8.40.6",
    "ws": "8.18.0",
    "yaml-js": "0.3.1"
  },
@@ -3,6 +3,33 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

+## [2.12.1](https://github.com/appium/appium/compare/appium@2.12.0...appium@2.12.1) (2024-10-24)
+
+
+### Bug Fixes
+
+* **docutils:** restore support for Python <3.12 ([#20675](https://github.com/appium/appium/issues/20675)) ([00cd1b4](https://github.com/appium/appium/commit/00cd1b4b0fcf24d0014dac780223e5866f39c9ce))
+* **support:** update definitelytyped ([#20691](https://github.com/appium/appium/issues/20691)) ([846dd52](https://github.com/appium/appium/commit/846dd5288608d886f924d2791291475c956d53f7))
+
+
+
+## [2.12.0](https://github.com/appium/appium/compare/appium@2.11.5...appium@2.12.0) (2024-10-15)
+
+
+### Features
+
+* **appium:** Make server graceful shutdown timeout configurable via command line args ([#20641](https://github.com/appium/appium/issues/20641)) ([5661888](https://github.com/appium/appium/commit/56618886ed007df3c28ce98beb4ff91bc47da2a2))
+
+
+### Bug Fixes
+
+* **appium:** update dependency winston to v3.15.0 ([ab12235](https://github.com/appium/appium/commit/ab12235483262a1c5a1dd8a32b1792a4b096bfc6))
+* **docutils:** support Python 3.12+ ([#20666](https://github.com/appium/appium/issues/20666)) ([8d7cec9](https://github.com/appium/appium/commit/8d7cec96d8df60644493a7e2f735b4bb0d3783be))
+* **docutils:** update dependency yaml to v2.6.0 ([ed6c6dd](https://github.com/appium/appium/commit/ed6c6dd5441e26fc1eb58de9b78def49d930a128))
+* **execute-driver-plugin:** update dependency webdriverio to v8.40.6 ([796ca9f](https://github.com/appium/appium/commit/796ca9f98f69616b9c890325bbfb0c573a8bc765))
+
+
+
 ## [2.11.5](https://github.com/appium/appium/compare/appium@2.11.4...appium@2.11.5) (2024-09-26)


@@ -194,11 +194,6 @@ rely on. [Become a sponsor](https://opencollective.com/appium) via our OpenColle
 Appium is incredibly grateful to our Development and Strategic Partners for their sustained
 contribution of project development and leadership!

-<p align="center">
-  <a href="https://www.headspin.io/solutions/appium-mobile-test-automation"><img src="packages/appium/docs/overrides/assets/images/sponsor-logo-headspin.png"
-width="275" alt="HeadSpin" /></a>
-</p>
-
 <p align="center">
  <a href="https://www.browserstack.com/browserstack-appium?utm_campaigncode=701OW00000AoUTQYA3&utm_medium=partnered&utm_source=appium">
    <picture>
@@ -216,7 +211,7 @@ width="300" alt="Sauce Labs" /></a>

 ### Other Sponsors

-A full list of sponsors is available at our [Sponsors page](SPONSORS.md).
+A full list of sponsors is available at our [Sponsors page](https://appium.io/docs/en/latest/sponsors/).

 ## License

@@ -44,6 +44,8 @@ These drivers are not maintained by the Appium team and can be used to target ad
 |[Tizen](https://github.com/Samsung/appium-tizen-driver)|`--source=npm appium-tizen-driver`|Android|Native|Community / Samsung|
 |[TizenTV](https://github.com/headspinio/appium-tizen-tv-driver)|`--source=npm appium-tizen-tv-driver`|Samsung TV|Web|HeadSpin|
 |[Youi](https://github.com/YOU-i-Labs/appium-youiengine-driver)|`--source=npm appium-youiengine-driver`|iOS, Android, macOS, Linux, tvOS|Native|Community / You.i|
+|[axe UiAutomator2](https://docs.deque.com/devtools-mobile/appium-setup)|`--source=npm @axe-devtools/axe-appium-uiautomator2-driver`|Android|Native|[Deque](https://www.deque.com)|
+|[axe XCUITest](https://docs.deque.com/devtools-mobile/appium-setup)|`--source=npm @axe-devtools/axe-appium-xcuitest-driver`|iOS|Native|[Deque](https://www.deque.com)|

 !!! note

@@ -12,6 +12,13 @@ title: Welcome
  }
 </style>

+<div style="text-align:center;width:100%;background-color:#ec366d;margin-top:-3em;margin-bottom:2em;">
+  <h3 style="color:#ffffff;padding: 8px;">
+    AppiumConf 2025 is partnering with SeleniumConf<br/> <span style="font-size:0.8em;">March 26-28 in Valencia, Spain. Join us to learn and connect with the community!<span><br/>
+    <a style="color:#fcba12" href="https://seleniumconf.com/" target="_blank">Register Now</a>
+  </h3>
+</div>
+
 <div style="text-align: center">
  <img src="assets/images/appium-logo-horiz.png" style="max-width: 400px;" />
 </div>
@@ -27,11 +34,6 @@ Android TV, Samsung), and more!
  sponsorship program and contributor compensation scheme <a
  href="https://github.com/appium/appium/blob/master/GOVERNANCE.md#sponsorship">here</a>)
  <div class="homepageSponsors">
-    <div class="homepageSponsor">
-      <a href="https://www.headspin.io/solutions/appium-mobile-test-automation">
-        <img src="assets/images/sponsor-logo-headspin.png" style="width: 200px;" />
-      </a>
-    </div>
    <div class="homepageSponsor">
      <a href="https://www.browserstack.com/browserstack-appium?utm_campaigncode=701OW00000AoUTQYA3&utm_medium=partnered&utm_source=appium">
        <img src="assets/images/sponsor-logo-browserstack-dark.png#only-dark" style="width: 220px;" />
@@ -137,8 +137,8 @@ already had well over 1,000 commits.
 Appium began to grow and mature significantly. In May 2014,
 we released Appium 1.0, which stood as a milestone in Appium's development.
 Appium was given
-[various](http://sauceio.com/index.php/2014/01/appium-selected-as-a-black-duck-open-source-rookie-of-the-year/)
-[awards](http://sauceio.com/index.php/2014/10/appium-wins-a-bossy-award-from-infoworld/)
+[various](https://www.prnewswire.com/news-releases/black-duck-announces-black-duck-open-source-rookies-of-the-year-winners-242383341.html)
+[awards](https://www.infoworld.com/article/2241247/164642-bossie-awards-2014-the-best-open-source-application-development-tools.html)
 and became the most popular open-source cross-platform mobile automation
 framework. Stability improved, bugs were prioritized and fixed, and features
 added. Sauce Labs increased the number of developers it donated to working
@@ -22,7 +22,7 @@ According to the driver, in addition to a working Appium server, we also need to
 ### Android SDK

 - The easiest way to set up the Android SDK requirements is by downloading [Android Studio](https://developer.android.com/studio).
-We need to use its SDK manager (_Settings -> Appearance & Behavior -> System Settings -> Android SDK_)
+We need to use its SDK manager (_Settings -> Languages & Frameworks -> Android SDK_)
 to download the following items:
    - Android SDK Platform (select whichever Android platform we want to automate, for example, API level 30)
    - Android SDK Platform-Tools
@@ -0,0 +1,60 @@
+---
+hide:
+  - navigation
+  - toc
+
+title: Sponsors & Backers
+---
+
+<style>
+  .appium-sponsor-thanks { display: none; }
+  .sponsor-section img { height: 64px; padding-right: 1em; }
+</style>
+
+Appium is an Apache-2 licensed open source project whose development is made possible entirely by
+donations of time and money by individuals and companies who benefit from our software and our
+mission. If you'd like to join this amazing group and help ensure Appium's continued development
+and maintenance, you can contribute via [Appium's OpenCollective
+Hub](https://opencollective.com/appium).
+
+## Development Partners
+
+We are very grateful for the support of our Development Partners, who donate Appium development and
+maintenance as part of their employees' core job duties!
+
+## Strategic Partners
+
+We are very grateful for the financial and marketing support of our exclusive Strategic Partners,
+who contribute a significant ongoing investment of funds to help the project attract and reward
+contributors!
+
+<a href="https://www.browserstack.com/browserstack-appium?utm_campaigncode=701OW00000AoUTQYA3&utm_medium=partnered&utm_source=appium">
+  <picture>
+    <source srcset="../assets/images/sponsor-logo-browserstack-dark.png" media="(prefers-color-scheme: dark)"/>
+    <source srcset="../assets/images/sponsor-logo-browserstack-light.png" media="(prefers-color-scheme: light)"/>
+    <img src="../assets/images/sponsor-logo-browserstack-dark.png" width="250" alt="Browserstack"/>
+  </picture>
+</a>
+<a style="padding-left: 1em" href="https://saucelabs.com/resources/blog/appium-strategic-partner" target="_blank"><img src="../assets/images/sponsor-logo-sauce.png" width="250"/></a>
+
+## Gold Sponsors
+
+<a href="https://opencollective.com/appium" target="_blank"><img src="https://opencollective.com/appium/tiers/gold-sponsor.svg?avatarHeight=100&button=false&random=1"/></a>
+
+[Become a Gold Sponsor](https://opencollective.com/appium/contribute/gold-sponsor-72877/checkout?interval=month&amount=500&contributeAs=me)
+
+## Silver Sponsors
+
+<a href="https://opencollective.com/appium" target="_blank"><img src="https://opencollective.com/appium/tiers/silver-sponsor.svg?avatarHeight=80&button=false&random=1"/></a>
+
+[Become a Silver Sponsor](https://opencollective.com/appium/contribute/silver-sponsor-72876/checkout?interval=month&amount=250&contributeAs=me)
+
+## Bronze Sponsors
+
+<div class="sponsor-section">
+  <a href="https://magicpod.com/" target="_blank"><img src="https://images.opencollective.com/magicpod/722b7e4/avatar/64.png" alt="MagicPod" /></a>
+  <a href="https://route4me.com/" target="_blank"><img src="../assets/images/sponsor-logo-route4me.png" alt="Route Planning and Route Mapping" /></a>
+  <a href="https://webdriver.io/" target="_blank"><img src="https://images.opencollective.com/webdriverio/bbdd6c3/logo/64.png" alt="WebdriverIO" /></a>
+</div>
+
+[Become a Bronze Sponsor](https://opencollective.com/appium/contribute/sponsors-70690/checkout?interval=month&amount=100&contributeAs=me)
@@ -75,3 +75,4 @@ nav:
      - Developer Reference:
          - developing/config-system.md
  - Contributing: contributing.md
+  - Sponsors: sponsors.md
@@ -1,10 +1,6 @@
 <div class="appium-sponsor-thanks">
  Supported by

-  <a href="https://www.headspin.io/solutions/appium-mobile-test-automation">
-    <img src="/docs/en/latest/assets/images/sponsor-logo-headspin.png" />
-  </a>
-
  <a href="https://www.browserstack.com/browserstack-appium?utm_campaigncode=701OW00000AoUTQYA3&utm_medium=partnered&utm_source=appium">
    <img src="/docs/en/latest/assets/images/sponsor-logo-browserstack-dark.png" />
  </a>
@@ -76,7 +76,7 @@ Our documentation system uses [MKDocs](https://www.mkdocs.org/) and therefore re

 ```sh
 # installing needed Python dependencies
-pip install -r packages/docutils/requirements.txt
+PIP_BREAK_SYSTEM_PACKAGES=1 pip install -r packages/docutils/requirements.txt
 # build the project
 npm run build
 # run dev server
@@ -2,41 +2,37 @@
 hide:
  - toc

-title: Appium Clients
+title: Appium客户端
 ---

-You need a client to write and run Appium scripts. You'll want to become very
-familiar with your client documentation (as well as the documentation of any Selenium client that
-the Appium client depends on) since that will be your primary interface to Appium.
+您需要一个客户端来编写和运行Appium脚本。您需要非常熟悉您的客户端文档（以及Appium客户端所依赖的任何Selenium客户端的文档），因为这将是您与Appium的主要接口。

-To learn more about clients, read our [Client Intro](../intro/clients.md).
+要了解更多关于客户端的信息，请阅读我们的[客户端简介](../intro/clients.md)。

-### Official Clients
+### 官方客户端

-These clients are currently maintained by the Appium team:
+这些客户端目前由Appium团队维护：

-|Client|Language|
+|客户端|编程语言|
 |-|-|
 |[Appium Java client](https://github.com/appium/java-client)|Java|
 |[Appium Python client](https://github.com/appium/python-client)|Python|
 |[Appium Ruby Core client](https://github.com/appium/ruby_lib_core) (Recommended)<br>[Appium Ruby client](https://github.com/appium/ruby_lib)|Ruby|
 |[Appium .NET client](https://github.com/appium/dotnet-client)|C#|

-### Other Clients
+### 其他客户端

-These clients are not maintained by the Appium team and can be used with other languages:
+这些客户端不由Appium团队维护，可以与其他语言一起使用：

-|Client|Language|
+|客户端|编程语言|
 |-|-|
 |[WebdriverIO](https://webdriver.io/docs/appium)|Node.js|
 |[Nightwatch.js](https://nightwatchjs.org/guide/mobile-app-testing/introduction.html)|Node.js|
 |[RobotFramework](https://github.com/serhatbolsu/robotframework-appiumlibrary)|DSL|
 |[multicatch's appium-client](https://github.com/multicatch/appium-client)|Rust|

-In general, any W3C WebDriver spec-compatible client will also integrate well with Appium, though
-some Appium-specific commands may not be implemented in other clients.
+一般来说，任何兼容W3C WebDriver规范的客户端，也可以和Appium很好地集成，尽管某些Appium特定的命令可能无法在其他客户端中实现。

-!!! note
+!!! 注意

-    If you maintain an Appium client that you would like to be listed in the Appium docs, feel free
-    to make a PR to add it to this section with a link to the documentation for the client.
+    如果您维护了一个Appium客户端，并希望在Appium文档中列出，请随时进行PR，将其添加到本部分，并附上客户端文档的链接。
@@ -2,24 +2,23 @@
 hide:
  - toc

-title: Appium Drivers
+title: Appium驱动
 ---

-You can't use Appium without at least one driver! Click on the link for each driver to see the
-specific installation instructions and documentation for that driver.
+如果没有至少一个驱动程序，您就无法使用Appium！单击每个驱动程序的链接，查看该驱动程序的具体安装说明和文档。

-Generally, drivers can be installed using their listed installation key, with the following command:
+通常，可以使用下面列出的驱动名称，使用以下命令安装驱动程序：
 ```
-appium driver install <installation key>
+appium driver install <驱动名称>
 ```

-To learn more about drivers, check out the [Driver Intro](../intro/drivers.md).
+要了解有关驱动的更多信息，请查看[驱动简介](../intro/drivers.md)。

-### Official Drivers
+### 官方驱动

-These drivers are currently maintained by the Appium team:
+这些驱动程序目前由Appium团队维护：

-|Driver|Installation Key|Platform(s)|Mode(s)|
+|驱动|驱动名称|支持的平台|支持的形式|
 |--|--|--|--|
 |[Chromium](https://github.com/appium/appium-chromium-driver)|`chromium`|macOS, Windows, Linux|Web|
 |[Espresso](https://github.com/appium/appium-espresso-driver)|`espresso`|Android|Native|
@@ -30,11 +29,11 @@ These drivers are currently maintained by the Appium team:
 |[Windows](https://github.com/appium/appium-windows-driver)|`windows`|Windows|Native|
 |[XCUITest](https://github.com/appium/appium-xcuitest-driver)|`xcuitest`|iOS|Native, Hybrid, Web|

-### Other Drivers
+### 其他驱动

-These drivers are not maintained by the Appium team and can be used to target additional platforms:
+这些驱动程序不由Appium团队维护，可用于针对其他平台：

-|Driver|Installation Key|Platform(s)|Mode(s)|Supported By|
+|驱动|驱动名称|支持的平台|支持的形式|维护者|
 |--|--|--|--|--|
 |[Flutter](https://github.com/appium/appium-flutter-driver)|`--source=npm appium-flutter-driver`|iOS, Android|Native|Community|
 |[Flutter Integration](https://github.com/AppiumTestDistribution/appium-flutter-integration-driver)|`--source=npm appium-flutter-integration-driver`|iOS, Android|Native|Community / `@AppiumTestDistribution`|
@@ -45,7 +44,6 @@ These drivers are not maintained by the Appium team and can be used to target ad
 |[TizenTV](https://github.com/headspinio/appium-tizen-tv-driver)|`--source=npm appium-tizen-tv-driver`|Samsung TV|Web|HeadSpin|
 |[Youi](https://github.com/YOU-i-Labs/appium-youiengine-driver)|`--source=npm appium-youiengine-driver`|iOS, Android, macOS, Linux, tvOS|Native|Community / You.i|

-!!! note
+!!! 注意

-    If you maintain an Appium driver that you would like to be listed in the Appium docs, feel free
-    to make a PR to add it to this section with a link to the driver documentation.
+    如果您维护了一个Appium驱动程序，并希望在Appium文档中列出，请随时进行PR，将其添加到本部分，并附上驱动程序文档的链接。
@@ -2,44 +2,43 @@
 hide:
  - toc

-title: Ecosystem Overview
+title: 生态系统概述
 ---

-Appium has a wide ecosystem of related software and tools. This section of the Appium documentation
-aims to compile a listing of various officially-supported and community-supported Appium projects:
+Appium拥有广泛的相关软件和工具生态系统。文档的这一部分旨在编制各种官方支持和社区支持的Appium项目的列表：

 <div class="grid cards" markdown>

-   :material-car: __Drivers__
+-   :material-car: __驱动__

    ---

-    Link Appium to your test device
+    将Appium链接到您的测试设备

-    [:octicons-arrow-right-24: View all drivers](./drivers.md)
+    [:octicons-arrow-right-24: 查看所有驱动](./drivers.md)

-   :octicons-code-16: __Clients__
+-   :octicons-code-16: __客户端__

    ---

-    Link Appium to your automation code
+    将Appium链接到您的自动化代码

-    [:octicons-arrow-right-24: View all clients](./clients.md)
+    [:octicons-arrow-right-24: 查看所有客户端](./clients.md)

-   :fontawesome-solid-plug: __Plugins__
+-   :fontawesome-solid-plug: __插件__

    ---

-    Modify and extend Appium functionality
+    修改和扩展Appium功能

-    [:octicons-arrow-right-24: View all plugins](./plugins.md)
+    [:octicons-arrow-right-24: 查看所有插件](./plugins.md)

-   :material-wrench: __Tools__
+-   :material-wrench: __工具__

    ---

-    Interact with Appium in other ways
+    以其他方式与Appium交互

-    [:octicons-arrow-right-24: View all tools](./tools.md)
+    [:octicons-arrow-right-24: 查看所有工具](./tools.md)

 </div>
@@ -2,44 +2,42 @@
 hide:
  - toc

-title: Appium Plugins
+title: Appium插件
 ---

-Plugins offer various ways to extend or modify Appium's behaviour. They are _completely optional_
-and are not needed for standard automation functionality, but you may find them to be useful
-for more specialised automation workflows.
+插件提供了各种方法来扩展或修改Appium的行为。它们是完全可选的，不是标准自动化功能所必需的，但您可能会发现它们对更专业的自动化工作流程很有用。
+
+通常，可以使用下面列出的插件名称，使用以下命令安装插件：

-Generally, plugins can be installed using their listed installation key, with the following command:
 ```
-appium plugin install <installation key>
+appium plugin install <插件名称>
 ```

-### Official Plugins
+### 官方插件

-These plugins are are currently maintained by the Appium team:
+这些插件目前由Appium团队维护：

-|<div style="width:7em">Plugin</div>|<div style="width:8em">Installation Key</div>|Description|
+|<div style="width:7em">插件</div>|<div style="width:8em">插件名称</div>|简介|
 |---|---|---|
-|[Execute Driver](https://github.com/appium/appium/tree/master/packages/execute-driver-plugin)|`execute-driver`|Run entire batches of commands in a single call to the Appium server|
-|[Images](https://github.com/appium/appium/tree/master/packages/images-plugin)|`images`|Image matching and comparison features|
-|[Relaxed Caps](https://github.com/appium/appium/tree/master/packages/relaxed-caps-plugin)|`relaxed-caps`|Relax Appium's requirement for vendor prefixes on capabilities|
-|[Universal XML](https://github.com/appium/appium/tree/master/packages/universal-xml-plugin)|`universal-xml`|Instead of the standard XML format for iOS and Android, use an XML definition that is the same across both platforms|
+|[Execute Driver](https://github.com/appium/appium/tree/master/packages/execute-driver-plugin)|`execute-driver`|在对Appium服务器的一次调用中运行整批命令|
+|[Images](https://github.com/appium/appium/tree/master/packages/images-plugin)|`images`|图像匹配和比较功能|
+|[Relaxed Caps](https://github.com/appium/appium/tree/master/packages/relaxed-caps-plugin)|`relaxed-caps`|放宽Appium对功能上供应商前置的要求|
+|[Universal XML](https://github.com/appium/appium/tree/master/packages/universal-xml-plugin)|`universal-xml`|使用在两个平台上都相同的XML定义，而不是iOS和Android的标准XML格式|

-### Other Plugins
+### 其他插件

-These plugins are not maintained by the Appium team and can provide additional functionality:
+这些插件不由Appium团队维护，可以提供其他功能：

-|<div style="width:6em">Plugin</div>|<div style="width:19em">Installation Key</div>|Description|<div style="width:13em">Supported By</div>|
+|<div style="width:6em">插件</div>|<div style="width:19em">插件名称</div>|简介|<div style="width:13em">维护者</div>|
 |---|---|---|---|
-|[AltUnity](https://github.com/headspinio/appium-altunity-plugin)|`--source=npm appium-altunity-plugin`|Target Unity games and apps for automation with a new context, via the AltUnityTester framework|HeadSpin|
-|[Device Farm](https://github.com/AppiumTestDistribution/appium-device-farm)|`--source=npm appium-device-farm`|Manage and create driver sessions on connected Android devices and iOS simulators|`@AppiumTestDistribution`|
-|[Gestures](https://github.com/AppiumTestDistribution/appium-gestures-plugin)|`--source=npm appium-gestures-plugin`|Perform basic gestures using W3C Actions|`@AppiumTestDistribution`|
-|[Interceptor](https://github.com/AppiumTestDistribution/appium-interceptor-plugin)|`--source=npm appium-interceptor`|Intercept and mock API requests and responses|`@AppiumTestDistribution`|
-|[OCR](https://github.com/jlipps/appium-ocr-plugin)|`--source=npm appium-ocr-plugin`|Find elements via OCR text|`@jlipps`|
-|[Reporter](https://github.com/AppiumTestDistribution/appium-reporter-plugin)|`--source=npm appium-reporter-plugin`|Generate standalone consolidated HTML reports with screenshots|`@AppiumTestDistribution`|
-|[Wait](https://github.com/AppiumTestDistribution/appium-wait-plugin)|`--source=npm appium-wait-plugin`|Manage global element wait timeouts|`@AppiumTestDistribution`|
+|[AltUnity](https://github.com/headspinio/appium-altunity-plugin)|`--source=npm appium-altunity-plugin`|通过AltUnityTester框架，为Unity游戏和应用程序提供新的自动化环境|HeadSpin|
+|[Device Farm](https://github.com/AppiumTestDistribution/appium-device-farm)|`--source=npm appium-device-farm`|在连接的Android设备和iOS模拟器上管理和创建驱动程序会话|`@AppiumTestDistribution`|
+|[Gestures](https://github.com/AppiumTestDistribution/appium-gestures-plugin)|`--source=npm appium-gestures-plugin`|使用W3C操作执行基本手势|`@AppiumTestDistribution`|
+|[Interceptor](https://github.com/AppiumTestDistribution/appium-interceptor-plugin)|`--source=npm appium-interceptor`|拦截和模拟API请求和响应|`@AppiumTestDistribution`|
+|[OCR](https://github.com/jlipps/appium-ocr-plugin)|`--source=npm appium-ocr-plugin`|通过OCR文本查找元素|`@jlipps`|
+|[Reporter](https://github.com/AppiumTestDistribution/appium-reporter-plugin)|`--source=npm appium-reporter-plugin`|通过屏幕截图生成独立的合并HTML报告|`@AppiumTestDistribution`|
+|[Wait](https://github.com/AppiumTestDistribution/appium-wait-plugin)|`--source=npm appium-wait-plugin`|管理全局元素等待超时|`@AppiumTestDistribution`|

-!!! note
+!!! 注意

-    If you maintain an Appium plugin that you would like to be listed in the Appium docs, feel free
-    to make a PR to add it to this section with a link to the documentation for the plugin.
+    如果您维护了一个Appium插件，并希望在Appium文档中列出，请随时进行PR，将其添加到本部分，并附上插件文档的链接。
@@ -2,41 +2,37 @@
 hide:
  - toc

-title: Appium-Related Tools
+title: Appium相关工具
 ---

-There are several Appium tools that have been created to to assist with things not directly related
-to testing, such as Appium installation, test development, and more.
+这里有几个Appium工具来帮助处理与测试没有直接关系的事情，例如Appium安装、测试开发等。

 ### [Appium Inspector](https://appium.github.io/appium-inspector/latest/)

-Appium has a graphical client which can be used to inspect application screenshots, view the
-application hierarchy, run Appium commands, record app interactions, and more. It is very useful
-for Appium test development.
+Appium有一个图形客户端，可用于检查应用程序屏幕截图、查看应用程序层次结构、运行Appium命令、记录应用程序交互等。它对Appium测试开发非常有用。

-Find downloads and more information on its GitHub page: [Appium Inspector](https://github.com/appium/appium-inspector)
+在其GitHub页面上查找下载和更多信息：[Appium Inspector](https://github.com/appium/appium-inspector)

 ### Appium Doctor

-Appium Doctor is a command-line tool built into Appium drivers and plugins.
-The command is expected to be used to validate whether a driver or plugin has all of its prerequisites and other environment details set up correctly
-if the driver/plugin author implemented the `doctor` command.
+Appium Doctor是一个内置于Appium驱动程序和插件中的命令行工具。如果驱动程序/插件作者实现了`doctor`命令，
+则该命令将用于验证驱动程序或插件是否正确设置了所有先决条件和其他环境详细信息。

-For example, `uiautomator2` driver provides the `doctor` command below.
+例如，`uiautomator2`驱动程序提供以下`doctor`命令。

 ```
 appium driver doctor uiautomator2
 ```

-It shows no result if the driver/plugin author did not implement them.
+如果驱动程序/插件作者没有实现它们，则不会显示任何结果。

-More information on this command can be found in the [Command-Line Usage documentation](../cli/extensions.md#doctor).
-For driver/plugin developers, please read [Building Doctor Checks](../developing/build-doctor-checks.md).
+有关此命令的更多信息，请参阅[命令行使用文档](../cli/extensions.md#doctor)。
+对于驱动程序/插件开发人员，请阅读[构建医生检查](../developing/build-doctor-checks.md)。

-### Other Tools
+### 其他工具

-These tools are not maintained by the Appium team and can be used to assist with other problems:
+这些工具不由Appium团队维护，可以用于协助解决其他问题：

-|Name|Description|Supported By|
+|名字|简介|维护者|
 |---|---|---|
-|[appium-installer](https://github.com/AppiumTestDistribution/appium-installer)|Help set up an Appium environment for Android and iOS|`@AppiumTestDistribution`|
+|[appium-installer](https://github.com/AppiumTestDistribution/appium-installer)|为Android和iOS设置Appium环境|`@AppiumTestDistribution`|
@@ -22,11 +22,6 @@ title: 欢迎
  Appium非常感谢主要合作伙伴的支持！(了解更多关于我们的赞助计划和贡献者补偿计划信息请<a
  href="https://github.com/appium/appium/blob/master/GOVERNANCE.md#sponsorship">点击此处</a>)
  <div class="homepageSponsors">
-    <div class="homepageSponsor">
-      <a href="https://www.headspin.io/solutions/appium-mobile-test-automation">
-        <img src="assets/images/sponsor-logo-headspin.png" style="width: 200px;" />
-      </a>
-    </div>
    <div class="homepageSponsor">
      <a href="https://www.browserstack.com/browserstack-appium?utm_campaigncode=701OW00000AoUTQYA3&utm_medium=partnered&utm_source=appium">
        <img src="assets/images/sponsor-logo-browserstack-dark.png#only-dark" style="width: 220px;" />
@@ -81,8 +81,8 @@ Appium在[2013年谷歌测试自动化大会](https://www.youtube.com/watch?v=1J
 ## 通往Appium 1.0之路

 Appium开始显著生长和成熟。2014年5月，我们发布了Appium 1.0，这是Appium发展的一个里程碑。Appium获得了
-[各种](http://sauceio.com/index.php/2014/01/appium-selected-as-a-black-duck-open-source-rookie-of-the-year/)
-[奖项](http://sauceio.com/index.php/2014/10/appium-wins-a-bossy-award-from-infoworld/)，
+[各种](https://www.prnewswire.com/news-releases/black-duck-announces-black-duck-open-source-rookies-of-the-year-winners-242383341.html)
+[奖项](https://www.infoworld.com/article/2241247/164642-bossie-awards-2014-the-best-open-source-application-development-tools.html)，
 成为最受欢迎的开源跨平台移动自动化框架。稳定性得到改善，错误得到优先处理和修复，并添加了新的功能。
 Sauce Labs增加了捐赠给Appium开发人员的数量，但整个社区都参与了项目的指导和贡献，
 项目治理继续在公开的公共邮件列表和GitHub的问题跟踪器上进行。
@@ -19,7 +19,7 @@ title: 安装 UiAutomator2 驱动
 ### Android SDK

 - 设置 Android SDK 要求的最简单方法是下载 [Android Studio](https://developer.android.com/studio)。
-我们需要使用其 SDK 管理器 (_设置 -> 外观和行为 -> 系统设置 -> Android SDK_) 来下载以下项目：
+我们需要使用其 SDK 管理器 (_设置 -> 语言和框架 -> Android SDK_) 来下载以下项目：
    - Android SDK 平台（选择我们想要自动化的任何 Android 平台，例如，API 级别 30）
    - Android SDK 平台工具
 - 如果愿意，你也可以不通过 Android Studio 下载这些项目：
@@ -1,6 +1,6 @@
 {
  "name": "appium",
-  "version": "2.11.5",
+  "version": "2.12.1",
  "description": "Automation for Apps.",
  "keywords": [
    "automation",
@@ -60,15 +60,15 @@
    "test:unit": "mocha \"./test/unit/**/*.spec.js\""
  },
  "dependencies": {
-    "@appium/base-driver": "^9.11.5",
-    "@appium/base-plugin": "^2.2.45",
-    "@appium/docutils": "^1.0.21",
+    "@appium/base-driver": "^9.12.1",
+    "@appium/base-plugin": "^2.2.47",
+    "@appium/docutils": "^1.0.23",
    "@appium/logger": "^1.6.1",
-    "@appium/schema": "^0.6.1",
-    "@appium/support": "^5.1.4",
-    "@appium/types": "^0.21.3",
+    "@appium/schema": "^0.7.0",
+    "@appium/support": "^5.1.6",
+    "@appium/types": "^0.22.0",
    "@sidvind/better-ajv-errors": "3.0.1",
-    "@types/argparse": "2.0.16",
+    "@types/argparse": "2.0.17",
    "@types/bluebird": "3.5.42",
    "@types/semver": "7.5.8",
    "@types/teen_process": "2.0.4",
@@ -91,10 +91,10 @@
    "source-map-support": "0.5.21",
    "teen_process": "2.2.0",
    "type-fest": "4.26.1",
-    "winston": "3.14.2",
+    "winston": "3.15.0",
    "wrap-ansi": "7.0.0",
    "ws": "8.18.0",
-    "yaml": "2.5.1"
+    "yaml": "2.6.0"
  },
  "engines": {
    "node": "^14.17.0 || ^16.13.0 || >=18.0.0",
@@ -1,5 +1,5 @@
 {
  "devDependencies": {
-    "webdriverio": "8.40.5"
+    "webdriverio": "8.40.6"
  }
 }
@@ -19,6 +19,7 @@ export default {
  port: 4723,
  relaxedSecurityEnabled: false,
  sessionOverride: false,
+  shutdownTimeout: 5000,
  strictCaps: false,
  useDrivers: [],
  usePlugins: []
@@ -3,6 +3,32 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

+## [9.12.1](https://github.com/appium/appium/compare/@appium/base-driver@9.12.0...@appium/base-driver@9.12.1) (2024-10-24)
+
+
+### Bug Fixes
+
+* **driver-test-support:** update definitelytyped ([958fca4](https://github.com/appium/appium/commit/958fca47c8515664aac4c2f0b1051cadd43431b9))
+
+
+
+## [9.12.0](https://github.com/appium/appium/compare/@appium/base-driver@9.11.5...@appium/base-driver@9.12.0) (2024-10-15)
+
+
+### Features
+
+* **appium:** Make server graceful shutdown timeout configurable via command line args ([#20641](https://github.com/appium/appium/issues/20641)) ([5661888](https://github.com/appium/appium/commit/56618886ed007df3c28ce98beb4ff91bc47da2a2))
+
+
+### Bug Fixes
+
+* **base-driver:** update dependency express to v4.21.1 ([0e52da4](https://github.com/appium/appium/commit/0e52da4b3adbd5ecde09395063255c3af7eb0400))
+* **base-driver:** update dependency path-to-regexp to v8.2.0 ([e8886ae](https://github.com/appium/appium/commit/e8886ae0d276ac4f97a1bdb88998fc30fbd936fa))
+* **driver-test-support:** update dependency @types/lodash to v4.17.10 ([a2b0ba8](https://github.com/appium/appium/commit/a2b0ba877310737f1ebf7ecda0b9aa5d7083e1f4))
+* **types:** update dependency @types/express to v5 ([#20620](https://github.com/appium/appium/issues/20620)) ([69e9abe](https://github.com/appium/appium/commit/69e9abeed3ac5a2f61d8b7f1cd4ec4bd9c054cf1))
+
+
+
 ## [9.11.5](https://github.com/appium/appium/compare/@appium/base-driver@9.11.4...@appium/base-driver@9.11.5) (2024-09-26)


@@ -31,7 +31,6 @@ import {DEFAULT_BASE_PATH} from '../constants';
 import {fs, timing} from '@appium/support';

 const KEEP_ALIVE_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes
-const SERVER_CLOSE_TIMEOUT_MS = 5000;

 /**
 *
@@ -82,7 +81,7 @@ async function server(opts) {
    routeConfiguringFunction,
    port,
    hostname,
-    cliArgs = {},
+    cliArgs = /** @type {import('@appium/types').ServerArgs} */ ({}),
    allowCors = true,
    basePath = DEFAULT_BASE_PATH,
    extraMethodMap = {},
@@ -104,6 +103,7 @@ async function server(opts) {
        httpServer,
        reject,
        keepAliveTimeout,
+        gracefulShutdownTimeout: cliArgs.shutdownTimeout,
      });
      configureServer({
        app,
@@ -191,7 +191,7 @@ function configureServer({
 * @param {ConfigureHttpOpts} opts
 * @returns {AppiumServer}
 */
-function configureHttp({httpServer, reject, keepAliveTimeout}) {
+function configureHttp({httpServer, reject, keepAliveTimeout, gracefulShutdownTimeout}) {
  /**
   * @type {AppiumServer}
   */
@@ -214,12 +214,15 @@ function configureHttp({httpServer, reject, keepAliveTimeout}) {
      log.info('Closing Appium HTTP server');
      const timer = new timing.Timer().start();
      const onTimeout = setTimeout(() => {
-        log.info(
-          `Not all active connections have been closed within ` +
-          `${timer.getDuration().asMilliSeconds.toFixed(0)}ms. Exiting anyway.`
-        );
+        if (gracefulShutdownTimeout > 0) {
+          log.info(
+            `Not all active connections have been closed within ${gracefulShutdownTimeout}ms. ` +
+            `This timeout might be customized by the --shutdown-timeout command line ` +
+            `argument. Closing the server anyway.`
+          );
+        }
        process.exit(process.exitCode ?? 0);
-      }, SERVER_CLOSE_TIMEOUT_MS);
+      }, gracefulShutdownTimeout);
      httpServer.once('close', () => {
        log.info(
          `Appium HTTP server has been succesfully closed after ` +
@@ -323,6 +326,9 @@ export {server, configureServer, normalizeBasePath};
 * @property {import('http').Server} httpServer - HTTP server instance
 * @property {(error?: any) => void} reject - Rejection function from `Promise` constructor
 * @property {number} keepAliveTimeout - Keep-alive timeout in milliseconds
+ * @property {number} gracefulShutdownTimeout - For how long the server should delay its
+ * shutdown before force-closing all open connections to it. Providing zero will force-close
+ * the server without waiting for any connections.
 */

 /**
@@ -27,7 +27,9 @@ export {STATIC_DIR} from './express/static';
 export {server, normalizeBasePath} from './express/server';

 // jsonwp-proxy exports
+/** @deprecated The JWProxy export is deprecated. Please use WebDriverProxy instead */
 export {JWProxy} from './jsonwp-proxy/proxy';
+export {JWProxy as WebDriverProxy} from './jsonwp-proxy/proxy';

 // jsonwp-status exports
 export {getSummaryByCode, codes as statusCodes} from './jsonwp-status/status';
@@ -1,6 +1,6 @@
 {
  "name": "@appium/base-driver",
-  "version": "9.11.5",
+  "version": "9.12.1",
  "description": "Base driver class for Appium drivers",
  "keywords": [
    "automation",
@@ -44,13 +44,13 @@
    "test:types": "tsd"
  },
  "dependencies": {
-    "@appium/support": "^5.1.4",
-    "@appium/types": "^0.21.3",
+    "@appium/support": "^5.1.6",
+    "@appium/types": "^0.22.0",
    "@colors/colors": "1.6.0",
    "@types/async-lock": "1.4.2",
    "@types/bluebird": "3.5.42",
-    "@types/express": "4.17.21",
-    "@types/lodash": "4.17.9",
+    "@types/express": "5.0.0",
+    "@types/lodash": "4.17.12",
    "@types/method-override": "0.0.35",
    "@types/serve-favicon": "2.5.7",
    "async-lock": "1.4.1",
@@ -58,13 +58,13 @@
    "axios": "1.7.7",
    "bluebird": "3.7.2",
    "body-parser": "1.20.3",
-    "express": "4.21.0",
+    "express": "4.21.1",
    "http-status-codes": "2.3.0",
    "lodash": "4.17.21",
    "lru-cache": "10.4.3",
    "method-override": "3.0.0",
    "morgan": "1.10.0",
-    "path-to-regexp": "8.1.0",
+    "path-to-regexp": "8.2.0",
    "serve-favicon": "2.5.0",
    "source-map-support": "0.5.21",
    "type-fest": "4.26.1",
@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

+## [2.2.47](https://github.com/appium/appium/compare/@appium/base-plugin@2.2.46...@appium/base-plugin@2.2.47) (2024-10-24)
+
+**Note:** Version bump only for package @appium/base-plugin
+
+
+
+
+
+## [2.2.46](https://github.com/appium/appium/compare/@appium/base-plugin@2.2.45...@appium/base-plugin@2.2.46) (2024-10-15)
+
+**Note:** Version bump only for package @appium/base-plugin
+
+
+
+
+
 ## [2.2.45](https://github.com/appium/appium/compare/@appium/base-plugin@2.2.44...@appium/base-plugin@2.2.45) (2024-09-26)

 **Note:** Version bump only for package @appium/base-plugin
@@ -1,6 +1,6 @@
 {
  "name": "@appium/base-plugin",
-  "version": "2.2.45",
+  "version": "2.2.47",
  "description": "The base plugin used to create Appium 2.0 plugins",
  "keywords": [
    "automation",
@@ -40,8 +40,8 @@
    "test:unit": "mocha \"./test/unit/**/*.spec.js\""
  },
  "dependencies": {
-    "@appium/base-driver": "^9.11.5",
-    "@appium/support": "^5.1.4"
+    "@appium/base-driver": "^9.12.1",
+    "@appium/support": "^5.1.6"
  },
  "engines": {
    "node": "^14.17.0 || ^16.13.0 || >=18.0.0",
@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

+## [2.1.13](https://github.com/appium/appium/compare/@appium/doctor@2.1.12...@appium/doctor@2.1.13) (2024-10-24)
+
+**Note:** Version bump only for package @appium/doctor
+
+
+
+
+
+## [2.1.12](https://github.com/appium/appium/compare/@appium/doctor@2.1.11...@appium/doctor@2.1.12) (2024-10-15)
+
+**Note:** Version bump only for package @appium/doctor
+
+
+
+
+
 ## [2.1.11](https://github.com/appium/appium/compare/@appium/doctor@2.1.10...@appium/doctor@2.1.11) (2024-09-16)


@@ -1,6 +1,6 @@
 {
  "name": "@appium/doctor",
-  "version": "2.1.11",
+  "version": "2.1.13",
  "description": "Test environment for fitness to run Appium",
  "keywords": [
    "automation",
@@ -44,7 +44,7 @@
    "test:unit": "mocha \"./test/unit/**/*.spec.js\""
  },
  "dependencies": {
-    "@appium/support": "^5.1.4",
+    "@appium/support": "^5.1.6",
    "@colors/colors": "1.6.0",
    "@types/bluebird": "3.5.42",
    "@types/teen_process": "2.0.4",
@@ -3,6 +3,26 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

+## [1.0.23](https://github.com/appium/appium/compare/@appium/docutils@1.0.22...@appium/docutils@1.0.23) (2024-10-24)
+
+
+### Bug Fixes
+
+* **docutils:** restore support for Python <3.12 ([#20675](https://github.com/appium/appium/issues/20675)) ([00cd1b4](https://github.com/appium/appium/commit/00cd1b4b0fcf24d0014dac780223e5866f39c9ce))
+
+
+
+## [1.0.22](https://github.com/appium/appium/compare/@appium/docutils@1.0.21...@appium/docutils@1.0.22) (2024-10-15)
+
+
+### Bug Fixes
+
+* **docutils:** support Python 3.12+ ([#20666](https://github.com/appium/appium/issues/20666)) ([8d7cec9](https://github.com/appium/appium/commit/8d7cec96d8df60644493a7e2f735b4bb0d3783be))
+* **docutils:** update dependency typescript to v5.6.3 ([dd52d04](https://github.com/appium/appium/commit/dd52d04b21c37d7a4a979d00e96293dc0bf69768))
+* **docutils:** update dependency yaml to v2.6.0 ([ed6c6dd](https://github.com/appium/appium/commit/ed6c6dd5441e26fc1eb58de9b78def49d930a128))
+
+
+
 ## [1.0.21](https://github.com/appium/appium/compare/@appium/docutils@1.0.20...@appium/docutils@1.0.21) (2024-09-26)


@@ -146,3 +146,10 @@ export const LogLevelMap = {
 * If the user does not specify a site directory _and_ the `mkdocs.yml` doesn't either, use this dir.
 */
 export const DEFAULT_SITE_DIR = 'site';
+
+/**
+ * pip 23.0 implements PEP 668, which may prevent overriding Python system packages
+ * unless the --break-system-packages flag is passed.
+ * To ensure backwards compatibility, its environment variable version is used
+ */
+export const PIP_ENV_VARS = {PIP_BREAK_SYSTEM_PACKAGES: '1'};
@@ -5,7 +5,7 @@
 */

 import * as JSON5 from 'json5';
-import {NAME_MKDOCS_YML, NAME_TSCONFIG_JSON, NAME_PYTHON, REQUIREMENTS_TXT_PATH} from './constants';
+import {NAME_MKDOCS_YML, NAME_TSCONFIG_JSON, NAME_PYTHON, PIP_ENV_VARS, REQUIREMENTS_TXT_PATH} from './constants';
 import YAML from 'yaml';
 import {exec} from 'teen_process';
 import {Simplify} from 'type-fest';
@@ -146,12 +146,21 @@ export async function initPython({
    args.push('--upgrade');
  }
  if (dryRun) {
-    dryRunLog.info('Would execute command: %s %s', pythonPath, args.join(' '));
+    dryRunLog.info(
+      'Would execute command: %s %s (environment variables: %s)',
+      pythonPath,
+      args.join(' '),
+      PIP_ENV_VARS,
+    );
  } else {
-    log.debug('Executing command: %s %s', pythonPath, args.join(' '));
+    log.debug('Executing command: %s %s (environment variables: %s)',
+      pythonPath,
+      args.join(' '),
+      PIP_ENV_VARS,
+    );
    log.info('Installing Python dependencies...');
    try {
-      const result = await exec(pythonPath, args, {shell: true});
+      const result = await exec(pythonPath, args, {env: PIP_ENV_VARS, shell: true});
      const {code, stdout} = result;
      if (code !== 0) {
        throw new DocutilsError(`Could not install Python dependencies. Reason: ${stdout}`);
@@ -1,6 +1,6 @@
 {
  "name": "@appium/docutils",
-  "version": "1.0.21",
+  "version": "1.0.23",
  "description": "Documentation generation utilities for Appium and related projects",
  "keywords": [
    "automation",
@@ -48,7 +48,7 @@
    "start": "node ./build/lib/cli/index.js"
  },
  "dependencies": {
-    "@appium/support": "^5.1.4",
+    "@appium/support": "^5.1.6",
    "@appium/tsconfig": "^0.3.3",
    "@sliphua/lilconfig-ts-loader": "3.2.2",
    "@types/which": "3.0.4",
@@ -64,8 +64,8 @@
    "source-map-support": "0.5.21",
    "teen_process": "2.2.0",
    "type-fest": "4.26.1",
-    "typescript": "5.6.2",
-    "yaml": "2.5.1",
+    "typescript": "5.6.3",
+    "yaml": "2.6.0",
    "yargs": "17.7.2",
    "yargs-parser": "21.1.1"
  },
@@ -1,5 +1,5 @@
 mkdocs==1.6.1
-mkdocs-git-revision-date-localized-plugin==1.2.9
-mkdocs-material==9.5.38
+mkdocs-git-revision-date-localized-plugin==1.3.0
+mkdocs-material==9.5.42
 mkdocs-redirects==1.2.1
 mike==2.1.3
@@ -3,6 +3,25 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

+## [0.6.11](https://github.com/appium/appium/compare/@appium/driver-test-support@0.6.10...@appium/driver-test-support@0.6.11) (2024-10-24)
+
+
+### Bug Fixes
+
+* **driver-test-support:** update definitelytyped ([958fca4](https://github.com/appium/appium/commit/958fca47c8515664aac4c2f0b1051cadd43431b9))
+* **driver-test-support:** update dependency chai to v5.1.2 ([#20693](https://github.com/appium/appium/issues/20693)) ([66ff497](https://github.com/appium/appium/commit/66ff497600aa5d0fa02d0b614193eee2150ad0fa))
+
+
+
+## [0.6.10](https://github.com/appium/appium/compare/@appium/driver-test-support@0.6.9...@appium/driver-test-support@0.6.10) (2024-10-15)
+
+
+### Bug Fixes
+
+* **driver-test-support:** update dependency @types/lodash to v4.17.10 ([a2b0ba8](https://github.com/appium/appium/commit/a2b0ba877310737f1ebf7ecda0b9aa5d7083e1f4))
+
+
+
 ## [0.6.9](https://github.com/appium/appium/compare/@appium/driver-test-support@0.6.8...@appium/driver-test-support@0.6.9) (2024-09-26)


@@ -1,6 +1,6 @@
 {
  "name": "@appium/driver-test-support",
-  "version": "0.6.9",
+  "version": "0.6.11",
  "description": "Test utilities for Appium drivers",
  "keywords": [
    "automation",
@@ -41,12 +41,12 @@
  },
  "types": "./build/lib/index.d.ts",
  "dependencies": {
-    "@appium/types": "^0.21.3",
-    "@types/lodash": "4.17.9",
+    "@appium/types": "^0.22.0",
+    "@types/lodash": "4.17.12",
    "@types/stoppable": "1.1.3",
    "axios": "1.7.7",
    "bluebird": "3.7.2",
-    "chai": "5.1.1",
+    "chai": "5.1.2",
    "chai-as-promised": "8.0.0",
    "get-port": "5.1.1",
    "lodash": "4.17.21",
@@ -3,6 +3,15 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

+## [3.0.36](https://github.com/appium/appium/compare/@appium/execute-driver-plugin@3.0.35...@appium/execute-driver-plugin@3.0.36) (2024-10-15)
+
+
+### Bug Fixes
+
+* **execute-driver-plugin:** update dependency webdriverio to v8.40.6 ([796ca9f](https://github.com/appium/appium/commit/796ca9f98f69616b9c890325bbfb0c573a8bc765))
+
+
+
 ## [3.0.35](https://github.com/appium/appium/compare/@appium/execute-driver-plugin@3.0.34...@appium/execute-driver-plugin@3.0.35) (2024-09-26)


@@ -1,6 +1,6 @@
 {
  "name": "@appium/execute-driver-plugin",
-  "version": "3.0.35",
+  "version": "3.0.36",
  "description": "Plugin for batching and executing driver commands with Appiums",
  "keywords": [
    "automation",
@@ -42,7 +42,7 @@
    "bluebird": "3.7.2",
    "lodash": "4.17.21",
    "source-map-support": "0.5.21",
-    "webdriverio": "8.40.5"
+    "webdriverio": "8.40.6"
  },
  "peerDependencies": {
    "appium": "^2.0.0-beta.35"
@@ -3,6 +3,15 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

+## [5.5.5](https://github.com/appium/appium/compare/@appium/fake-driver@5.5.4...@appium/fake-driver@5.5.5) (2024-10-15)
+
+
+### Bug Fixes
+
+* **universal-xml-plugin:** update dependency @xmldom/xmldom to v0.9.4 ([#20663](https://github.com/appium/appium/issues/20663)) ([b56b180](https://github.com/appium/appium/commit/b56b180f3465d14e36b2bb8e7fa831954e0fc4c6))
+
+
+
 ## [5.5.4](https://github.com/appium/appium/compare/@appium/fake-driver@5.5.3...@appium/fake-driver@5.5.4) (2024-09-26)


@@ -1,6 +1,6 @@
 {
  "name": "@appium/fake-driver",
-  "version": "5.5.4",
+  "version": "5.5.5",
  "description": "Mock driver used internally by Appium for testing. Ignore",
  "keywords": [
    "automation",
@@ -43,7 +43,7 @@
  },
  "dependencies": {
    "@types/bluebird": "3.5.42",
-    "@xmldom/xmldom": "0.9.3",
+    "@xmldom/xmldom": "0.9.4",
    "asyncbox": "3.0.0",
    "bluebird": "3.7.2",
    "lodash": "4.17.21",
@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

+## [3.1.51](https://github.com/appium/appium/compare/@appium/fake-plugin@3.1.50...@appium/fake-plugin@3.1.51) (2024-10-24)
+
+**Note:** Version bump only for package @appium/fake-plugin
+
+
+
+
+
+## [3.1.50](https://github.com/appium/appium/compare/@appium/fake-plugin@3.1.49...@appium/fake-plugin@3.1.50) (2024-10-15)
+
+**Note:** Version bump only for package @appium/fake-plugin
+
+
+
+
+
 ## [3.1.49](https://github.com/appium/appium/compare/@appium/fake-plugin@3.1.48...@appium/fake-plugin@3.1.49) (2024-09-26)

 **Note:** Version bump only for package @appium/fake-plugin
@@ -1,6 +1,6 @@
 {
  "name": "@appium/fake-plugin",
-  "version": "3.1.49",
+  "version": "3.1.51",
  "description": "A fake Appium 2.0 plugin",
  "keywords": [
    "automation",
@@ -39,8 +39,8 @@
    "test:unit": "mocha \"./test/unit/**/*.spec.js\""
  },
  "dependencies": {
-    "@appium/base-plugin": "^2.2.45",
-    "@appium/support": "^5.1.4",
+    "@appium/base-plugin": "^2.2.47",
+    "@appium/support": "^5.1.6",
    "@types/bluebird": "3.5.42",
    "bluebird": "3.7.2",
    "lodash": "4.17.21",
@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

+## [3.0.21](https://github.com/appium/appium/compare/@appium/images-plugin@3.0.20...@appium/images-plugin@3.0.21) (2024-10-24)
+
+**Note:** Version bump only for package @appium/images-plugin
+
+
+
+
+
+## [3.0.20](https://github.com/appium/appium/compare/@appium/images-plugin@3.0.19...@appium/images-plugin@3.0.20) (2024-10-15)
+
+**Note:** Version bump only for package @appium/images-plugin
+
+
+
+
+
 ## [3.0.19](https://github.com/appium/appium/compare/@appium/images-plugin@3.0.18...@appium/images-plugin@3.0.19) (2024-09-16)

 **Note:** Version bump only for package @appium/images-plugin
@@ -1,6 +1,6 @@
 {
  "name": "@appium/images-plugin",
-  "version": "3.0.19",
+  "version": "3.0.21",
  "description": "Plugin for working with images and image elements in Appium",
  "keywords": [
    "automation",
@@ -40,7 +40,7 @@
  },
  "dependencies": {
    "@appium/opencv": "^3.0.6",
-    "@appium/support": "^5.1.4",
+    "@appium/support": "^5.1.6",
    "lodash": "4.17.21",
    "lru-cache": "10.4.3",
    "sharp": "0.33.5",
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

+## [0.3.43](https://github.com/appium/appium/compare/@appium/plugin-test-support@0.3.42...@appium/plugin-test-support@0.3.43) (2024-10-15)
+
+**Note:** Version bump only for package @appium/plugin-test-support
+
+
+
+
+
 ## [0.3.42](https://github.com/appium/appium/compare/@appium/plugin-test-support@0.3.41...@appium/plugin-test-support@0.3.42) (2024-09-16)

 **Note:** Version bump only for package @appium/plugin-test-support
@@ -1,6 +1,6 @@
 {
  "name": "@appium/plugin-test-support",
-  "version": "0.3.42",
+  "version": "0.3.43",
  "description": "Testing utilities for Appium plugins",
  "keywords": [
    "automation",
@@ -41,7 +41,7 @@
    "test:unit": "exit 0"
  },
  "dependencies": {
-    "@appium/types": "^0.21.3",
+    "@appium/types": "^0.22.0",
    "get-port": "5.1.1",
    "log-symbols": "4.1.0",
    "source-map-support": "0.5.21",
@@ -3,6 +3,15 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

+## [0.7.0](https://github.com/appium/appium/compare/@appium/schema@0.6.1...@appium/schema@0.7.0) (2024-10-15)
+
+
+### Features
+
+* **appium:** Make server graceful shutdown timeout configurable via command line args ([#20641](https://github.com/appium/appium/issues/20641)) ([5661888](https://github.com/appium/appium/commit/56618886ed007df3c28ce98beb4ff91bc47da2a2))
+
+
+
 ## [0.6.1](https://github.com/appium/appium/compare/@appium/schema@0.6.0...@appium/schema@0.6.1) (2024-06-11)


@@ -249,12 +249,34 @@ export const AppiumConfigJsonSchema = /** @type {const} */ ({
          type: 'boolean',
          appiumCliDest: 'relaxedSecurityEnabled',
        },
+        'shutdown-timeout': {
+          default: 5000,
+          description: 'For how long the server should delay its shutdown before force-closing all open connections to it. ' +
+            'Setting its value to zero should close the server without waiting for active connections.',
+          title: 'Graceful server shutdown timeout in milliseconds',
+          type: 'integer',
+          minimum: 0,
+        },
        'session-override': {
          default: false,
          description: 'Enables session override (clobbering)',
          title: 'session-override config',
          type: 'boolean',
        },
+        'ssl-cert-path': {
+          description:
+            'Full path to the .cert file if TLS is used. Must be provided together with "ssl-key-path"',
+          title: '.cert file path',
+          appiumCliDest: 'sslCertificatePath',
+          type: 'string',
+        },
+        'ssl-key-path': {
+          description:
+            'Full path to the .key file if TLS is used. Must be provided together with "ssl-cert-path"',
+          title: '.key file path',
+          appiumCliDest: 'sslKeyPath',
+          type: 'string',
+        },
        'strict-caps': {
          default: false,
          description:
@@ -310,20 +332,6 @@ export const AppiumConfigJsonSchema = /** @type {const} */ ({
          title: 'webhook config',
          type: 'string',
        },
-        'ssl-cert-path': {
-          description:
-            'Full path to the .cert file if TLS is used. Must be provided together with "ssl-key-path"',
-          title: '.cert file path',
-          appiumCliDest: 'sslCertificatePath',
-          type: 'string',
-        },
-        'ssl-key-path': {
-          description:
-            'Full path to the .key file if TLS is used. Must be provided together with "ssl-cert-path"',
-          title: '.key file path',
-          appiumCliDest: 'sslKeyPath',
-          type: 'string',
-        },
      },
      title: 'server config',
      type: 'object',
@@ -251,12 +251,31 @@
          "type": "boolean",
          "appiumCliDest": "relaxedSecurityEnabled"
        },
+        "shutdown-timeout": {
+          "default": 5000,
+          "description": "For how long the server should delay its shutdown before force-closing all open connections to it. Setting its value to zero should close the server without waiting for active connections.",
+          "title": "Graceful server shutdown timeout in milliseconds",
+          "type": "integer",
+          "minimum": 0
+        },
        "session-override": {
          "default": false,
          "description": "Enables session override (clobbering)",
          "title": "session-override config",
          "type": "boolean"
        },
+        "ssl-cert-path": {
+          "description": "Full path to the .cert file if TLS is used. Must be provided together with \"ssl-key-path\"",
+          "title": ".cert file path",
+          "appiumCliDest": "sslCertificatePath",
+          "type": "string"
+        },
+        "ssl-key-path": {
+          "description": "Full path to the .key file if TLS is used. Must be provided together with \"ssl-cert-path\"",
+          "title": ".key file path",
+          "appiumCliDest": "sslKeyPath",
+          "type": "string"
+        },
        "strict-caps": {
          "default": false,
          "description": "Cause sessions to fail if desired caps are sent in that Appium does not recognize as valid for the selected device",
@@ -305,18 +324,6 @@
          "format": "uri",
          "title": "webhook config",
          "type": "string"
-        },
-        "ssl-cert-path": {
-          "description": "Full path to the .cert file if TLS is used. Must be provided together with \"ssl-key-path\"",
-          "title": ".cert file path",
-          "appiumCliDest": "sslCertificatePath",
-          "type": "string"
-        },
-        "ssl-key-path": {
-          "description": "Full path to the .key file if TLS is used. Must be provided together with \"ssl-cert-path\"",
-          "title": ".key file path",
-          "appiumCliDest": "sslKeyPath",
-          "type": "string"
        }
      },
      "title": "server config",
@@ -1,6 +1,6 @@
 {
  "name": "@appium/schema",
-  "version": "0.6.1",
+  "version": "0.7.0",
  "description": "Appium Configuration Schema",
  "keywords": [
    "automation",
@@ -3,6 +3,24 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

+## [5.1.6](https://github.com/appium/appium/compare/@appium/support@5.1.5...@appium/support@5.1.6) (2024-10-24)
+
+
+### Bug Fixes
+
+* **support:** update definitelytyped ([#20691](https://github.com/appium/appium/issues/20691)) ([846dd52](https://github.com/appium/appium/commit/846dd5288608d886f924d2791291475c956d53f7))
+
+
+
+## [5.1.5](https://github.com/appium/appium/compare/@appium/support@5.1.4...@appium/support@5.1.5) (2024-10-15)
+
+
+### Bug Fixes
+
+* **support:** update dependency form-data to v4.0.1 ([0e443d2](https://github.com/appium/appium/commit/0e443d27995dcbd2b99ec18d8cb6183352d8cd59))
+
+
+
 ## [5.1.4](https://github.com/appium/appium/compare/@appium/support@5.1.3...@appium/support@5.1.4) (2024-09-16)


@@ -1,6 +1,6 @@
 {
  "name": "@appium/support",
-  "version": "5.1.4",
+  "version": "5.1.6",
  "description": "Support libs used across appium packages",
  "keywords": [
    "automation",
@@ -43,9 +43,9 @@
  "dependencies": {
    "@appium/logger": "^1.6.1",
    "@appium/tsconfig": "^0.3.3",
-    "@appium/types": "^0.21.3",
+    "@appium/types": "^0.22.0",
    "@colors/colors": "1.6.0",
-    "@types/archiver": "6.0.2",
+    "@types/archiver": "6.0.3",
    "@types/base64-stream": "1.0.5",
    "@types/find-root": "1.1.4",
    "@types/jsftp": "2.1.5",
@@ -66,7 +66,7 @@
    "bluebird": "3.7.2",
    "bplist-creator": "0.1.1",
    "bplist-parser": "0.3.2",
-    "form-data": "4.0.0",
+    "form-data": "4.0.1",
    "get-stream": "6.0.1",
    "glob": "10.4.5",
    "jsftp": "2.1.3",
@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

+## [3.0.51](https://github.com/appium/appium/compare/@appium/test-support@3.0.50...@appium/test-support@3.0.51) (2024-10-24)
+
+**Note:** Version bump only for package @appium/test-support
+
+
+
+
+
+## [3.0.50](https://github.com/appium/appium/compare/@appium/test-support@3.0.49...@appium/test-support@3.0.50) (2024-10-15)
+
+**Note:** Version bump only for package @appium/test-support
+
+
+
+
+
 ## [3.0.49](https://github.com/appium/appium/compare/@appium/test-support@3.0.48...@appium/test-support@3.0.49) (2024-09-26)


@@ -1,6 +1,6 @@
 {
  "name": "@appium/test-support",
-  "version": "3.0.49",
+  "version": "3.0.51",
  "description": "A collection of test utilities used across Appium packages",
  "keywords": [
    "automation",
@@ -45,7 +45,7 @@
    "test:unit": "mocha \"./test/unit/**/*.spec.js\""
  },
  "dependencies": {
-    "@appium/support": "^5.1.4",
+    "@appium/support": "^5.1.6",
    "@colors/colors": "1.6.0",
    "bluebird": "3.7.2",
    "lodash": "4.17.21",
@@ -3,6 +3,20 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

+## [0.22.0](https://github.com/appium/appium/compare/@appium/types@0.21.3...@appium/types@0.22.0) (2024-10-15)
+
+
+### Features
+
+* **appium:** Make server graceful shutdown timeout configurable via command line args ([#20641](https://github.com/appium/appium/issues/20641)) ([5661888](https://github.com/appium/appium/commit/56618886ed007df3c28ce98beb4ff91bc47da2a2))
+
+
+### Bug Fixes
+
+* **types:** update dependency @types/express to v5 ([#20620](https://github.com/appium/appium/issues/20620)) ([69e9abe](https://github.com/appium/appium/commit/69e9abeed3ac5a2f61d8b7f1cd4ec4bd9c054cf1))
+
+
+
 ## [0.21.3](https://github.com/appium/appium/compare/@appium/types@0.21.2...@appium/types@0.21.3) (2024-09-16)


@@ -127,10 +127,22 @@ export type PortConfig = number;
 * Disable additional security checks, so it is possible to use some advanced features, provided by drivers supporting this option. Only enable it if all the clients are in the trusted network and it's not the case if a client could potentially break out of the session sandbox. Specific features can be overridden by using "deny-insecure"
 */
 export type RelaxedSecurityConfig = boolean;
+/**
+ * For how long the server should delay its shutdown before force-closing all open connections to it. Setting its value to zero should close the server without waiting for active connections.
+ */
+export type GracefulServerShutdownTimeoutInMilliseconds = number;
 /**
 * Enables session override (clobbering)
 */
 export type SessionOverrideConfig = boolean;
+/**
+ * Full path to the .cert file if TLS is used. Must be provided together with "ssl-key-path"
+ */
+export type CertFilePath = string;
+/**
+ * Full path to the .key file if TLS is used. Must be provided together with "ssl-cert-path"
+ */
+export type KeyFilePath = string;
 /**
 * Cause sessions to fail if desired caps are sent in that Appium does not recognize as valid for the selected device
 */
@@ -155,14 +167,6 @@ export type UsePluginsConfig = string[];
 * Also send log output to this http listener
 */
 export type WebhookConfig = string;
-/**
- * Full path to the .cert file if TLS is used. Must be provided together with "ssl-key-path"
- */
-export type CertFilePath = string;
-/**
- * Full path to the .key file if TLS is used. Must be provided together with "ssl-cert-path"
- */
-export type KeyFilePath = string;

 /**
 * A schema for Appium configuration files
@@ -204,15 +208,16 @@ export interface ServerConfig {
  plugin?: PluginConfig;
  port?: PortConfig;
  "relaxed-security"?: RelaxedSecurityConfig;
+  "shutdown-timeout"?: GracefulServerShutdownTimeoutInMilliseconds;
  "session-override"?: SessionOverrideConfig;
+  "ssl-cert-path"?: CertFilePath;
+  "ssl-key-path"?: KeyFilePath;
  "strict-caps"?: StrictCapsConfig;
  tmp?: TmpConfig;
  "trace-dir"?: TraceDirConfig;
  "use-drivers"?: UseDriversConfig;
  "use-plugins"?: UsePluginsConfig;
  webhook?: WebhookConfig;
-  "ssl-cert-path"?: CertFilePath;
-  "ssl-key-path"?: KeyFilePath;
 }
 /**
 * Set the default desired capabilities, which will be set on each session unless overridden by received capabilities. If a string, a path to a JSON file containing the capabilities, or raw JSON.
@@ -1,6 +1,6 @@
 {
  "name": "@appium/types",
-  "version": "0.21.3",
+  "version": "0.22.0",
  "description": "Various type declarations used across Appium",
  "keywords": [
    "automation",
@@ -39,9 +39,9 @@
  },
  "dependencies": {
    "@appium/logger": "^1.6.1",
-    "@appium/schema": "^0.6.1",
+    "@appium/schema": "^0.7.0",
    "@appium/tsconfig": "^0.3.3",
-    "@types/express": "4.17.21",
+    "@types/express": "5.0.0",
    "@types/ws": "8.5.12",
    "type-fest": "4.26.1"
  },
@@ -3,6 +3,15 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

+## [1.0.24](https://github.com/appium/appium-plugins/compare/@appium/universal-xml-plugin@1.0.23...@appium/universal-xml-plugin@1.0.24) (2024-10-15)
+
+
+### Bug Fixes
+
+* **universal-xml-plugin:** update dependency @xmldom/xmldom to v0.9.4 ([#20663](https://github.com/appium/appium-plugins/issues/20663)) ([b56b180](https://github.com/appium/appium-plugins/commit/b56b180f3465d14e36b2bb8e7fa831954e0fc4c6))
+
+
+
 ## [1.0.23](https://github.com/appium/appium-plugins/compare/@appium/universal-xml-plugin@1.0.22...@appium/universal-xml-plugin@1.0.23) (2024-09-26)


@@ -1,6 +1,6 @@
 {
  "name": "@appium/universal-xml-plugin",
-  "version": "1.0.23",
+  "version": "1.0.24",
  "description": "Appium plugin for making XML source and XPath queries the same across iOS and Android",
  "keywords": [
    "automation",
@@ -37,7 +37,7 @@
  },
  "dependencies": {
    "@types/xmldom": "0.1.34",
-    "@xmldom/xmldom": "0.9.3",
+    "@xmldom/xmldom": "0.9.4",
    "fast-xml-parser": "4.5.0",
    "lodash": "4.17.21",
    "source-map-support": "0.5.21",
Author	SHA1	Message	Date
Jonathan Lipps	b0095bfd47	chore: publish - appium@2.12.1 - @appium/base-driver@9.12.1 - @appium/base-plugin@2.2.47 - @appium/doctor@2.1.13 - @appium/docutils@1.0.23 - @appium/driver-test-support@0.6.11 - @appium/fake-plugin@3.1.51 - @appium/images-plugin@3.0.21 - @appium/support@5.1.6 - @appium/test-support@3.0.51	2024-10-24 12:04:12 -07:00
renovate[bot]	15b783179d	chore(deps): update dependency @types/node to v20.17.0 (#20695 ) Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>	2024-10-24 09:07:03 +02:00
renovate[bot]	66ff497600	fix(driver-test-support): update dependency chai to v5.1.2 (#20693 ) Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>	2024-10-23 12:34:55 +02:00
renovate[bot]	846dd52886	fix(support): update definitelytyped (#20691 ) Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>	2024-10-23 12:34:36 +02:00
renovate[bot]	4a896b7dc8	chore(docutils): update dependency mkdocs-git-revision-date-localized-plugin to v1.3.0	2024-10-23 10:19:07 +00:00
renovate[bot]	e69f7fd1ad	chore(deps): update dependency npm-run-all2 to v6.2.6	2024-10-22 14:35:49 +00:00
renovate[bot]	76cc279ad9	chore(deps): update dependency @types/node to v20.16.14	2024-10-22 09:37:20 +00:00
Jonathan Lipps	bdc0bf4670	docs(appium): add appiumconf2025 banner (#20686 )	2024-10-21 23:24:49 +05:30
renovate[bot]	db4ed63de4	chore(docutils): update dependency mkdocs-material to v9.5.42	2024-10-20 12:26:55 +00:00
Phong Do	46278a1752	docs(appium): fix Android Studio SDK menu path (#20681 )	2024-10-20 01:13:29 -07:00
renovate[bot]	958fca47c8	fix(driver-test-support): update definitelytyped	2024-10-19 13:40:38 +00:00
Edgars Eglītis	00cd1b4b0f	fix(docutils): restore support for Python <3.12 (#20675 ) * fix(docutils): restore support for Python <3.12 * fix(docutils): only add the pip flag when required * chore: fix lint * chore: tune version number validation * chore: address review comments * chore: use env var to handle any pip version * chore: remove unused import * docs: add the env variable to zh docs * fix: pass env vars properly on Windows * chore: improve readability	2024-10-19 00:07:30 +03:00
renovate[bot]	809477c70c	chore(deps): update dependency npm-run-all2 to v6.2.4 (#20678 ) Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>	2024-10-18 13:15:36 +02:00
renovate[bot]	6bbb81724d	chore(deps): update dependency @types/node to v20.16.12 (#20673 ) Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>	2024-10-17 08:10:16 +02:00
Mykola Mokhnach	4dc0a07884	chore(base-driver): Export the WebDriverProxy alias (#20672 )	2024-10-17 08:09:58 +02:00
renovate[bot]	438b9da543	chore(docutils): update dependency mkdocs-material to v9.5.41	2024-10-16 12:08:41 +00:00
Jonathan Lipps	de17d3762e	docs(appium): turn sponsors list into full list (#20668 ) * docs(appium): turn sponsors list into full list OpenCollective generated section doesn't allow links to sponsor sites or sponsor provided logos * fix: testingbot no longer a sponsor	2024-10-15 13:35:53 -07:00
Jonathan Lipps	e3f7bd07f7	chore: publish - appium@2.12.0 - @appium/base-driver@9.12.0 - @appium/base-plugin@2.2.46 - @appium/doctor@2.1.12 - @appium/docutils@1.0.22 - @appium/driver-test-support@0.6.10 - @appium/execute-driver-plugin@3.0.36 - @appium/fake-driver@5.5.5 - @appium/fake-plugin@3.1.50 - @appium/images-plugin@3.0.20 - @appium/plugin-test-support@0.3.43 - @appium/schema@0.7.0 - @appium/support@5.1.5 - @appium/test-support@3.0.50 - @appium/types@0.22.0 - @appium/universal-xml-plugin@1.0.24	2024-10-15 09:32:02 -07:00
renovate[bot]	ed6c6dd544	fix(docutils): update dependency yaml to v2.6.0	2024-10-14 20:23:38 +00:00
renovate[bot]	b56b180f34	fix(universal-xml-plugin): update dependency @xmldom/xmldom to v0.9.4 (#20663 ) Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>	2024-10-14 20:59:59 +03:00
Edgars Eglītis	12969268fe	docs: fix links in Appium history document (#20667 )	2024-10-14 20:50:21 +03:00
zhangxh075	b312028d7e	docs: update zh ecosystem documentation (#20658 ) * Finish the translation of the index.md file * Finish the translation of the drivers.md file * Finish the translation of the clients.md file * Finish the translation of the plugins.md file * Finish the translation of the tools.md file	2024-10-14 20:49:24 +03:00
Edgars Eglītis	8d7cec96d8	fix(docutils): support Python 3.12+ (#20666 )	2024-10-14 20:40:31 +03:00
renovate[bot]	0e443d2799	fix(support): update dependency form-data to v4.0.1	2024-10-10 14:25:36 +00:00
renovate[bot]	5c41112134	chore(docutils): update dependency mkdocs-material to v9.5.40	2024-10-10 11:03:19 +00:00
renovate[bot]	dd52d04b21	fix(docutils): update dependency typescript to v5.6.3	2024-10-09 13:28:02 +00:00
renovate[bot]	0e52da4b3a	fix(base-driver): update dependency express to v4.21.1	2024-10-09 09:41:17 +00:00
renovate[bot]	98eed2d13f	chore(deps): update definitelytyped	2024-10-08 09:57:47 +00:00
renovate[bot]	371568da36	chore(deps): update dependency eslint-find-rules to v4.2.0	2024-10-06 13:35:49 +00:00
Mykola Mokhnach	56618886ed	feat(appium): Make server graceful shutdown timeout configurable via command line args (#20641 )	2024-10-05 16:14:31 +02:00
renovate[bot]	ab12235483	fix(appium): update dependency winston to v3.15.0	2024-10-05 09:40:28 +00:00
renovate[bot]	08f05562c1	chore(deps): update dependency eslint-plugin-import to v2.31.0	2024-10-04 09:05:01 +00:00
Kim ArnettandKazuaki Matsuo	a1d35404a2	docs(appium): add axe DevTools for Mobile drivers to Appium other drivers list: Supports accessibility testing for mobile apps (#20630 ) * docs: add axe DevTools for Mobile drivers to Appium other drivers list: Supports accessibility testing for mobile apps * Update packages/appium/docs/en/ecosystem/drivers.md Co-authored-by: Kazuaki Matsuo <fly.49.89.over@gmail.com> --------- Co-authored-by: Kazuaki Matsuo <fly.49.89.over@gmail.com>	2024-10-03 17:12:34 -07:00
Kazuaki Matsuo	a16c4c9521	docs(appium): Remove HS from development sponsor for now (#20635 ) * docs(appium): Remove HS from development sponsor for now * remove from docs/en/index.md as well	2024-10-03 16:57:06 -07:00
renovate[bot]	a2b0ba8773	fix(driver-test-support): update dependency @types/lodash to v4.17.10	2024-10-03 16:36:36 +00:00
renovate[bot]	796ca9f98f	fix(execute-driver-plugin): update dependency webdriverio to v8.40.6	2024-10-03 09:16:38 +00:00
renovate[bot]	69e9abeed3	fix(types): update dependency @types/express to v5 (#20620 ) Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>	2024-10-02 20:03:52 +03:00
renovate[bot]	cabc114935	chore(docutils): update dependency mkdocs-material to v9.5.39	2024-09-29 13:09:37 +00:00
renovate[bot]	aa86ef9603	chore(deps): update dependency @types/node to v20.16.10	2024-09-28 10:04:05 +00:00
Kazuaki Matsuo	656ba166e1	docs(appium): move sponsors into appium.io page (#20623 ) * docs(appium): move sponsors * modify existing page * fix review * use https://appium.io/docs/en/latest/sponsors/	2024-09-27 17:12:59 -07:00
renovate[bot]	e8886ae0d2	fix(base-driver): update dependency path-to-regexp to v8.2.0	2024-09-26 21:13:25 +00:00