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.
TIP: If you do not wish to use
mr
, just usegit clone
as usual to clone whicheverbisq-*
repositories you wish to work with. So long as they are checked out directly within your clone of this repository, the instructions below will work fine.
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. - If you encounter compilation errors related to the
io.bisq.generated.protobuffer.PB
class, you need to run thegenerateProto
task in thecore
project. You can do this via the Gradle tool window in IDEA, or you can do it the command line withcd core; ./gradlew generateProto
. RunBuild->Build project
again and you should have no errors.