The Birch Eclipse Plugin provides a syntax-highlighting text editor for the Eclipse IDE.
An update site is available at http://www.birch-lang.org/eclipse/updates.
From within Eclipse, use Help > Install New Software.... Click the Add... button and enter this URL. Follow the prompts from there. The plugin should be automatically associated with the *.bi
file extension.
Once a Birch project has been created from the command line with birch init
:
- Import it into Eclipse using File > New > Makefile Project with Existing Code.
- Under Project > Properties, select C/C++ Build on the left.
- Go to the Builder Settings tab and enter
birch
as the build command. - Go to the Behavior tab and enter
build
(orinstall
, if preferred) next to the Build (Incremental build) checkbox.
To install the plugin, first ensure that your Eclipse environment has the appropriate components. Use Help > Install New Software..., and install:
- Eclipse Java Development Tools
- Eclipse Plug-in Development Environment
Import the Birch.Eclipse
project:
- File > Import... > Git > Projects from Git > Clone URI.
- Enter the URI: https://github.com/lawmurray/Birch.Eclipse.git.
- Next, then Next again, the branch master should be checked.
- Set the local directory to which to clone; consider changing
.../git/...
to.../workspace/...
. - Next again.
- Import existing Eclipse projects.
- Finish.
Repeat to import the Birch.EclipseFeature and Birch.EclipseSite projects, which are required to deploy the plugin to the update site for users.
The project should compile automatically, otherwise use Project > Build Project
.
To install:
- File > Export... > Plug-in Development > Deployable plug-ins and fragments.
- Check the box against Birch Editor.
- Select Install into host.
After installation, it is possible to create the update site. Open the site.xml
file of the Birch.EclipseSite
project and click the Build All button.
To change the version number, it is necessary to modify the feature.xml
file under the Birch.EclipseFeature project.
Within Eclipse:
- In
Birch.Eclipse
, compile and install File > Export > Deployable plug-ins and fragments. - In
Birch.EclipseFeature
,feature.xml
, Included Plug-ins tab, remove the current plug-in and add the new one. Click Versions button and select anything to update the version number properly. - In
Birch.EclipseSite
,site.xml
, Site Map tab, update the plug-in versions that should be included, then build.