haveno-reto/docs/import-haveno.md

## Importing Haveno into development environment

This document describes how to import Haveno into an integrated development environment (IDE).

## Importing Haveno into Eclipse IDE

These steps describe how to import Haveno into Eclipse IDE for development. You can also develop using [IntelliJ IDEA](#importing-haveno-into-intellij-idea) or VSCode if you prefer.

> Note: Use default values unless specified otherwise.

1. If you haven't already, first [install and run a Haveno test network](installing.md).
2. Download and run the [Eclipse](https://www.eclipse.org/downloads/) installer.
3. Select "Eclipse IDE for Enterprise Java and Web Developers" to install.
4. Launch an eclipse workspace and close out of the welcome screen.
5. [Download](https://search.maven.org/search?q=g:org.projectlombok%20AND%20a:lombok&core=gav) the latest version of the lombok jar.
6. Run lombok jar, e.g.: `java -jar ~/Downloads/lombok-1.18.22.jar`.
7. Follow prompts to install lombok to your Eclipse installation.
8. Restart Eclipse.
9. File > Import... > Existing Gradle Project.
10. Select the location of "haveno" project, e.g. ~/git/haveno.
11. Advance to finish importing haveno project.
12. Right click haveno project > Gradle > Refresh Gradle Project.
13. File > Import... > Existing Projects into Workspace.
14. Select the location of "haveno-ui-poc" project, e.g. ~git/haveno-ui-poc.
15. Advance to finish importing haveno-ui-poc project.

You are now ready to make, run, and test changes to the Haveno project!

## Importing Haveno into IntelliJ IDEA

> Note: These instructions are outdated and for Bisq.

Most Bisq contributors use IDEA for development. The following instructions have been tested on IDEA 2021.1.

1. Follow the instructions in [build.md](build.md) to clone and build Bisq at the command line.
1. Open IDEA
1. Go to `File -> Settings -> Build, Execution, Deployment -> Compiler -> Annotation Processors` and check the `Enable annotation processing` option to enable processing of Lombok annotations (Lombok plugin installed by default since v2020.3)
1. Go to `File -> New -> Project from Existing Sources...` and then select the main Bisq folder to load automatically the related Gradle project
1. If you did not yet setup JDK11 in IntelliJ, go to `File-> Project Structure -> Project` and under the `Project SDK` option locate your JDK11 folder
1. Select JDK 11 for Gradle as well. Go to `File -> Settings -> Build, Execution, Deployment -> Build Tools -> Gradle` and select the JDK11 location for the Gradle JVM value
1. Go to `Build -> Build Project`. Everything should build cleanly
1. Go to `Run > Edit Configurations... -> Plus (+) icon on the top left -> Application` anf then fill the requested fields as shown below, while using as CLI arguments one of those listed in [dev-setup.md](dev-setup.md):

![edit_configurations.png](edit_configurations.png)

9. Now you should be able to run Bisq by clicking on the _Play_ button or via `Run -> Run 'Bisq Desktop'`
10. If you want to debug the application and execute breakpoints, use `Run -> Debug 'Bisq Desktop'`

> TIP: If you encounter compilation errors in IDEA related to the `protobuf.*` classes, it is probably because you didn't build Bisq at the command line as instructed above. You need to run the `generateProto` task in the `other` project. You can do this via the Gradle tool window in IDEA, or you can do it the command line with `./gradlew :other:generateProto`. Once you've done that, run `Build -> Build Project` again and you should have no errors.
>
> If this does not solve the issue, try to execute `./gradlew clean` and then rebuild the project again.
add developer guide and cleanup docs 2021-10-30 15:34:32 +02:00			`## Importing Haveno into development environment`

			`This document describes how to import Haveno into an integrated development environment (IDE).`

			`## Importing Haveno into Eclipse IDE`

improve eclipse documentation 2021-11-09 16:57:58 +01:00			`These steps describe how to import Haveno into Eclipse IDE for development. You can also develop using [IntelliJ IDEA](#importing-haveno-into-intellij-idea) or VSCode if you prefer.`
add developer guide and cleanup docs 2021-10-30 15:34:32 +02:00
			`> Note: Use default values unless specified otherwise.`

improve eclipse documentation 2021-11-09 16:57:58 +01:00			`1. If you haven't already, first [install and run a Haveno test network](installing.md).`
			`2. Download and run the [Eclipse](https://www.eclipse.org/downloads/) installer.`
			`3. Select "Eclipse IDE for Enterprise Java and Web Developers" to install.`
			`4. Launch an eclipse workspace and close out of the welcome screen.`
			`5. [Download](https://search.maven.org/search?q=g:org.projectlombok%20AND%20a:lombok&core=gav) the latest version of the lombok jar.`
			6. Run lombok jar, e.g.: `java -jar ~/Downloads/lombok-1.18.22.jar`.
			`7. Follow prompts to install lombok to your Eclipse installation.`
			`8. Restart Eclipse.`
			`9. File > Import... > Existing Gradle Project.`
			`10. Select the location of "haveno" project, e.g. ~/git/haveno.`
			`11. Advance to finish importing haveno project.`
			`12. Right click haveno project > Gradle > Refresh Gradle Project.`
			`13. File > Import... > Existing Projects into Workspace.`
			`14. Select the location of "haveno-ui-poc" project, e.g. ~git/haveno-ui-poc.`
			`15. Advance to finish importing haveno-ui-poc project.`
add developer guide and cleanup docs 2021-10-30 15:34:32 +02:00
			`You are now ready to make, run, and test changes to the Haveno project!`

			`## Importing Haveno into IntelliJ IDEA`

			`> Note: These instructions are outdated and for Bisq.`
Bisq 2021-05-05 02:20:01 +02:00
			`Most Bisq contributors use IDEA for development. The following instructions have been tested on IDEA 2021.1.`

			`1. Follow the instructions in [build.md](build.md) to clone and build Bisq at the command line.`
			`1. Open IDEA`
			1. Go to `File -> Settings -> Build, Execution, Deployment -> Compiler -> Annotation Processors` and check the `Enable annotation processing` option to enable processing of Lombok annotations (Lombok plugin installed by default since v2020.3)
			1. Go to `File -> New -> Project from Existing Sources...` and then select the main Bisq folder to load automatically the related Gradle project
			1. If you did not yet setup JDK11 in IntelliJ, go to `File-> Project Structure -> Project` and under the `Project SDK` option locate your JDK11 folder
			1. Select JDK 11 for Gradle as well. Go to `File -> Settings -> Build, Execution, Deployment -> Build Tools -> Gradle` and select the JDK11 location for the Gradle JVM value
			1. Go to `Build -> Build Project`. Everything should build cleanly
			1. Go to `Run > Edit Configurations... -> Plus (+) icon on the top left -> Application` anf then fill the requested fields as shown below, while using as CLI arguments one of those listed in [dev-setup.md](dev-setup.md):

			`![edit_configurations.png](edit_configurations.png)`

			9. Now you should be able to run Bisq by clicking on the _Play_ button or via `Run -> Run 'Bisq Desktop'`
			10. If you want to debug the application and execute breakpoints, use `Run -> Debug 'Bisq Desktop'`

			> TIP: If you encounter compilation errors in IDEA related to the `protobuf.*` classes, it is probably because you didn't build Bisq at the command line as instructed above. You need to run the `generateProto` task in the `other` project. You can do this via the Gradle tool window in IDEA, or you can do it the command line with `./gradlew :other:generateProto`. Once you've done that, run `Build -> Build Project` again and you should have no errors.
			`>`
add developer guide and cleanup docs 2021-10-30 15:34:32 +02:00			> If this does not solve the issue, try to execute `./gradlew clean` and then rebuild the project again.