Eclipse Quick Start¶
Use this guide for Eclipse or Spring Tools teams that need project scans, problem markers, report history, comparison, and source navigation.
1. Confirm the deployment requirements¶
Have the Eclipse plugin artifact and an issued postq.lic available. This deployment requires
Eclipse or Spring Tools, Java, OpenGrep, and a supported embedded browser runtime.
2. Install prerequisites¶
Use your organization's approved software distribution process, or install from the publisher resources:
- Eclipse downloads
- Spring Tools
- Eclipse Temurin installation
- OpenGrep installation
- Microsoft Edge WebView2
Then run the supplied pre-install check:
.\postq-code-scanner-preinstall-check.ps1 -Profile eclipse
bash ./postq-code-scanner-preinstall-check.sh --profile eclipse
On Windows, ensure the Eclipse SWT Browser can use a current Microsoft Edge WebView2 runtime.
For platform notes and supported versions, see Prerequisites.
3. Install the plugin¶
The beta postq-code-scanner-eclipse-plugin-<version>.zip is an Eclipse PDE project package rather
than a p2 update site. Follow the README inside the archive to import or install it in the target
Eclipse environment.
Open the PostQ perspective:
Window > Perspective > Open Perspective > Other > PostQ Crypto Readiness
4. Configure activation¶
Open:
Window > Preferences > PostQ Crypto Readiness
Set Offline license file to the full path of postq.lic. Set the scanner-service or OpenGrep
path only when the defaults do not resolve correctly for the Eclipse process.
5. Scan a project¶
- Download and extract the Java Quick Start project, or choose a representative repository.
- Use File > Open Projects from File System to import the extracted
postq-java-quickstartdirectory. - Select the project in Project Explorer or Package Explorer.
- Open PostQ Code Scan from the context menu.
- Select Scan Project.
- Monitor the PostQ console until scanner-service exits.
6. Review the result¶
- Expand the project in the Reports view.
- Double-click the newest completed scan.
- Review the PostQ Code Scan Report.
- Open a report row to navigate to source when available.
Success checklist¶
- The PostQ console reports successful generation.
- A completed scan appears in the Reports view.
- The report opens in the embedded browser.
- Problem markers and source navigation use backend-generated locations.
Next: Eclipse usage.