Install Test Companion in Eclipse

Install Test Companion in Eclipse IDE to generate, automate, and fix test cases without leaving your editor.

Test Companion for Eclipse is not listed on Eclipse Marketplace. You install it from the BrowserStack update site instead. The plugin needs Eclipse IDE 2024-03 or later and Java 17.

Prerequisites

Before you start, check that you have:

• A BrowserStack account. Create one if you do not have one yet.
• Eclipse IDE 2024-03 or later, on Windows, macOS, or Linux.
• Java 17 or later as the runtime that Eclipse uses. Eclipse refuses to install the plugin on an older runtime.

The plugin runs in any Eclipse IDE package. Examples include Eclipse IDE for Java Developers and Eclipse IDE for Enterprise Java and Web Developers. Packages from 2024-03 onward bundle a Java runtime that meets the requirement. To check your version, choose Help > About Eclipse IDE.

Install the plugin

Complete these steps in Eclipse:

1. On the menu bar, choose Help > Install New Software. The Install dialog opens.

   

2. Click Add. The Add Repository dialog opens.
3. In the Name box, enter Test Companion.

4. In the Location box, enter https://test-companion.browserstack.com/eclipse/updates/latest/.

   

5. Click Add. Eclipse reads the update site and lists the software it contains.

   

6. Select the BrowserStack Test Companion checkbox, then click Next. Eclipse lists the Test Companion feature inside that category.

   

7. Review the install details, then click Next.

8. On the Review Licenses page, select I accept the terms of the license agreements, then click Finish.

   

9. In the Trust Authorities dialog, select the https://test-companion.browserstack.com checkbox, then click Trust Selected.

   

10. When prompted, click Restart Now.

The install registers the BrowserStack update site in Eclipse. Eclipse checks the site for new versions whenever you choose Help > Check for Updates.

Verify the installation

After Eclipse restarts, a Test Companion menu appears on the menu bar. Open the Test Companion panel in any of these ways:

• Choose Test Companion > Open Test Companion.
• Click Test Companion on the main toolbar.
• Press Ctrl+Alt+I on Windows and Linux, or Cmd+Option+I on macOS.

Eclipse switches to the Test Companion perspective. Project Explorer is on the left, the editor in the center. The Test Companion panel docks on the right. Panels such as Test Cases and Failure Analysis open as tabs in the editor area.

If you close the perspective, you can open the panel on its own:

1. Choose Window > Show View > Other.
2. Expand Test Companion.
3. Select Test Companion, then click Open.

When the Test Companion menu is missing after the restart, check whether the install completed:

1. Choose Help > About Eclipse IDE.
2. Click Installation Details.
3. On the Installed Software tab, look for Test Companion.

If Test Companion is not listed, repeat the install steps. If it is listed, restart Eclipse.

Sign in to BrowserStack

1. Open the Test Companion panel.

2. Click Sign in with BrowserStack.

   

3. Your default browser opens a BrowserStack sign-in page.
4. Sign in, then authorize the plugin when asked.

The browser shows a confirmation message and closes the tab. If the tab stays open, close it and return to Eclipse. Back in Eclipse, the Test Companion panel shows your account details.

The sign-in request expires after five minutes. If you did not finish in time, click Sign in with BrowserStack again.

Next steps

• Generate test cases: Write test cases from requirements using AI.
• Automate tests with AI: Convert manual test cases into executable automation scripts.
• Fix failed tests: Debug and fix test failures using Test Reporting & Analytics.