Update update-appium-io.yml for Azure Pipelines

docs(1.x): Adds deprecation messages for appium.github.io/appium.io (#18591 )
* docs: add appium.io in the api.md path as a workaround * docs: add links to appium 2 related as workarounds
2026-11-10 11:54:49 +08:00 · 2023-05-01 18:56:45 -07:00 · 2023-05-01 18:54:35 -07:00 · 2023-01-30 10:56:19 -10:00 · 2022-11-27 18:48:57 +09:00 · 2022-11-03 14:58:50 -07:00
861 changed files with 5375 additions and 50252 deletions
@@ -1,9 +1,2 @@
-**/coverage/**
-**/node_modules/**
-examples/javascript-wd
-**/build/**
-**/*.min.js
-sample-code
-**/*.d.ts
-**/build-fixtures/**
-**/*.ts
+coverage
+node_modules
@@ -1,43 +1,3 @@
 {
-  "extends": "@appium/eslint-config-appium",
-  "overrides": [
-    {
-      "files": "packages/fake-driver/**/*",
-      "rules": { "require-await": "off" }
-    },
-    { "files": "packages/support/**/*", "globals": { "BigInt": "readonly" } },
-    {
-      "files": "packages/*/test/**/*",
-      "rules": { "func-names": "off" }
-    },
-    {
-      "files": "./packages/*/scripts/**/*.js",
-      "parserOptions": {
-        "sourceType": "script"
-      }
-    },
-    {
-      "files": "./packages/*/test/**/*.js",
-      "rules": {
-        "no-restricted-properties": [
-          "error", 
-          {
-            "object": "sinon",
-            "property": "spy",
-            "message": "Use `sandbox = sinon.createSandbox()` and `sandbox.spy()` instead. Don't forget to call `sandbox.restore()` in `afterEach`"
-          },
-          {
-            "object": "sinon",
-            "property": "stub",
-            "message": "Use `sandbox = sinon.createSandbox()` and `sandbox.stub()` instead. Don't forget to call `sandbox.restore()` in `afterEach`"
-          },
-          {
-            "object": "sinon",
-            "property": "mock",
-            "message": "Use `sandbox = sinon.createSandbox()` and `sandbox.mock()` instead. Don't forget to call `sandbox.restore()` in `afterEach`"
-          }
-        ] 
-      }
-    }
-  ]
+  "extends": "appium"
 }
@@ -1,40 +0,0 @@
-# Generated by FOSSA CLI (https://github.com/fossas/fossa-cli)
-# Visit https://fossa.com to learn more
-
-version: 3
-
-project:
-  id: github.com/appium/appium
-  name: appium
-
-paths:
-  exclude:
-    - ./sample-code
-    - '**/fixtures/**'
-    - '**/demo/**'
-    - '**/example/**'
-    - '**/examples/**'
-
-targets:
-  only:
-    - type: npm
-      path: .
-    - type: npm
-      path: ./packages/appium
-    - type: npm
-      path: ./packages/base-driver
-    - type: npm
-      path: ./packages/doctor
-    - type: npm
-      path: ./packages/eslint-config-appium
-    - type: npm
-      path: ./packages/fake-driver
-    - type: npm
-      path: ./packages/gulp-plugins
-    - type: npm
-      path: ./packages/support
-    - type: npm
-      path: ./packages/test-support
-
-revision:
-  branch: 2.0
@@ -1,14 +1,25 @@
 ## The problem

-Briefly describe the issue you are experiencing (or the feature you want to see added to Appium). Tell us what you were trying to do and what happened instead. Remember, this is _not_ a place to ask questions. For that, go to http://discuss.appium.io!
+Briefly describe the issue you are experiencing (or the feature you want to see added to Appium). Tell us what you were trying to do and what happened instead. Remember, this is _not_ a place to ask questions. For that consider visiting [Appium Forum](https://discuss.appium.io)!
+
+Before reporting the issue make sure that:
+- The issue is reproducible with the most recent available server and driver versions<sup>*</sup>.
+- There are no other duplicated reports of the same issue.
+- Your description of the issue could be used to reproduce/understand it without any additional details.
+
+<sup>*</sup>Appium1 is at its end of life and is not maintained actively anymore as well as compatible driver versions for it. It is highly recommended to switch to
+[Appium2](https://appiumpro.com/editions/122-installing-appium-20-and-the-driver-and-plugins-cli) to have
+access to the most recent server and driver fixes/updates.

 ## Environment

 * Appium version (or git revision) that exhibits the issue:
 * Last Appium version that did not exhibit the issue (if applicable):
+* Driver version that exhibits the issue (only for Appium2):
+* Last driver version that did not exhibit the issue (if applicable, only for Appium2):
 * Desktop OS/version used to run Appium:
 * Node.js version (unless using Appium.app|exe):
-* Npm or Yarn package manager:
+* Package manager name and version (we only officially support NPM):
 * Mobile platform/version under test:
 * Real device or emulator/simulator:
 * Appium CLI or Appium.app|exe:
@@ -23,11 +34,10 @@ Create a [GIST](https://gist.github.com) which is a paste of your _full_ Appium
 Do _NOT_ paste your full Appium logs here, as it will make this issue very long and hard to read!
 If you are reporting a bug, _always_ include Appium logs!

-
 ## Code To Reproduce Issue [ Good To Have ]

 Please remember that with sample code it's easier to reproduce the bug and it's much faster to fix it.

-Please git clone https://github.com/appium/appium and from the `examples` directory, use one of your favourite languages and sample apps to reproduce the issue.
+Please git clone https://github.com/appium/appium and from the `sample-code` directory, use one of your favourite languages and sample apps to reproduce the issue.

-In case a similar scenario is missing in examples, please submit a PR with one of the sample apps provided.
+In case a similar scenario is missing in sample-code, please submit a PR with one of the sample apps provided.
@@ -1,20 +0,0 @@
-version: 2
-updates:
- package-ecosystem: npm
-  directory: "/sample-code/javascript-webdriverio"
-  schedule:
-    interval: daily
-    time: "11:00"
-  open-pull-requests-limit: 10
- package-ecosystem: npm
-  directory: "/sample-code/javascript-wd"
-  schedule:
-    interval: daily
-    time: "11:00"
-  open-pull-requests-limit: 10
- package-ecosystem: npm
-  directory: "/"
-  schedule:
-    interval: daily
-    time: "11:00"
-  open-pull-requests-limit: 10
@@ -1,53 +0,0 @@
-# This workflow will do a clean install of node dependencies, build the source code and run tests across different versions of node
-# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions
-
-name: Appium Build
-on: [push, pull_request]
-
-jobs:
-  test:
-    name: Test
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [14.x, 16.x, 17.x]
-
-    steps:
-      - uses: actions/checkout@v3
-      - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v3
-        with:
-          node-version: ${{ matrix.node-version }}
-      - name: Install latest npm
-        run: npm install -g npm
-      - name: Install dependencies
-        run: npm install
-      - name: Run unit tests
-        run: npm run test:ci
-      - name: Install @appium/fake-driver
-        run: npm run install-fake-driver
-      - name: Run E2E tests
-        run: npm run e2e-test
-
-  lint:
-    name: Lint & Check Types
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-      - name: Install dependencies
-        run: npm install
-      - name: ESLint
-        run: npm run lint
-      - name: Check types
-        run: npm run build:types
-
-  docs:
-    name: Build Command Documentation
-    needs: [test]
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-      - name: Install dependencies
-        run: npm install
-      - name: Generate docs
-        run: npm run generate-docs
@@ -1,21 +0,0 @@
-name: License Checks
-on:
-  workflow_dispatch:
-  schedule:
-    - cron: '0 0 * * *'
-jobs:
-  fossa-check:
-    name: Run FOSSA Analysis
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          ref: '2.0'
-      - name: fossa analyze
-        run: |
-          npm install
-          curl -sS -H 'Cache-Control: no-cache' https://raw.githubusercontent.com/fossas/fossa-cli/master/install-latest.sh | bash
-          fossa analyze
-          fossa test
-    env:
-      FOSSA_API_KEY: ${{secrets.FOSSA_API_KEY}}
@@ -0,0 +1,37 @@
+# This workflow will do a clean install of node dependencies, build the source code and run tests across different versions of node
+# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions
+
+name: Node.js CI
+on: [push, pull_request]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [14.x]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v1
+      with:
+        node-version: ${{ matrix.node-version }}
+    - run: npm run clean
+    - run: npm run test
+    - run: npm run e2e-test
+
+  generate_docs:
+    needs: [build]
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js 14.x
+      uses: actions/setup-node@v1
+      with:
+        node-version: 14.x
+    - run: npm run clean
+    - run: npm run generate-docs
@@ -8,10 +8,10 @@ xcuserdata
 *.sublime-*
 test/functional/_joined
 *.iml
-!examples/java/*.iml
+!sample-code/java/*.iml
 *.autosave
 .idea/
-!examples/java/.idea/
+!sample-code/java/.idea/
 *.log
 *.t
 artifacts
@@ -40,22 +40,14 @@ old
 .tern-project
 coverage
 docs/mkdocs.yml
-examples/javascript-wd/node_modules
-examples/php/vendor
-examples/php/composer.lock
-examples/java/out/
-examples/ruby/Gemfile.lock
-examples/python/test/results/
-examples/python/test/input
-examples/python/.pytest_cache/
-examples/csharp/test/bin
-examples/csharp/test/obj
-examples/csharp/test/bin
-examples/csharp/packages
+sample-code/javascript-wd/node_modules
+sample-code/java/out/
+sample-code/ruby/Gemfile.lock
+sample-code/python/test/results/
+sample-code/python/test/input
+sample-code/python/.pytest_cache/
+sample-code/csharp/test/bin
+sample-code/csharp/test/obj
+sample-code/csharp/test/bin
+sample-code/csharp/packages
 appium.zip
-.vscode/settings.json
-.nyc_output
-*.lerna_backup
-**/build-fixtures/**
-*.tsbuildinfo
-packages/*/LICENSE
@@ -1,12 +0,0 @@
-// @ts-check
-
-'use strict';
-
-module.exports = {
-  require: [
-    require.resolve('./test/setup.js')
-  ],
-  // forbids use of .only() in CI 
-  forbidOnly: Boolean(process.env.CI),
-  color: true
-};
@@ -1,4 +1,2 @@
 # Do not disable package-lock. Disabling package-lock also disables npm-shrinkwrap
-package-lock=true
-save-exact=true
-
+package-lock=true
@@ -1,23 +1,46 @@
 {
-  "version": "0.2.0",
-  "configurations": [
-    {
-      "args": ["--colors", "--timeout", "0", "${file}"],
-      "internalConsoleOptions": "openOnSessionStart",
-      "name": "Test - Current File",
-      "program": "${workspaceFolder}/node_modules/mocha/bin/_mocha",
-      "runtimeArgs": ["--require", "@babel/register"],
-      "request": "launch",
-      "skipFiles": ["<node_internals>/**", "**/node_modules/mocha/**"],
-      "type": "pwa-node",
-      "sourceMaps": true,
-      "cwd": "${workspaceFolder}",
-      "outfiles": [],
-      "env": {
-        "NODE_ENV": "test",
-        "BABEL_ENV": "test"
-      },
-      "autoAttachChildProcesses": true,
-    }
-  ]
-}
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Debug",
+            "type": "node",
+            "request": "launch",
+            "cwd": "${workspaceFolder}",
+            "console": "integratedTerminal",
+            "args": [
+                "."
+            ]
+        },
+        {
+            "name": "Attach Debug",
+            "type": "node",
+            "request": "attach",
+            "cwd": "${workspaceFolder}",
+            "port": 9229
+        },
+        {
+            "name": "Test All",
+            "type": "node",
+            "request": "launch",
+            "program": "${workspaceFolder}/node_modules/.bin/_mocha",
+            "args": [
+                "--require", "babel-core/register",
+                "--timeout", "999999",
+                "--colors",
+                "${workspaceFolder}/test"
+            ]
+        },
+        {
+            "name": "Test Current File",
+            "type": "node",
+            "request": "launch",
+            "program": "${workspaceFolder}/node_modules/.bin/_mocha",
+            "args": [
+                "--require", "babel-core/register",
+                "--timeout", "999999",
+                "--colors",
+                "${file}"
+            ]
+        }
+    ]
+}
@@ -1,136 +0,0 @@
-{
-  "version": "2.0.0",
-  "tasks": [
-    {
-      "type": "npm",
-      "script": "dev",
-      "group": {
-        "kind": "build",
-        "isDefault": true
-      },
-      "problemMatcher": [],
-      "label": "npm: dev",
-      "detail": "lerna exec --parallel gulp dev",
-      "isBackground": true,
-    },
-    {
-      "type": "shell",
-      "command": "npm",
-      "args": [
-        "exec",
-        "--",
-        "lerna",
-        "exec",
-        "--scope=@appium/fake-driver",
-        "--",
-        "gulp",
-        "transpile"
-      ],
-      "label": "transpile: @appium/fake-driver",
-      "problemMatcher": []
-    },
-    {
-      "type": "shell",
-      "command": "npm",
-      "args": [
-        "exec",
-        "--",
-        "lerna",
-        "exec",
-        "--scope=appium",
-        "--",
-        "gulp",
-        "transpile"
-      ],
-      "label": "transpile: appium",
-      "problemMatcher": []
-    },
-    {
-      "type": "shell",
-      "command": "npm",
-      "args": [
-        "exec",
-        "--",
-        "lerna",
-        "exec",
-        "--scope=@appium/support",
-        "--",
-        "gulp",
-        "transpile"
-      ],
-      "label": "transpile: @appium/support",
-      "problemMatcher": []
-    },
-    {
-      "type": "shell",
-      "command": "npm",
-      "args": [
-        "exec",
-        "--",
-        "lerna",
-        "exec",
-        "--scope=@appium/test-support",
-        "--",
-        "gulp",
-        "transpile"
-      ],
-      "label": "transpile: @appium/test-support",
-      "problemMatcher": []
-    },
-    {
-      "type": "shell",
-      "command": "npm",
-      "args": [
-        "exec",
-        "--",
-        "lerna",
-        "exec",
-        "--scope=@appium/gulp-plugins",
-        "--",
-        "gulp",
-        "transpile"
-      ],
-      "label": "transpile: @appium/gulp-plugins",
-      "problemMatcher": []
-    },
-    {
-      "type": "shell",
-      "command": "npm",
-      "args": [
-        "exec",
-        "--",
-        "lerna",
-        "exec",
-        "--scope=@appium/doctor",
-        "--",
-        "gulp",
-        "transpile"
-      ],
-      "label": "transpile: @appium/doctor",
-      "problemMatcher": []
-    },
-    {
-      "type": "shell",
-      "command": "npm",
-      "args": [
-        "exec",
-        "--",
-        "lerna",
-        "exec",
-        "--scope=@appium/base-driver",
-        "--",
-        "gulp",
-        "transpile"
-      ],
-      "label": "transpile: @appium/base-driver",
-      "problemMatcher": []
-    },
-    {
-      "type": "npm",
-      "script": "test:e2e:appium",
-      "problemMatcher": [],
-      "label": "npm: test:e2e:appium",
-      "detail": "e2e tests: appium"
-    }
-  ]
-}
@@ -1,66 +0,0 @@
-'use strict';
-
-module.exports = (wallaby) => {
-  return {
-    compilers: {
-      '**/*.js': wallaby.compilers.babel(),
-    },
-    debug: true,
-    env: {
-      type: 'node',
-    },
-    files: [
-      './packages/**/*.js',
-      './packages/**/*.json',
-      '!./packages/**/build/**',
-      '!./packages/**/test/**/*-specs.js',
-      '!./packages/**/test/**/*.spec.js',
-      '!./packages/*/node_modules/**',
-      '!./packages/*/gulpfile.js',
-      '!./packages/*/scripts/**',
-      './packages/*/test/**/fixtures/**/*',
-      './packages/*/test/**/mocks.js',
-      './packages/*/test/helpers.js',
-      './babel.config.json',
-      // below this are fixtures
-      {
-        binary: true,
-        pattern: './packages/support/test/unit/assets/sample_binary.plist',
-      },
-      {
-        instrument: false,
-        pattern: './packages/support/test/unit/assets/sample_text.plist',
-      },
-      {
-        instrument: false,
-        pattern: './packages/base-driver/static/**/*',
-      },
-      {
-        instrument: false,
-        pattern: './packages/gulp-plugins/build/**/*',
-      },
-      // this setup file is special
-      {
-        instrument: false,
-        pattern: './test/setup.js'
-      }
-    ],
-    testFramework: 'mocha',
-    tests: [
-      './packages/*/test/**/*-specs.js',
-      './packages/*/test/unit/**/*.spec.js',
-      '!./packages/*/test/**/*-e2e-specs.js',
-      '!./packages/*/test/e2e/**/*',
-      '!./packages/*/node_modules/**',
-      // this is more of an E2E test and it's tedious to run
-      '!./packages/gulp-plugins/test/transpile-specs.js',
-    ],
-    workers: {
-      restart: true,
-    },
-    setup() {
-      require('./test/setup');
-    },
-    runMode: 'onsave'
-  };
-};
@@ -1,11 +1,12 @@
 ## Appium

 [![NPM version](https://badge.fury.io/js/appium.svg)](https://npmjs.org/package/appium)
-[![Node.js CI](https://github.com/appium/appium/actions/workflows/node.js.yml/badge.svg?branch=2.0)](https://github.com/appium/appium/actions/workflows/node.js.yml)
-
+[![Node.js CI](https://github.com/appium/appium/actions/workflows/node.js.yml/badge.svg)](https://github.com/appium/appium/actions/workflows/node.js.yml)
 [![Monthly Downloads](https://img.shields.io/npm/dm/appium.svg)](https://npmjs.org/package/appium)
-
 [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fappium%2Fappium.svg?type=shield)](https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fappium%2Fappium?ref=badge_shield)
+[![StandWithUkraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://github.com/vshymanskyy/StandWithUkraine/)
+
+[![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner2-direct.svg)](https://vshymanskyy.github.io/StandWithUkraine/)

 Appium is an open-source, cross-platform test automation tool for native,
 hybrid, and mobile web and desktop apps. We support simulators (iOS), emulators
@@ -18,18 +19,9 @@ started](/docs/en/about-appium/getting-started.md) doc.

 Appium supports app automation across a variety of platforms, like iOS,
 Android, and Windows. Each platform is supported by one or more "drivers",
-which know how to automate that particular platform. Choose a driver below for
-specific information about how that driver works and how to set it up:
+which know how to automate that particular platform.

-* iOS
-    * The [XCUITest Driver](/docs/en/drivers/ios-xcuitest.md)
-    * (DEPRECATED) The [UIAutomation Driver](/docs/en/drivers/ios-uiautomation.md)
-* Android
-    * The [Espresso Driver](/docs/en/drivers/android-espresso.md)
-    * The [UiAutomator2 Driver](/docs/en/drivers/android-uiautomator2.md)
-    * (DEPRECATED) The [UiAutomator Driver](/docs/en/drivers/android-uiautomator.md)
-* The [Windows Driver](/docs/en/drivers/windows.md) (for Windows Desktop apps)
-* The [Mac Driver](/docs/en/drivers/mac.md) (for Mac Desktop apps)
+Please refer to [Appium Platform Support](/docs/en/about-appium/platform-support.md) for more details.

 ### Why Appium?

@@ -66,7 +58,7 @@ Concepts](/docs/en/about-appium/intro.md).
 Your environment needs to be set up for the particular platforms that you want
 to run tests on. Each of the drivers above documents the requirements for their
 particular brand of automation. At a minimum, you will need to be able to run
-Node.js 10+.
+Node.js 12+.

 ### Get Started

@@ -74,13 +66,13 @@ Check out our [Getting Started](/docs/en/about-appium/getting-started.md) guide
 to get going with Appium.

 There is also a sample code that contains [many examples of tests in a variety
-of different languages](https://github.com/appium/appium/tree/master/sample-code)!
+of different languages](https://github.com/appium/appium/tree/1.x/sample-code)!

 ### Documentation

 For prettily-rendered docs, please visit [appium.io](http://appium.io). You can
 always find the full list of Appium doc pages at [Appium's GitHub
-Repo](https://github.com/appium/appium/tree/master/docs/en/) as well.
+Repo](https://github.com/appium/appium/tree/1.x/docs/en/) as well.

 [update-appium-io.yml](https://github.com/appium/appium/blob/master/ci-jobs/update-appium-io.yml) creates a PR
 by [CI job](https://dev.azure.com/AppiumCI/Appium%20CI/_build?definitionId=37).
@@ -1,32 +0,0 @@
-{
-  "presets": [
-    [
-      "@babel/preset-env",
-      {
-        "targets": {
-          "node": "12"
-        },
-        "shippedProposals": true
-      }
-    ]
-  ],
-  "plugins": ["source-map-support", "@babel/plugin-transform-runtime"],
-  "comments": false,
-  "sourceMaps": "both",
-  "env": {
-    "coverage": {
-      "plugins": [
-        [
-          "istanbul",
-          {
-            "exclude": ["test", "build"]
-          }
-        ]
-      ]
-    },
-    "test": {
-      "retainLines": true,
-      "comments": true
-    }
-  }
-}
@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+
+/* eslint no-console:0 */
+
+/*
+ * Small tool, launching and monitoring ios-web-kit-proxy, and relaunching
+ * on predefined errors.
+ *
+ * Usage:
+ *  ./bin/ios-webkit-debug-proxy-launcher.js [args]
+ *  args: ios-webkit-debug-proxy args (they will be passed over)
+ *
+ * Example:
+ *  ./bin/ios-webkit-debug-proxy-launcher.js -c <UDID>:27753 -d
+ *
+ *  Note:
+ *   For iOS8.1 try this first:
+ *     brew install --HEAD ideviceinstaller
+ */
+
+'use strict';
+
+const spawn = require('child_process').spawn;
+const _ = require('lodash');
+
+const args = process.argv.slice(2);
+
+const RESTART_ON_MESSAGES = [
+  'Invalid message _rpc_applicationUpdated',
+  'Invalid message _rpc_applicationSentListing'];
+
+const PROXY_CMD = 'ios_webkit_debug_proxy';
+let proxy;
+
+const handleKillProcess = function (exitCode) {
+  console.log('\nKilling proxy process!');
+  proxy.kill('SIGTERM');
+  process.exit((exitCode || 0));
+};
+
+const startProxy = function () {
+  console.log(`RUNNING: ${PROXY_CMD} ${args.join(' ')}`);
+
+  proxy = spawn(PROXY_CMD, args);
+
+  proxy.stdout.on('data', function onStdout (data) {
+    console.log(`stdout: ${data}`);
+  });
+
+  proxy.stderr.on('data', function onStderr (data) {
+    console.log(`stderr: ${data}`);
+    const restartMessage = _(RESTART_ON_MESSAGES).find(function findMessage (message) {
+      return ('' + data).indexOf(message) >= 0;
+    });
+    if (restartMessage) {
+      console.log(`Detected error message: ${restartMessage}`);
+      console.log('Killing proxy!');
+      proxy.kill('SIGTERM');
+      process.nextTick(startProxy);
+    }
+  });
+
+  proxy.on('close', function onClose (code) {
+    console.log(`Child process exited with code ${code}`);
+  });
+};
+
+process.on('SIGINT', handleKillProcess);
+process.on('SIGTERM', handleKillProcess);
+
+startProxy();
@@ -1,13 +1,11 @@
-#!/usr/bin/env node
-
-const path = require('path');
 const childProcess = require('child_process');
 const _ = require('lodash');

-const res = JSON.parse(childProcess.execSync('npm pack --dry-run --json --ignore-scripts', {cwd: path.join(__dirname, '..'), encoding: 'utf8'}))[0];
+const res = JSON.parse(childProcess.execSync('npm pack --dry-run --json --ignore-scripts', {encoding: 'utf8'}))[0];

 // List of files we are testing to make sure they are included in package
 const testFiles = [
+  'npm-shrinkwrap.json', // Check that npm-shrinkwrap.json is being packed
  'LICENSE', // Check that license is included
  'build/lib/appium.js', // Sanity check that build files are being included by testing just one file
 ];
@@ -0,0 +1,25 @@
+const _ = require('lodash');
+const { asyncify } = require('asyncbox');
+const { fs, logger } = require('appium-support');
+const path = require('path');
+
+const log = new logger.getLogger('ShrinkwrapValidator');
+
+async function main () {
+  const shrinkwrapPath = path.resolve('npm-shrinkwrap.json');
+  if (!(await fs.exists(shrinkwrapPath))) {
+    log.info('No shrinkwrap found. Skipping shrinkwrap check');
+    return;
+  }
+  const shrinkwrap = JSON.parse(await fs.readFile(shrinkwrapPath));
+  const backupShrinkwrap = JSON.parse(await fs.readFile(path.resolve('npm-shrinkwrap-backup.json')));
+  log.info('Checking that pruned shrinkwrap is a subset of primary shrinkwrap');
+  if (!_.isMatch(backupShrinkwrap, shrinkwrap)) {
+    log.errorAndThrow('Pruned shrinkwrap (shrinkwrap with dev dependencies removed) is not a subset of the original npm-shrinkwrap.json');
+  }
+  log.info('Shrinkwrap check passed');
+}
+
+if (require.main === module) {
+  asyncify(main);
+}
@@ -0,0 +1,29 @@
+steps:
+- task: NodeTool@0
+  inputs:
+    versionSpec: '12.x'
+- script: npm install
+  displayName: NPM install
+- script: |
+    git remote add triager https://triager:$GITHUB_TOKEN@github.com/appium/appium
+    git checkout -b $MINOR_BRANCH_NAME
+    git status
+    node ./ci-jobs/scripts/set-package-json-version
+    rm -rf package-lock.json
+    npm shrinkwrap
+    git add .
+    git commit -n -m "Set version to $(MINOR_BRANCH_NAME).0-rc.0"
+    git push -u triager $MINOR_BRANCH_NAME
+  displayName: Create branch
+  env:
+    GITHUB_TOKEN: $(GITHUB_TOKEN)
+    MINOR_BRANCH_NAME: $(MINOR_BRANCH_NAME)
+- script: |
+    git tag $MINOR_BRANCH_NAME.0-rc.0
+    git push --tags -u triager
+    echo "//registry.npmjs.org/:_authToken=$NPM_TOKEN" > .npmrc
+    npm publish --tag $(node ./ci-jobs/scripts/parse-tag)
+  env:
+    NPM_TOKEN: $(NPM_TOKEN)
+  displayName: Tag and Publish
+
@@ -1,8 +1,8 @@
 # parameters: # No params yet, but may add later
 jobs:
  - job: generate_docs
-    pool: 
-      vmImage: "macOS 10.14"
+    pool:
+      vmImage: "macOS-latest"
    variables:
      CC: gcc
      CXX: g++
@@ -15,7 +15,11 @@ jobs:
        npm install
        brew install hub
        hub --version
+        git config --global user.name "Appium Maintainers"
+        git config --global user.email "maintainers@appium.io"
        git remote add triager https://triager:$GITHUB_TOKEN@github.com/appium/appium
+        # Change the main branch
+        git checkout 1.x
        git checkout -b generate-docs-$BUILD_SOURCEVERSION
        git status
      displayName: Checkout Generate Docs Branch
@@ -33,7 +37,7 @@ jobs:
        if [[ -n $(git status -s) ]]; then
          git commit -a -n -m 'Update generated docs [ci skip]'
          git push triager generate-docs-$BUILD_SOURCEVERSION
-          hub pull-request -b "appium:master" -h "appium:generate-docs-$BUILD_SOURCEVERSION" -m "docs: Update auto-generated docs"
+          hub pull-request -b "appium:1.x" -h "appium:generate-docs-$BUILD_SOURCEVERSION" -m "docs: Update auto-generated docs for Appium 1"
        fi
      displayName: Generate Docs and Make PR
      env:
@@ -2,7 +2,7 @@
 jobs:
  - job: bundle_and_upload_appium_zip
    pool:
-      vmImage: 'macOS 10.14'
+      vmImage: 'macOS-latest'
    variables:
      CC: gcc
      CXX: g++
@@ -12,7 +12,7 @@ jobs:
    - task: NodeTool@0
      inputs:
        versionSpec: '12.x'
-    - script: npm install
+    - script: npm ci || npm install # "npm ci" if shrinkwrap is present
      displayName: Install NPM Dependencies
    - script: npm run build
      displayName: npm run build
@@ -2,14 +2,14 @@
 jobs:
  - job: update_appium_io
    pool:
-      vmImage: 'Ubuntu-18.04'
+      vmImage: 'Ubuntu-20.04'
    variables:
      CC: gcc
      CXX: g++
    steps:
    - task: NodeTool@0
      inputs:
-        versionSpec: '10.x'
+        versionSpec: '14.x'
    - script: |
        pip install mkdocs==0.16.3
        git config --global user.email "maintainers@appium.io"
@@ -28,4 +28,4 @@ jobs:
        popd
      displayName: Make branch with Updated Docs and make PR
      env:
-        GITHUB_TOKEN: $(GITHUB_TOKEN)
+        GITHUB_TOKEN: $(GITHUB_TOKEN)
@@ -7,9 +7,6 @@ example_usage:
    |
      driver.startRecordingScreen();
      driver.startRecordingScreen(new BaseStartScreenRecordingOptions(....));
-  javascript_wd:
-    |
-      await driver.startRecordingScreen();
  javascript_wdio:
    |
      driver.startRecordingScreen();
@@ -37,7 +34,6 @@ example_usage:
 client_docs:
  java: "https://static.javadoc.io/io.appium/java-client/6.1.0/io/appium/java_client/screenrecording/CanRecordScreen.html#startRecordingScreen-T-"
  python: "https://appium.github.io/python-client-sphinx/webdriver.extensions.html#webdriver.extensions.screen_record.ScreenRecord.start_recording_screen"
-  javascript_wd: "https://github.com/admc/wd/blob/master/lib/commands.js#L3412"
  javascript_wdio: "https://webdriver.io/docs/api/appium.html#startrecordingscreen"
  ruby:
    - android: "https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Android/Device#start_recording_screen-instance_method"
@@ -8,7 +8,7 @@ example_usage:
      element.clear();
  python:
    |
-      self.driver.find_element_by_accessibility_id('SomeAccessibilityID').clear()
+      self.driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value="SomeAccessibilityID").clear()
  javascript_wd:
    |
      let element = await driver.elementByAccessibilityId("SomeAccessibilityID");
@@ -13,8 +13,8 @@ example_usage:
      el.click();
  python:
    |
-      el = self.driver.find_element_by_accessibility_id('SomeId')
-      el.click();
+      el = self.driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value='SomeId')
+      el.click()
  javascript_wd:
    |
      let element = await driver.elementByAccessibilityId('id', 'SomeId');
@@ -14,7 +14,7 @@ example_usage:
      element.sendKeys("Hello world!");
  python:
    |
-      self.driver.find_element_by_accessibility_id('SomeAccessibilityID').send_keys('Hello world!')
+      self.driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value="SomeAccessibilityID").send_keys('Hello world!')
  javascript_wd:
    |
      let element = await driver.elementByAccessibilityId("SomeAccessibilityID");
@@ -62,7 +62,7 @@ client_support:

 # Information about the HTTP endpoints
 endpoint:
-  url: /session/:session_id/elements/:element_id/attribute/:name
+  url: /session/:session_id/element/:element_id/attribute/:name
  method: 'GET'
  url_parameters:
    - name: session_id
@@ -67,7 +67,7 @@ client_support:

 # Information about the HTTP endpoints
 endpoint:
-  url: /session/:session_id/elements/:element_id/css/:property_name
+  url: /session/:session_id/element/:element_id/css/:property_name
  method: GET
  url_parameters:
    - name: session_id
@@ -44,7 +44,7 @@ client_support:

 # Information about the HTTP endpoints
 endpoint:
-  url: /session/:session_id/elements/:element_id/location_in_view
+  url: /session/:session_id/element/:element_id/location_in_view
  method: GET
  url_parameters:
    - name: session_id
@@ -63,7 +63,7 @@ client_support:

 # Information about the HTTP endpoints
 endpoint:
-  url: /session/:session_id/elements/:element_id/location
+  url: /session/:session_id/element/:element_id/location
  method: GET
  url_parameters:
    - name: session_id
@@ -61,7 +61,7 @@ client_support:

 # Information about the HTTP endpoints
 endpoint:
-  url: /session/:session_id/elements/:element_id/name
+  url: /session/:session_id/element/:element_id/name
  method: 'GET'
  url_parameters:
    - name: session_id
@@ -63,7 +63,7 @@ client_support:

 # Information about the HTTP endpoints
 endpoint:
-  url: /session/:session_id/elements/:element_id/rect
+  url: /session/:session_id/element/:element_id/rect
  method: GET
  url_parameters:
    - name: session_id
@@ -63,7 +63,7 @@ client_support:

 # Information about the HTTP endpoints
 endpoint:
-  url: /session/:session_id/elements/:element_id/size
+  url: /session/:session_id/element/:element_id/size
  method: GET
  url_parameters:
    - name: session_id
@@ -12,7 +12,7 @@ example_usage:
      MobileElement elementTwo = (MobileElement) driver.findElementByClassName("SomeClassName");
  python:
    |
-      el = driver.find_element(AppiumBy.ACCESSIBILITY_ID,'SomeAccessibilityID')
+      el = self.driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value="SomeAccessibilityID")
  javascript_wd:
    |
      let elementOne = await driver.elementByAccessibilityId("SomeAccessibilityID");
@@ -84,4 +84,4 @@ endpoint:
 # Links to specifications. Should link to at least one specification
 specifications:
  w3c: https://www.w3.org/TR/webdriver/#find-element
-  jsonwp: https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#sessionsessionidelement
+  jsonwp: https://www.selenium.dev/documentation/legacy/json_wire_protocol/#sessionsessionidelement
@@ -104,4 +104,4 @@ endpoint:
 # Links to specifications. Should link to at least one specification
 specifications:
  w3c: https://www.w3.org/TR/webdriver/#dfn-find-elements
-  jsonwp: https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#sessionsessionidelements
+  jsonwp: https://www.selenium.dev/documentation/legacy/json_wire_protocol/#sessionsessionidelements
@@ -38,14 +38,14 @@ client_docs:
 # Driver support by platform
 driver_support:
  ios:
-    xcuitest: false
+    xcuitest: true
    uiautomation: false
  android:
-    uiautomator2: false
-    espresso: false
+    uiautomator2: true
+    espresso: true
    uiautomator: false
  mac:
-    mac: false
+    mac: true
  windows:
    windows: false
 client_support:
--- a/Show More
+++ b/Show More