.. contents:: :local:
This script generates all the IML files, library descriptors, and the modules.xml file needed to have a complete Liferay project that successfully resolves imports in JSPs and Java files across the 1000+ modules in Liferay.
If you're more of a visual person and would like screenshots to better understand what that actually means, check the ABOUT <ABOUT.rst>
__ file.
To setup the script, please use the following steps.
Install NodeJS <https://nodejs.org/en/download/releases/>
(tested with NodeJS 0.12.x, 4.x, 6.x, and 8.x), or use Node Version Manager <https://github.com/nvm-sh/nvm>
to allow for multiple versions of NodeJS (needed if you need to work on legacy frontend code)
Backup the .idea
folder in your portal source in case you dislike the result (other than the .iml
files it creates, the script writes its files here)
Clone this repository.
.. code-block:: bash
git clone git@github.com:holatuwol/liferay-intellij.git
/path/to/clone/location
with the path to the liferay-intellij
folder that you created by cloning the repository in step 3... code-block:: bash
IJ_CLONE_PATH=/path/to/clone/location
ij() {
${IJ_CLONE_PATH}/intellij "$@"
}
There are a few different ways to use this script, which are documented below. Once you've followed the instructions, have IntelliJ open the project rooted in the folder where you ran the ij
function, and it will load your populated project!
Public Source
To load a project containing only the portal source for a public repository, follow these instructions.
1. Navigate to where you've cloned the `liferay-portal <https://github.com/liferay/liferay-portal>`__ repository
2. Run the ``ij`` command (no parameters) to generate the IntelliJ project
.. code-block:: bash
cd /path/to/portal/public/source
ij
Private Source With Public History
If you'd like to work with master-private
or 7.0.x-private
and you need the history on the master
and 7.0.x
branches, follow these instructions.
liferay-portal <https://github.com/liferay/liferay-portal>
__ repositoryij
command, and specify the path to where you cloned the liferay-portal-ee <https://github.com/liferay/liferay-portal-ee>
__ repository and checked out the corresponding private branch.. code-block:: bash
cd /path/to/portal/public/source
ij /path/to/portal/private/source
Private Source Without Public History
If you'd like to work with ``master-private`` or ``7.0.x-private`` and you don't need the history on the ``master`` and ``7.0.x`` branches, follow these instructions.
1. Navigate to where you've cloned the `liferay-portal-ee <https://github.com/liferay/liferay-portal-ee>`__ repository
2. Run the ``ij`` command (no parameters) to generate the IntelliJ project
.. code-block:: bash
cd /path/to/portal/private/source
ij
Public Source With Subrepositories
To load a project containing only the portal source for a public repository and the code for all public/private subrepositories that you've checked out, follow these instructions.
liferay-portal <https://github.com/liferay/liferay-portal>
__ repositoryij
command, and specify as an argument the path to where you cloned the various subrepositories. If you have them all cloned inside of one parent folder, just specify the one parent folder and it will locate them all!.. code-block:: bash
cd /path/to/portal/public/source
ij /path/to/subrepo1 /path/to/subrepo2 /path/to/subrepo3
.. code-block:: bash
cd /path/to/portal/public/source
ij /path/to/subrepos
Private Source With Public History and Subrepositories
To load a project containing only the portal source for a public repository and the code for all public/private subrepositories that you've checked out, follow these instructions.
1. Navigate to where you've cloned the `liferay-portal <https://github.com/liferay/liferay-portal>`__ repository
2. Run the ``ij`` command, and specify as an argument the path to where you cloned the `liferay-portal-ee <https://github.com/liferay/liferay-portal-ee>`__ repository and checked out the corresponding private branch, and specify the various subrepositories. If you have them all cloned inside of one parent folder, just specify the one parent folder and it will locate them all!
.. code-block:: bash
cd /path/to/portal/public/source
ij /path/to/portal/private/source /path/to/subrepo1 /path/to/subrepo2 /path/to/subrepo3
.. code-block:: bash
cd /path/to/portal/public/source
ij /path/to/portal/private/source /path/to/subrepos/parent
Atypical Usage Instructions
---------------------------
There are a few features for atypical scenarios as well.
Command Line Flags
There are a few command-line flags that you can pass to ij
in order tell it to do some extra processing.
--barebone
: unload modules <https://blog.jetbrains.com/idea/2017/06/intellij-idea-2017-2-eap-introduces-unloaded-modules/>
__ that aren't required by portal-impl to improve IntelliJ startup speed (must manually reload any module you actually use)--complete-cache
: download any dependencies not present in your local Maven and Gradle caches (prefer Maven, if available, since it will persist across builds)--ic
: do not add any web facets, so that the project is compatible with IntelliJ community edition--unload
: unload modules <https://blog.jetbrains.com/idea/2017/06/intellij-idea-2017-2-eap-introduces-unloaded-modules/>
__ that aren't built as part of ant all
to improve IntelliJ startup speed--unzip
: unzip existing .jar
files from a Liferay Tomcat bundle into the build folders of your projectPlugins SDK and Blade Workspace
All folders that you specify as arguments will be assumed either to be an Ant-based Plugins SDK root (designated by the presence of ``build-common-plugins.xml``), a Blade workspace (designated by the presence of a ``gradle.properties``), or a folder used to store subrepositories (such as those generated by forking subrepositories OR the ``modules`` folder of the ``master-private`` and ``7.0.x-private`` branch).
.. code-block:: bash
ij /path/to/folder1 /path/to/folder2 /path/to/folder3
Other Caveats
-------------
The script generates ``.iml`` files that are slightly different from the ones that have been committed to Liferay's version control, so the alias adds all ``.iml`` files to an ignore list. You can clear your ignore list with the following.
.. code-block:: bash
git ls-files -v | grep '^h ' | cut -d' ' -f 2 | xargs git update-index --no-assume-unchanged