| monobuild: a combined Studio/IntelliJ source build |
| === |
| |
| The monobuild combines the IntelliJ Community project and the Android Studio project |
| into a single combined IDE build. This can be helpful when working on features that |
| span both projects (since it quickens the edit/compile/debug cycle significantly). |
| |
| Usage |
| --- |
| Run `./generate.py` and then open this directory in IntelliJ. |
| |
| From there you can launch the Android Studio run configuration as usual. |
| |
| Limitations |
| --- |
| |
| * If you change the project structure (e.g. module dependencies) of Studio code, then |
| you will need to re-run `generate.py` for those changes to take effect in the monobuild. |
| |
| * If you change the project structure of IntelliJ Platform, then you will need to run `generate.py` |
| with flag `--rebuild-intellij-module-descriptors` (or update intellij-sdk prebuilts). |
| |
| * The `generate.py` script is expected to break occasionally, such as when there are new conflicts |
| between Studio/IntelliJ configuration files. Please spend a few minutes debugging to see if it |
| is an easy fix. Otherwise, file a bug. |
| |
| Tips |
| --- |
| * See the [IntelliJ README](https://github.com/JetBrains/intellij-community/blob/master/README.md) |
| for IDE build configuration tips. |
| |
| * To test code changes in `generate.py`, you should diff the generated output against previous runs. |
| You can utilize `git diff --no-index <before> <after>` for this. |
| |
| * You can use the "Load/Unload Modules" action in the IDE to exclude any broken modules |
| (assuming these modules are not needed by the run configurations you care about). |
