RSS Owl is a powerful application to organize, search and read your RSS, RDF & Atom news feeds in a comfortable way. Highlights are saved searches, google reader sync, notifications, filters, fast fulltext search and a flexible, clean user interface. http://rssowl.org/
This page will guide you through the process of setting up Eclipse to run and export RSSOwl 2.x.
You should be able to use any Eclipse version to run and export RSSOwl. If you have never installed Eclipse before, simply download and extract Eclipse from here: http://www.eclipse.org/downloads/packages/eclipse-classic-422/junosr2
We recommend to use a fresh workspace with RSSOwl to ensure that your configuration is not messing up with the RSSOwl cofiguration. As such, your package explorer should be empty and not have any other projects in there.
RSSOwl requires a specific version of Eclipse RCP to run. You can not build RSSOwl with any newer RCP version than 3.4.2. For your convinience, the target platform in this repository will just work and matches with the target platform that is used to build RSSOwl for official releases.
- download rssowl-target (https://github.com/bpasero/rssowl-target/archive/master.zip)
- unzip rssowl-target and the included target.zip
- in Eclipse open Window > Preferences > Plug-in Development > Target Platform
- Click "Add..."
- Click "Next"
- Click "Add..."
- Choose "Directory" and "Next"
- Click "Browse"
- Choose "target_win" if you plan to run/export for Windows and "target_nix" for Mac/Linux
- Click "Ok" and "Finish" and "Finish" again
- The target platform should show up in the list named "New Target"
- Check the "New Target" so that it becomes active and close the preferences dialog with "Ok"
Remember to change the target platform between Windows and Mac/Linux if you plan to export RSSOwl for multiple platforms!
RSSOwl is a set of Eclipse Java plug-ins. Use your favorite source control provider in Eclipse to either get the sources through SVN or GIT:
Make sure to check out the specific RSSOwl version you want to build. The current stable version is RSSOwl 2.1.6.
You should see the following list of plugins and features in your package explorer after import
- org.rssowl.core
- org.rssowl.core.tests
- org.rssowl.feature
- org.rssowl.feature.dependencies
- org.rssowl.feature.eclipse
- org.rssowl.feature.tests
- org.rssowl.lib.db4o
- org.rssowl.lib.httpclient
- org.rssowl.lib.jdom
- org.rssowl.lib.lucene
- org.rssowl.ui
If you are not seeing these number of projects in the package explorer or you see that the folders are all sub-folders of a single project, try to create an archive with all these folders and choose File > Import > Existing projects into workspace and choose the option to import from an archive.
You should not see any compile errors when you do a full build (Project > Clean).
RSSOwl works best with Java 1.5 or 1.6.
- click on Run > Run Configurations from the menu
- click on "Launch RSSOwl 2.0" from "Eclipse Application"
- click the "Plug-ins" tab
- uncheck all plugins from the "Target Platform"
- click on "Add required plug-ins"
- Mac only: if you run with a 64 bit vm you will have to tell to run in 32 bit mode by adding a parameter "-d32" to the VM arguments list on the Arguments tab
- click "Run"
RSSOwl should start just fine.
- click on Run > Run Configurations from the menu
- click on "Launch RSSOwl 2.0 Tests" from JUnit Plug-in Tests
- click on rssowl.product in org.rssowl.ui
- click on "Eclipse Product export wizard" from the "Exporting" area
- change the root directory to be "rssowl"
- uncheck "Synchronize before exporting"
- uncheck "Generate metadata repository"
- if you want to export for multiple platforms, check the "Export for multiple platforms" option
- click "Finish"
Keep in mind that for Mac/Linux you need the rssowl_nix target platform set and for Windows the other one.