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 a plugin listed on Eclipse Marketplace. If your organization blocks the Marketplace, add the BrowserStack update site under Help > Install New Software instead. Both paths need 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

Eclipse Marketplace is the default path. Use the update site only when a policy blocks the Marketplace, or when your Eclipse package lacks the Marketplace Client.

Install from Eclipse Marketplace

1. On the menu bar, choose Help > Eclipse Marketplace. The Eclipse Marketplace dialog opens.

   

2. In the Find box, type Test Companion, then click Go.

   

3. Find the Test Companion entry from BrowserStack in the results.
4. Click Install.
5. Review the features to install, then click Confirm.

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

   

7. In the Trust Authorities dialog, select the https://test-companion.browserstack.com check box, then click Trust Selected.

   

8. When prompted, click Restart Now.

Install from the update site

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 check box, 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 check box, then click Trust Selected.

   

10. When prompted, click Restart Now.

Both install paths register 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.