Permalink
Fetching contributors…
Cannot retrieve contributors at this time
94 lines (69 sloc) 3.85 KB

How to contribute

Setting up the working environment

In order to be able to contribute to the plugin you need to:

  • checkout and build the IntelliJ IDEA Community source code (so you can have access to the platform internals in debugging and understanding what goes wrong)
  • checkout out and build a recent version of Google Go
  • checkout and setup the plugin sources

Checking out the IntellJ IDEA Platform sources.

We start with cloning the idea git repository and checking out the revision used to build IDEA 11.1.1:

git clone git://git.jetbrains.org/idea/community.git idea
cd idea
git checkout idea/117.117
# and we build it using ant
ant

The build will take around 10 to 20 minutes (depending on the machine) and at the end it should put the build artifacts into out/artifacts folder.

$ ls -al out/artifacts/
total 728672
drwxr-xr-x   7 mtoader  staff        238 Jun  1 22:34 .
drwxr-xr-x   8 mtoader  staff        272 Jun  1 22:25 ..
drwxr-xr-x  10 mtoader  staff        340 Jun  1 22:34 core
-rw-r--r--   1 mtoader  staff  112106975 Jun  1 22:34 ideaIC-117.SNAPSHOT.mac.zip
-rw-r--r--   1 mtoader  staff  110192607 Jun  1 22:34 ideaIC-117.SNAPSHOT.tar.gz
-rw-r--r--   1 mtoader  staff  110468031 Jun  1 22:34 ideaIC-117.SNAPSHOT.win.zip
-rw-r--r--   1 mtoader  staff   40308058 Jun  1 22:34 sources.zip

Use the artifact from your target OS to run the built version of IDEA.

Checking out and building Google Go 1

We prefer to work with a Go 1 release installed from sources by following the page source installation page from here: http://golang.org/doc/install/source.

This will work even with a binary installation (as a result of following the http://golang.org/doc/install page).

Checking out the plugin sources

If you are on the contributors list:

git clone git@github.com:mtoader/google-go-lang-idea-plugin.git

If you are not then fork the repository using the github web interface and do a clone of your fork on the local machine.

Bulding and running the unit tests

In order to build the sources you need to download an IDEA Community version, open the project and add the built IDEA artifact as a Idea SDK for the plugin. It's also helpfull to add the idea sources to the IDEA SDK as it helps tremendously with debugging.

The steps:

  1. Download the IDEA Community (or you can use your licensed IDEA Ultimate copy) from here: http://www.jetbrains.com/idea/.
  2. Open the copy of google-go-lang-idea-plugin repository (that was previously checked out) with it (the default project module config should work with a recent IDEA 11 version).
  3. Open the Project Settings (Comamnd + ; on Mac or File -> Project Settings on other platforms), go to the SDKs entry, click the + (and select IntelliJ IDEA Plugin SDK) and navigate to the unzipped location of the IDEA build that you created before. It will recognize a new IDEA Plugin sdk with the name IDEA IC-117.SNAPSHOT. After that you should add the IDEA sources to it by selecting the SDK, going to the Sourcepath tab, clicking + in the lower panel and navigating to the checkout out sources of IDEA. Press add, let it inspect the folders for sources and add all the found sources to the SDK.
  4. Go to the Project entry and make sure that the Project SDK is set to selected SDK.
  5. Wait until the source files of the SDK are indexed.

Now you can use the run configurations provided by the plugin source code to run and play:

  • Execute Slave IDEA with plugin will spawn a new IDEA with the latest version of the plugin enabled.
  • ro.redeul.google.go in google-go-language will run all the test cases available in the project. Please make sure that all the test cases pass before comitting anything (or making a pull request).

Profit

Now you can play, add functionality and commit or make pull requests. That's it. Enjoy your play time.