This repository contains a .mrconfig
file that makes it simple to clone all bisq-network
repositories. Here's how to use it:
brew install mr # or equivalent
git clone https://github.com/bisq-network/bisq # clone this repositories
cd bisq
mr checkout # clone all bisq-* repositories
See the myrepos homepage for more details on mr
.
If you do not wish to use mr
, then run grep checkout .mrconfig | cut -d'=' -f2
and copy and paste the git clone
commands for the repositories you want to work with.
Once you've checkout out the repositories you want to work with, run a full Gradle build from the root directory
./gradlew build
This repository also contains a settings.gradle
file that defines a composite build consisting of all bisq-*
that have been checked out above. This makes it easy to import all bisq-*
components into a single IDEA project as follows:
- Go to
Import Project
, selectsettings.gradle
and clickOpen
- In the
Import Project from Gradle
screen, check theUse auto-import
option and clickOK
- When prompted whether to overwrite the existing
.idea
directory, clickYes
- Go to
Preferences->Build, Execution, Deployment->Compiler->Annotation Processors
and check theEnable annotation processing
option (to enable processing of Lombok annotations) - In the
Project
tool window, right click on the root-level.idea
folder, selectGit->Revert...
and click OK in the dialog that appears (to restore source-controlled.idea
configuration files that get overwritten during project import) - Go to
Help->Edit Custom Properties...
, add a line to the file that readsidea.max.intellisense.filesize=12500
, then quit and restart IDEA (to handle Bisq's very large generatedPB.java
Protobuf source file) - Go to
Build->Build project
. Everything should build cleanly. You should be able to run tests, runmain
methods in any component, etc.
TIP: If you encounter compilation errors related to the
io.bisq.generated.protobuffer.PB
class, it is probably because you didn't run the full Gradle build above. You need to run thegenerateProto
task in thecommon
project. You can do this via the Gradle tool window in IDEA, or you can do it the command line withcd common; ./gradlew generateProto
. Once you've done that, runBuild->Build project
again and you should have no errors.