Jar Tool - User Guide
Creating new archive
By clicking on the icon in the tool bar or by using the "New Archive" from the project menu you can start creating the new archive project. It will bring up the input box to define the name of the archive.
This will create a file in the sub folder "archive_projects" (if not exists) and .jarprj (jar project) file with the specified name. This action also will open the jar project editor window to you to configure your build. You can create as many as archive project files within any idea project.
Opening the existing archive project
By simply clicking on the .jarprj file it will open the editor window back.
Essential details of the archive can be defined in this screen. All the relevant details will be set with default values based on the IDEA project information and the name you have given to the .jarprj file.
This screen will provide you the facility of selecting the classes & resources from your project output paths in to the archive.
All the contents of your IDEA project output paths including other modules will be listed down in this screen. All the directories of the output paths are displayed on the top table and the classes are listed in the bottom table. This will enable you to select or deselect the entire directory by a single click. Select / Deselect All menus on right click will facilitate you to choose the resources easily.
You can include required third party libraries into to your archive build. This will enable you to distribute your work as a single jar archive file.
When you select your libraries they will be listed in this table. You can use the right click menu or the Del key to remove them.
By selecting the tick box on "Signed" column, you can defined the signed libraries. Signed libraries cannot be directly added in to your archive. They will be copied to the directory defined by "Path to Signed Libraries" and the Manifest file will be altered in order to define the class path for these selected entries.
When right click and select the "Add Jars" menu, this screen will appear. You don't have to search or browse for libraries, this will list all the libraries which are selected to your project. Previously selected libraries will be automatically selected when you are coming back to the screen.
The order of the libraries are important when more than one version of the same class is available in different libraries. After selecting the libraries you can set the order of the libraries using the up & down arrow buttons on the screen. You can select multiple rows once and shift them up or down using the buttons. If duplicate libraries are available, classes of top most libraries will be added in to your archive.
Other files like configurations, settings, images etc. can be included in to your archive. If these are available in the IDEA project output directory, then you don't have to add them in to this list. They will be picked from the project resources tables. The idea file chooser is provided from the right click to navigate and select the files easily.
Source files of the libraries can be added in to your archive. Selected libraries will be listed down in this screen.
Selected source archives
Selecting source archives
If you have specified the sources paths when defining the Libraries in to the IDEA project, then all these sources will be listed down in this screen. Source paths from the JDK paths will also be included in to the list.
Building the Archive
After making all your settings you can simply build the archive by clicking on the "Make" button. This will bring up a progress bar and a message window, indicating the steps of the process. You can set the progress bar to background mode which will enable you to continue your work on the project at the same time while the archive is being made. "Clean " will delete both your binary archive and source. You can also build the archive by selecting the .jarprj jar project file and "Make Archive" from the project pop-up menu. This will enable you to select multiple jar projects and build them at once.
Save & Refresh
"Save" will store all your configurations on the project file and "Refresh" will bring the file data in to the UI. "Refresh" will enable you to undo and revert back to the original file. Saving the changes will be automatically done when you exit from the jar project editor.
Issues & Bugs
Please send your feed back on the "Jar Tool" plugin to firstname.lastname@example.org
Copyright © 2006 Sanjeewa Ruwanpathirana
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.