Getting Started - Developer: Difference between revisions

From Thunderforce
Jump to navigation Jump to search
(New page: <big>'''Page is under construction'''</big> ==Artifacts== *Feature list *Context diagram *[https://www.m...)
 
No edit summary
Line 1: Line 1:
<big>'''Page is under construction'''</big>
__NOTOC__
 
{| style="border: 0; margin: 0; padding: 0; width: 100%; background: transparent;"
|style="vertical-align:top; width: 70%; padding-right: .6em;"|
 
To get started as a developer, you will need to install and set up various programs. It's definitely possible to use alternatives for the proposed tools, though the tools listed below are the ones that I am accustomed to in case if you have any support questions for them.
 
The general process is outlined below:
#[http://www.mozilla.com/en-US/thunderbird/ Install the latest Mozilla Thunderbird 2.0 version] if you haven't already done so
#[[Getting Started - Developer#Development tools and extensions|Install the Thunderforce development tools and extensions]]
#[[Getting Started - Developer#Thunderforce Eclipse project|Download the Thunderforce source code into a new Eclipse project]]
#[[Download and compile the Mozilla Thunderbird source code]]
#*This is optional, but helps immensely with software development and debugging
#[[Getting Started - Developer#Thunderforce testing profile in Thunderbird|Create and configure a Thunderforce testing profile in Thunderbird]]
#Familiarlize yourself with [[Test framework|Thunderforce's test framework]]
#Grab a module and develop it (module list is pending the [[Architectural review and refinement|architectural review's]] completion)
#*This [[Process|project's process]] politely asks that you use a process of refinement from a design to the code along with test-driven development
##Create a design for your module on the wiki
##Implement your module in parallel with your unit tests
##*When possible, create your unit test before your code and use the test framework to verify your module's operation under those test cases
 
==Development tools and extensions==
Please install and set up the following:
#[http://www.eclipse.org/downloads/ Eclipse IDE for C/C++ Developers]
#*If you already have Eclipse installed, you can alternatively install the [http://www.eclipse.org/cdt/downloads.php Eclipse C/C++ development environment (CDT)] into your existing Eclipse installation
#Create and switch to a new Eclipse workspace for Thunderforce unless if you aren't using Eclipse for anything else
#*This can be accomplished through File -> "Switch Workspace..."
#*Optionally, you can create a shortcut to start the Thunderforce workspace directly by running eclipse or eclipse.exe with "-data" followed by your workspace folder path
#**'''Example:''' eclipse.exe -vmargs -Xmx512M -data d:\Devel\Thunderforce
#Eclipse Plug-Ins
#*[http://www.interaktonline.com/Products/Eclipse/JSEclipse/Overview/ Adobe JSEclipse]
#*[http://subclipse.tigris.org/ Subclipse]
#**Installation URL for Eclipse's built-in installer is http://subclipse.tigris.org/update_1.2.x
#*[http://andrei.gmxhome.de/anyedit/index.html AnyEdit Tools]
#**Installation URL for Eclipse's built-in installer is http://andrei.gmxhome.de/eclipse/
#***Only AnyEdit is needed. The other tools aren't needed unless if you want to install them
#**Configure AnyEdit to convert all tabs into spaces
#***This is in Window -> Preferences, General/Editors/AnyEdit Tools
#*[http://www.umlet.com/ UMLet UML editor]
#*[http://www.cumminsonline.com.ar/eclipse/xml/index.htm Oribe XML] (being deprecated; I think Eclipse has its own XML editor now..)
 
==Thunderforce Eclipse project==
The following steps walk you through the process of importing the Thunderforce Eclipse project into your workspace:
 
 
==Thunderforce testing profile in Thunderbird==
To separate your production email from Thunderforce testing, we suggest that you create a separate Thunderbird profile for Thunderforce testing. You can also use your main Thunderbird profile, but you then run the risk of damaging your email during Thunderforce development.
#Ensure that Thunderbird is not running by closing all Thunderbird windows
#Start the Thunderbird profile manager in the command line: thunderbird -no-remote -ProfileManager
#Create a new profile named ThunderforceTest and press the Exit button to close the profile manager
#*The Eclipse instructions refer to the ThunderforceTest name
#Optionally create a shortcut to launch the ThunderforceTest profile, which will work even when you have your default Thunderbird profile running
#*The Thunderbird command to run in this shortcut: thunderbird -no-remote -P ThunderforceTest
#In your [http://www.mozilla.org/support/firefox/profile ThunderforceTest profile's] extensions subfolder, create the two following text files. The file names that you will need to use are in bold:
#*'''thunderforce@moonlightdesign.org'''
#**This file will contain the full absolute file path to the [https://www.moonlightdesign.org/thunderforce/svn/trunk/extension/ Thunderforce extension folder], such as d:\Devel\Thunderforce\Thunderforce\extension
#*'''thunderforcetest@moonlightdesign.org'''
#**This file will contain the full absolute file path to the [https://www.moonlightdesign.org/thunderforce/svn/trunk/tests/ Thunderforce tests folder], such as d:\Devel\Thunderforce\Thunderforce\tests
#*Both of these files will contain one and only one line of text
 
|style="vertical-align:top; width: 30%;"|


==Artifacts==
==Artifacts==
Line 37: Line 97:
*Salesforce.com
*Salesforce.com
**[https://na3.salesforce.com/soap/ajax/9.0/debugshell.html AJAX Debug Shell]
**[https://na3.salesforce.com/soap/ajax/9.0/debugshell.html AJAX Debug Shell]
|}

Revision as of 16:49, 10 August 2007


To get started as a developer, you will need to install and set up various programs. It's definitely possible to use alternatives for the proposed tools, though the tools listed below are the ones that I am accustomed to in case if you have any support questions for them.

The general process is outlined below:

  1. Install the latest Mozilla Thunderbird 2.0 version if you haven't already done so
  2. Install the Thunderforce development tools and extensions
  3. Download the Thunderforce source code into a new Eclipse project
  4. Download and compile the Mozilla Thunderbird source code
    • This is optional, but helps immensely with software development and debugging
  5. Create and configure a Thunderforce testing profile in Thunderbird
  6. Familiarlize yourself with Thunderforce's test framework
  7. Grab a module and develop it (module list is pending the architectural review's completion)
    • This project's process politely asks that you use a process of refinement from a design to the code along with test-driven development
    1. Create a design for your module on the wiki
    2. Implement your module in parallel with your unit tests
      • When possible, create your unit test before your code and use the test framework to verify your module's operation under those test cases

Development tools and extensions

Please install and set up the following:

  1. Eclipse IDE for C/C++ Developers
  2. Create and switch to a new Eclipse workspace for Thunderforce unless if you aren't using Eclipse for anything else
    • This can be accomplished through File -> "Switch Workspace..."
    • Optionally, you can create a shortcut to start the Thunderforce workspace directly by running eclipse or eclipse.exe with "-data" followed by your workspace folder path
      • Example: eclipse.exe -vmargs -Xmx512M -data d:\Devel\Thunderforce
  3. Eclipse Plug-Ins

Thunderforce Eclipse project

The following steps walk you through the process of importing the Thunderforce Eclipse project into your workspace:


Thunderforce testing profile in Thunderbird

To separate your production email from Thunderforce testing, we suggest that you create a separate Thunderbird profile for Thunderforce testing. You can also use your main Thunderbird profile, but you then run the risk of damaging your email during Thunderforce development.

  1. Ensure that Thunderbird is not running by closing all Thunderbird windows
  2. Start the Thunderbird profile manager in the command line: thunderbird -no-remote -ProfileManager
  3. Create a new profile named ThunderforceTest and press the Exit button to close the profile manager
    • The Eclipse instructions refer to the ThunderforceTest name
  4. Optionally create a shortcut to launch the ThunderforceTest profile, which will work even when you have your default Thunderbird profile running
    • The Thunderbird command to run in this shortcut: thunderbird -no-remote -P ThunderforceTest
  5. In your ThunderforceTest profile's extensions subfolder, create the two following text files. The file names that you will need to use are in bold:
    • thunderforce@moonlightdesign.org
    • thunderforcetest@moonlightdesign.org
      • This file will contain the full absolute file path to the Thunderforce tests folder, such as d:\Devel\Thunderforce\Thunderforce\tests
    • Both of these files will contain one and only one line of text

Artifacts

Useful Development Links