File:  [mozdev] / booktextmark / www / development.html
Revision 1.1.1.1 (vendor branch): download - view: text, annotated - select for diffs - revision graph
Sun Apr 15 17:19:59 2007 UTC (10 years, 8 months ago) by romanmir
Branches: roman, MAIN
CVS tags: original, HEAD
original release

<!-- MAIN CONTENT -->
<div style="max-width: 575px !important;">
<H2>Development Setup</H2>

<p>
Use the following procedure to setup a uniform development environment:

<OL>
<LI>I use java/ant for builds, so install <a href="http://java.sun.com/j2se/1.4.2/download.html">jre or jdk</a>.</LI>
<LI>Install <a href="http://ant.apache.org/">ant</a>, set ANT_HOME environment variable and add ant/bin to the Path environment variable, so you can run ant from command line.</LI>
<LI>Visit the <a href="http://kb.mozillazine.org/Dev_:_Extensions#Setting_up_your_environment">mozillazine knowledge base</a> and set the FireFox environment to allow debugging messages in the console, etc.</LI>
<LI>Follow <a href="http://kb.mozillazine.org/Viewing_dump%28%29_output">this procedure</a> to make sure you can open FireFox with a console running, so you will be able to see the 'dump' messages.</LI>
<LI>Setup a <a href="http://www.wincvs.org/">cvs client</a>, check <a href="source.html">this page</a> for cvs settings.</LI>
<LI>Download the latest source from the source tree.</LI>
<LI>Find the 'build.properties' file under the 'stockticker' folder, you will need to modify one property: 'extension_dir'.
Set it to wherever the extension's 'chrome' directory is stored on your system (use forward slashes as path seperators only.)
For example on a windows machine this line could look like this:
<TEXTAREA ROWS="3" COLS="70">
extension_dir=H:/Documents and Settings/roman/Application Data/Mozilla/Firefox/Profiles/default.0dn/extensions/{9A4B8FA6-5588-4a97-8383-FC145077896B}/chrome
</TEXTAREA>
</LI>
<LI>In the 'stockticker' folder create a new executable script file such as 'make.bat' or 'make.sh' for example that contains the following line: <i>ant update</i>.  When you run 'update' target from the build.xml, the stockticker.jar file in the extension chrome directory will be updated with the new one from your current source.  This means that in order to test your source, you can just close the browser, run the make script to update the stockticker.jar file and then open the browser.</LI>
</OL>
<BR>
Now you can be sure you are working within a uniform environment with the other developers on this project.
For editing you can use <a href="http://www.eclipse.org/">java/Eclipse</a> plugin environment with <a href="http://jseditor.sourceforge.net/">this Javascript plugin</a>.
<BR><BR>
Obviously you can skip this process and create your own build scripts, here is a <a href="http://www.7-zip.org/">zip tool</a> that can be used from command line.
</p>

<p>
Useful reference links:
<UL>
<LI><a href="http://bookmarklet.blogspot.com/2004_11_01_bookmarklet_archive.html">Javascript and XUL</a></LI>
</UL>
</p>

</div>

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>