Latest revision as of 11:08, 17 April 2026

Setup

Install from https://antigravity.google/
Switch to visual studio code marketplace (Gear icon > Open Antigravity User Settings > Editor):
- https://marketplace.visualstudio.com/items (Marketplace Item URL)
- https://marketplace.visualstudio.com/_apis/public/gallery (Marketplace Gallery URL)
Install Extension Pack for Java extension
Install Eclipse PDE Support extension
File > Open Folder... , select iDempiere source folder
File > Add Folder to Workspace... , add idempiere-rest source folder to your workspace
File > Add Folder to Workspace... , add your other project source folder to your workspace

File > Save Workspace As... to save your workspace

Add the following properties to "settings" in the save .code-workspace file to prevent unnecessary formatting only changes:

"settings": {
    "editor.formatOnSave": false,
    "editor.formatOnType": false,
    "editor.formatOnPaste": false,
    "editor.codeActionsOnSave": {
        "source.fixAll": "never",
        "source.organizeImports": "never"
    },
    "java.configuration.updateBuildConfiguration": "disabled",
    "java.configuration.runtimes": [
    {
            "name": "JavaSE-17",
            "path": "/usr/lib/jvm/java-17-temurin-jdk",
            "default": true
    }
    ],
    "java.project.resourceFilters": [],
    "files.eol": "\n",
    "files.trimTrailingWhitespace": false,
    "files.insertFinalNewline": false,
    "files.trimFinalNewlines": false
}

Replace "path": "/usr/lib/jvm/java-17-temurin-jdk" with your JDK17 path. The default JVM configuration is important for test and remote debugging.

"java.project.resourceFilters": [] is to stop antigravity adding the following to .project files:

<filteredResources>
<filter>
    <id>1774448868880</id>
    <name></name>
    <type>30</type>
    <matcher>
        <id>org.eclipse.core.resources.regexFilterMatcher</id>
        <arguments>node_modules|\.git|__CREATED_BY_JAVA_LANGUAGE_SERVER__</arguments>
    </matcher>
</filter>
</filteredResources>

Add the following to {idempiere source folder}/.git/info/exclude file:

.project
.vscode
*.properties
*.ks
**/.settings/
*.sh
**/*.launch
*.blacklist
*.blacklist.*
*.code-workspace

To ignore changes to tracked .project files:

git update-index --skip-worktree **/.project

To restore tracking of .project files:

git update-index --no-skip-worktree **/.project

To set active target platform, right click on the target definition file (.target file) and select Reload Target Platform

Optional

Install Eclipse Keymap extension to use Eclipse Key Binding
Enable browser extension (Gear Icon > Open Antigravity User Settings > Enable Browser Tools)
Install Gemini CLI: https://github.com/google-gemini/gemini-cli
Enable Gemini CLI integration with antigravity: /ide install
- Note that this might be needed for /ide install: sudo ln -s /usr/bin/antigravity /usr/local/bin/agy
Install iDempiere examples for Gemini CLI
- gemini skills install https://github.com/hengsin/idempiere-examples
Install iDempiere skills for Gemini CLI: https://github.com/hengsin/idempiere-skills
Add more source folder to your workspace (File > Add Folder to Workspace...)
- iDempiere MCP Server

What you still need from Eclipse

Create new launch configuration
Check and fix target platform state

Tips

There's no build in tool to create OSGi component XML file from annotation but you can ask the agent to do that for you.
To run a launch configuration, right click on launch configuration (.launch file) and select Debug PDE Application
- A new launch configuration entry will be added to the launch.json file.
- If the startup workspace folder is wrong, add the "cwd" property in launch.json to fix that (for e.g, "cwd": "/home/hengsin/idempiere-workspace/idempiere").
- If it is not launch with the intended Java runtime environment, add "javaExec" property in launch.json to set the Java runtime environment to use. This property should contain the absolute path of the Java executable to use (for e.g, "javaExec": "/usr/lib/jvm/java-17-temurin-jdk/bin/java").
- After the initial launch, open the Run/Debug View and launch from the drop down list of available launch configuration.
- Note that if you use Right Click > Debug PDE Application to launch a launch configuration again, it will overwrite the changes that you have make to the launch.json file.
- If there are changes to a .launch file, remove the entry from launch.json to recreate it from the latest .launch file.
- Add "projectName": "org.adempiere.base" to enable evaluation of expression in debug (using the Debug Console).
- You can use inline comment as instruction to guide the agent to generate code for your need. You can remove the inline comment after you have accept or reject the generated code.
Automatic build can cause conflict with mvn build. You might want to disable automatic build if you frequently use maven to run build or run unit test.

Add Customizations rule to guide the agent on the running of mvn build and unit test for iDempiere:

**For running of unit test and integration test using maven**
* Run from workspace root folder
* Set JAVA_HOME to /usr/lib/jvm/java-17-temurin-jdk
* mvn integration-test -DskipTests=false -DmaterializeProduct=none -DassembleRepository=none -Dtest=**test class name**
* Always run in terminal

After making changes to MANIFEST.MF, run Full Build to resolve build errors.
If you have an IDE or workspace settings that you can't locate the place to change it, try ask the agent to do it for you.
To debug integration test
- Add the following to "configurations" in launch.json:
```
{
     "type": "java",
     "request": "attach",
     "name": "Attach by Process ID",
     "processId": "${command:PickJavaProcess}",
     "projectName": "org.adempiere.base"
}
```
- Add -DdebugPort=5005, for e.g, ./mvnw --offline integration-test -DskipTests=false -Dtest=EnvTest -DdebugPort=5005
- With the -DdebugPort=5005 option, the test will start and "freeze" at 0% with a message like: Listening for transport dt_socket at address: 5005
- At Run and Debug, start the Attach by Process ID configuration. A dialog will popup for you to select the process that's waiting for connection at port 5005.
Some useful shortcuts:
- Ctrl+R : Open recent workspaces.
- Ctrl+P : Open recent files.
- Shift+Alt+B : Invoke Incremental or Full Build.
Antigravity doesn't has build in support for generation of SerialVersionUID. Install the Code Generator For Java extension to get that.

Difference between revisions of "Antigravity.md"

Latest revision as of 11:08, 17 April 2026

Setup

Optional

What you still need from Eclipse

Tips