The Appium 1 → Appium 2 Migration feature allows users to upgrade an existing Appium 1 project by creating a new Appium 2 project based on the selected project’s current structure.

With this feature, users can migrate their existing scenarios, plans, project configuration, repository setup, and device selections through a guided step-by-step upgrade flow.

The original Appium 1 project is not overwritten. Instead, the system creates a new Appium 2 project by cloning the selected project’s related data.

Appium 2 introduces a different structure and dependency model compared to Appium 1. Because of this, migrating projects manually may require users to recreate project definitions, scenarios, plans, and device configurations.

This feature reduces that manual effort by providing a controlled migration flow where users can:

The migration can be started from the Projects page.

The first step displays the selected Appium 1 project information.

On this screen, the user can review:

The screen also explains what will be cloned during the migration.

The following items are included in the migration:

This step helps the user confirm that the correct Appium 1 project has been selected before continuing.

In this step, the user defines the name of the new Appium 2 project.

The system displays:

The new project name will be used when creating the Appium 2 project. The Git project folder name is also shown so the user can verify how the repository folder will be created.

The screen also indicates that the Git repository will be created under the configured repository path.

In this step, the user reviews the repository configuration for the new Appium 2 project.

The system shows the target repository information and explains what will happen during the repository preparation process.

After repository validation, the system displays a success message indicating that the repository access has been successfully verified and the tool can proceed to the next step.

In this step, the user reviews which scenarios and plans will be cloned to the new Appium 2 project.

The screen displays two sections:

The user can see the existing scenarios and plans from the selected Appium 1 project before proceeding.

This step ensures that the user understands what will be carried over into the new Appium 2 project.

After continuing from this step, the selected scenarios and plans are prepared for cloning into the new Appium 2 project.

In this step, the user selects the devices that will be assigned to the new Appium 2 project.

The screen allows filtering devices by platform and other available criteria.

Available filters may include:

The user can then select devices from the available device list.

Shared device configurations are not automatically migrated between Appium 1 and Appium 2. The user must select the devices that should be available for the migrated Appium 2 project.

This ensures that the new project uses compatible and explicitly selected devices.

The final step displays the migration summary before the upgrade is completed.

The summary includes the new Appium 2 project information and the items that will be cloned.

The screen shows information such as:

The user should review this information before clicking Complete Migration.