$Author: bastafidli $
$Date: 2006/08/27 07:52:10 $
$Revision: 1.8 $
$RCSfile: externallibraries.html,v $
After you downloads all the files from the CVS for the first time or if you update your local files, Eclipse tries to compile all the new files. If a new external library is added to the CVS or if this is the first time you are trying to build the code, you will immediately notice, that it fails with error message: "Project OpenSubsystems is missing required library: 'external/...".
This error message is expected and it is a sideffect of the way how external libraries are organized in OpenSubsystems. OpenSubsystems is using or integrating many other open source and commercial products. Full list can be found in the Externals.
OpenSubsystems tries to make sure, that the CVS contains the version of specific project, which was thouroughly tested with the existing code. This way you don't have to go all over the Internet to search for and download all the required libraries, you will find them all in the external directory and you can be sure that you have the correct version. Some of these libraries are quite large and we often try to include also a source code to allow easier defect resolution. Therefore we store the external project in CVS as .zip files. After you download all the sources or a new library, you will need to extract the files so that Eclipse can use them for source code compilation.
Start Window Explorer and go to the C:\Development\OpenSubsystems\external directory. Right click on each of the zip files and extract them to the current directory. If you are using Windows XP built in extraction utility, make sure you edit the default path and change it to C:\Development\OpenSubsystems\external\ since each archive already contains root directory for all its files. If you are using WinZip you can select all the zip files and from the popup menu select Extract to here.
Even after you extracted all the libraries, Eclipse still doesn't know about them. The same applies if you download a new library or an updated version of existed library and you extract the content. You need to refresh Eclipse so that it can update it's internal information and discover the new or updated libraries.
Right click on the OpenSubsystems project in the Package Explorer view and select Refresh from the popup menu. After Eclipse refreshes itself, it will automatically recompile all the source code with the newly discovered libraries.
Remember, you have to refresh your project in Eclipse every time you extract new or updated package in external directory.