Calendar:Lightning:Building Lightning - Revision history

Ssitter: add link to build page on mozilla.org

2006-07-12T21:18:32Z

add link to build page on mozilla.org

← Older revision	Revision as of 21:18, 12 July 2006
Line 1:	Line 1:
		See http://www.mozilla.org/projects/calendar/lightning/build.html.

Sipaq at 13:18, 17 April 2006

2006-04-17T13:18:32Z

← Older revision		Revision as of 13:18, 17 April 2006
Line 1:		Line 1:
	As of October 7, 2005, [[Calendar:Lightning:Nightly Builds\|nightly builds of Lightning]] are available for Windows, OSX and Linux. The following instructions are somewhat out of date, but should still be valid for anyone looking to compile Lightning for themselves.

	~~= Requirements for Building Lightning =~~
	If this is your first time building any of the Mozilla products, you should first make sure that you [http://www.mozilla.org/build/index.html#requirements get the tools] required to build on your operating system.

	Once you're set up with the right tools, you'll want to [http://www.mozilla.org/source.html get the source] either from the [http://www.mozilla.org/download-mozilla.html FTP server] or [http://www.mozilla.org/cvs.html through CVS].

	<small>'''Note:''' if you're building on Windows using the free tools (ie: mingw instead of Visual Studio), then you might want to follow steps 1-9 on [http://gemal.dk/mozilla/build.html Gemal's Build Mozilla on Windows] page.</small>

	~~= Quick Start =~~

	~~If you already have everything you need installed to build thunderbird and lightning, then these commands should work to test cvs head:~~

	~~<pre><nowiki>~~
	~~export CVSROOT=:pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot~~
	~~cvs checkout mozilla/client.mk~~
	~~cd mozilla~~
	~~make -f client.mk checkout MOZ_CO_PROJECT=mail,calendar~~
	~~./configure --enable-application=mail --enable-extensions=default,lightning~~
	~~make~~
	~~./dist/bin/thunderbird~~
	~~# install dist/xpi-stage/lightning.xpi via the thunderbird extensions menu~~
	~~</nowiki></pre>~~

	~~If you have problems with lightning crashing thunderbird, you can disable all extensions with:~~
	~~<pre><nowiki>~~
	~~./dist/bin/thunderbird -safe-mode~~
	~~</nowiki></pre>~~

	~~= Getting the latest code from CVS =~~
	The Lightning codebase changes quite a bit on a day to day basis. It's kept in the calendar project tree. To keep up to date with the latest changes, make sure that when you [http://www.mozilla.org/cvs.html update with CVS] you have <tt>calendar</tt> specified as one of your <tt>MOZ_CO_OPTIONS</tt>.

	~~<small>'''Note:''' if you downloaded your source as a tarball, you need to have unpackaged it with tar, not zip, in order to get the metadata required by CVS to do a proper update.</small>~~

	~~= Building & Installing Lightning =~~
	Lightning builds as an extension to Thunderbird, so follow the instructions to [http://www.mozilla.org/build/configure-build.html configure your build] for Thunderbird. (Windows builders using the free tools should follow step 11 in [http://gemal.dk/mozilla/build.html Gemal's instructions].)

	It is suggested that you use an [http://www.mozilla.org/build/configure-build.html#objdir objdir] to hold the final build, as this will allow you to quickly update from CVS and do an incremental rebuild from within the objdir.

	~~= Editing your .mozconfig file =~~
	~~You must add two lines to the <tt>.mozconfig</tt> file:~~
	*<tt>mk_add_options MOZ_CO_PROJECT=mail,calendar</tt>
	*<tt>ac_add_options --enable-extensions=default,lightning</tt>

	~~Static builds are causing some problems ([https://bugzilla.mozilla.org/show_bug.cgi?id=330753 Bug 330753]), so make sure that your <tt>.mozconfig</tt> doesn't include the lines:~~
	*<tt>ac_add_options --disable-shared</tt>
	*<tt>ac_add_options --enable-static</tt>

	~~Save your .mozconfig and run your build process as per normal. This will create a <tt>dist/xpi-stage</tt> folder which will hold Lightning.~~

	~~= Installing the lightning.xpi =~~
	To install Lightning, run your Thunderbird build (located in <tt>dist/bin</tt>) and select Tools > Extensions to launch the Thunderbird extension manager. Then click "Install" and point to <tt>dist/xpi-stage/lightning.xpi</tt>. Exit Thunderbird and restart and Lightning should be enabled.

	~~= Pointing to a different profile =~~
	If you want to use a different profile for testing Lightning, make sure all Thunderbird windows are closed and run <tt>thunderbird -P</tt> to launch the Thunderbird Profile Manager. From here you can create new profiles and select which you want to use at startup. Once a profile has been created, you can launch Thunderbird using the profile either by invoking the Profile Manager or using the command <tt>thunderbird -P ''profilename''</tt>.

Jeff Carr: /* Quick Start */

2006-04-12T23:03:36Z

Quick Start

← Older revision		Revision as of 23:03, 12 April 2006
Line 10:		Line 10:
	= Quick Start =		= Quick Start =

	If you already have everything you need installed to build thunderbird + lightning, then these commands should work to test cvs head:		If you already have everything you need installed to build thunderbird and lightning, then these commands should work to test cvs head:

	<pre><nowiki>		<pre><nowiki>

Jeff Carr: /* Quick Start*/

2006-04-12T23:03:01Z

Quick Start

← Older revision		Revision as of 23:03, 12 April 2006
Line 7:		Line 7:

	<small>'''Note:''' if you're building on Windows using the free tools (ie: mingw instead of Visual Studio), then you might want to follow steps 1-9 on [http://gemal.dk/mozilla/build.html Gemal's Build Mozilla on Windows] page.</small>		<small>'''Note:''' if you're building on Windows using the free tools (ie: mingw instead of Visual Studio), then you might want to follow steps 1-9 on [http://gemal.dk/mozilla/build.html Gemal's Build Mozilla on Windows] page.</small>

			= Quick Start =

			If you already have everything you need installed to build thunderbird + lightning, then these commands should work to test cvs head:

			<pre><nowiki>
			export CVSROOT=:pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot
			cvs checkout mozilla/client.mk
			cd mozilla
			make -f client.mk checkout MOZ_CO_PROJECT=mail,calendar
			./configure --enable-application=mail --enable-extensions=default,lightning
			make
			./dist/bin/thunderbird
			# install dist/xpi-stage/lightning.xpi via the thunderbird extensions menu
			</nowiki></pre>

			If you have problems with lightning crashing thunderbird, you can disable all extensions with:
			<pre><nowiki>
			./dist/bin/thunderbird -safe-mode
			</nowiki></pre>

	= Getting the latest code from CVS =		= Getting the latest code from CVS =

Jeff Carr: s/=+/=/g (the higherarchy before was overkill)

2006-04-12T22:47:11Z

s/=+/=/g (the higherarchy before was overkill)

Ssitter: /* Editing your .mozconfig file */

2006-03-24T23:29:36Z

Editing your .mozconfig file

← Older revision		Revision as of 23:29, 24 March 2006
Line 23:		Line 23:
	*<tt>ac_add_options --enable-extensions=default,lightning</tt>		*<tt>ac_add_options --enable-extensions=default,lightning</tt>

	Static builds ~~were~~ causing some problems, so ~~it's best to~~ make sure that your <tt>.mozconfig</tt> doesn't include the lines:		Static builds are causing some problems ([https://bugzilla.mozilla.org/show_bug.cgi?id=330753 Bug 330753]), so make sure that your <tt>.mozconfig</tt> doesn't include the lines:
	*<tt>ac_add_options --disable-shared</tt>		*<tt>ac_add_options --disable-shared</tt>
	*<tt>ac_add_options --enable-static</tt>		*<tt>ac_add_options --enable-static</tt>

Pweilbacher: enable-static twice doesn't make much sense

2006-03-23T14:04:58Z

enable-static twice doesn't make much sense

← Older revision		Revision as of 14:04, 23 March 2006
Line 24:		Line 24:

	Static builds were causing some problems, so it's best to make sure that your <tt>.mozconfig</tt> doesn't include the lines:		Static builds were causing some problems, so it's best to make sure that your <tt>.mozconfig</tt> doesn't include the lines:
	*<tt>ac_add_options --~~enable~~-~~static~~</tt>		*<tt>ac_add_options --disable-shared</tt>
	*<tt>ac_add_options --enable-static</tt>		*<tt>ac_add_options --enable-static</tt>

Beltzner at 13:24, 7 October 2005

2005-10-07T13:24:58Z

← Older revision		Revision as of 13:24, 7 October 2005
Line 1:		Line 1:
			As of October 7, 2005, [[Calendar:Lightning:Nightly Builds\|nightly builds of Lightning]] are available for Windows, OSX and Linux. The following instructions are somewhat out of date, but should still be valid for anyone looking to compile Lightning for themselves.

	== Requirements for Building Lightning ==		== Requirements for Building Lightning ==
	If this is your first time building any of the Mozilla products, you should first make sure that you [http://www.mozilla.org/build/index.html#requirements get the tools] required to build on your operating system.		If this is your first time building any of the Mozilla products, you should first make sure that you [http://www.mozilla.org/build/index.html#requirements get the tools] required to build on your operating system.
Line 19:		Line 21:
	You must add two lines to the <tt>.mozconfig</tt> file:		You must add two lines to the <tt>.mozconfig</tt> file:
	*<tt>mk_add_options MOZ_CO_PROJECT=mail,calendar</tt>		*<tt>mk_add_options MOZ_CO_PROJECT=mail,calendar</tt>
	*<tt>ac_add_options --enable-extensions=default,lightning~~,inspector,venkman~~</tt>		*<tt>ac_add_options --enable-extensions=default,lightning</tt>

	~~Right now static~~ builds ~~aren't working~~, so make sure that your <tt>.mozconfig</tt> doesn't include the lines:		Static builds were causing some problems, so it's best to make sure that your <tt>.mozconfig</tt> doesn't include the lines:
	*<tt>ac_add_options --enable-static</tt>		*<tt>ac_add_options --enable-static</tt>
	*<tt>ac_add_options --enable-static</tt>		*<tt>ac_add_options --enable-static</tt>

Dmose: /* Editing your .mozconfig file */

2005-08-23T15:01:35Z

Editing your .mozconfig file

← Older revision		Revision as of 15:01, 23 August 2005
Line 19:		Line 19:
	You must add two lines to the <tt>.mozconfig</tt> file:		You must add two lines to the <tt>.mozconfig</tt> file:
	*<tt>mk_add_options MOZ_CO_PROJECT=mail,calendar</tt>		*<tt>mk_add_options MOZ_CO_PROJECT=mail,calendar</tt>
	*<tt>ac_add_options --enable-extensions=lightning,inspector,venkman</tt>		*<tt>ac_add_options --enable-extensions=default,lightning,inspector,venkman</tt>

	Right now static builds aren't working, so make sure that your <tt>.mozconfig</tt> doesn't include the lines:		Right now static builds aren't working, so make sure that your <tt>.mozconfig</tt> doesn't include the lines:
	*<tt>ac_add_options --enable-static		*<tt>ac_add_options --enable-static</tt>
	*<tt>ac_add_options --enable-static		*<tt>ac_add_options --enable-static</tt>

	Save your .mozconfig and run your build process as per normal. This will create a <tt>dist/xpi-stage</tt> folder which will hold Lightning.		Save your .mozconfig and run your build process as per normal. This will create a <tt>dist/xpi-stage</tt> folder which will hold Lightning.

Beltzner: /* Editing your .mozconfig file */

2005-05-27T04:51:44Z

Editing your .mozconfig file

← Older revision		Revision as of 04:51, 27 May 2005
Line 21:		Line 21:
	*<tt>ac_add_options --enable-extensions=lightning,inspector,venkman</tt>		*<tt>ac_add_options --enable-extensions=lightning,inspector,venkman</tt>

	~~After~~ that, run your build process as per normal. This will create a <tt>dist/xpi-stage</tt> folder which will hold Lightning.		Right now static builds aren't working, so make sure that your <tt>.mozconfig</tt> doesn't include the lines:
			*<tt>ac_add_options --enable-static
			*<tt>ac_add_options --enable-static

			Save your .mozconfig and run your build process as per normal. This will create a <tt>dist/xpi-stage</tt> folder which will hold Lightning.

	=== Installing the lightning.xpi ===		=== Installing the lightning.xpi ===

← Older revision		Revision as of 22:47, 12 April 2006
Line 1:		Line 1:
	As of October 7, 2005, [[Calendar:Lightning:Nightly Builds\|nightly builds of Lightning]] are available for Windows, OSX and Linux. The following instructions are somewhat out of date, but should still be valid for anyone looking to compile Lightning for themselves.		As of October 7, 2005, [[Calendar:Lightning:Nightly Builds\|nightly builds of Lightning]] are available for Windows, OSX and Linux. The following instructions are somewhat out of date, but should still be valid for anyone looking to compile Lightning for themselves.

	== Requirements for Building Lightning ==		= Requirements for Building Lightning =
	If this is your first time building any of the Mozilla products, you should first make sure that you [http://www.mozilla.org/build/index.html#requirements get the tools] required to build on your operating system.		If this is your first time building any of the Mozilla products, you should first make sure that you [http://www.mozilla.org/build/index.html#requirements get the tools] required to build on your operating system.

Line 8:		Line 8:
	<small>'''Note:''' if you're building on Windows using the free tools (ie: mingw instead of Visual Studio), then you might want to follow steps 1-9 on [http://gemal.dk/mozilla/build.html Gemal's Build Mozilla on Windows] page.</small>		<small>'''Note:''' if you're building on Windows using the free tools (ie: mingw instead of Visual Studio), then you might want to follow steps 1-9 on [http://gemal.dk/mozilla/build.html Gemal's Build Mozilla on Windows] page.</small>

	=== Getting the latest code from CVS ===		= Getting the latest code from CVS =
	The Lightning codebase changes quite a bit on a day to day basis. It's kept in the calendar project tree. To keep up to date with the latest changes, make sure that when you [http://www.mozilla.org/cvs.html update with CVS] you have <tt>calendar</tt> specified as one of your <tt>MOZ_CO_OPTIONS</tt>.		The Lightning codebase changes quite a bit on a day to day basis. It's kept in the calendar project tree. To keep up to date with the latest changes, make sure that when you [http://www.mozilla.org/cvs.html update with CVS] you have <tt>calendar</tt> specified as one of your <tt>MOZ_CO_OPTIONS</tt>.

	<small>'''Note:''' if you downloaded your source as a tarball, you need to have unpackaged it with tar, not zip, in order to get the metadata required by CVS to do a proper update.</small>		<small>'''Note:''' if you downloaded your source as a tarball, you need to have unpackaged it with tar, not zip, in order to get the metadata required by CVS to do a proper update.</small>

	== Building & Installing Lightning ==		= Building & Installing Lightning =
	Lightning builds as an extension to Thunderbird, so follow the instructions to [http://www.mozilla.org/build/configure-build.html configure your build] for Thunderbird. (Windows builders using the free tools should follow step 11 in [http://gemal.dk/mozilla/build.html Gemal's instructions].)		Lightning builds as an extension to Thunderbird, so follow the instructions to [http://www.mozilla.org/build/configure-build.html configure your build] for Thunderbird. (Windows builders using the free tools should follow step 11 in [http://gemal.dk/mozilla/build.html Gemal's instructions].)

	It is suggested that you use an [http://www.mozilla.org/build/configure-build.html#objdir objdir] to hold the final build, as this will allow you to quickly update from CVS and do an incremental rebuild from within the objdir.		It is suggested that you use an [http://www.mozilla.org/build/configure-build.html#objdir objdir] to hold the final build, as this will allow you to quickly update from CVS and do an incremental rebuild from within the objdir.

	=== Editing your .mozconfig file ===		= Editing your .mozconfig file =
	You must add two lines to the <tt>.mozconfig</tt> file:		You must add two lines to the <tt>.mozconfig</tt> file:
	*<tt>mk_add_options MOZ_CO_PROJECT=mail,calendar</tt>		*<tt>mk_add_options MOZ_CO_PROJECT=mail,calendar</tt>
Line 29:		Line 29:
	Save your .mozconfig and run your build process as per normal. This will create a <tt>dist/xpi-stage</tt> folder which will hold Lightning.		Save your .mozconfig and run your build process as per normal. This will create a <tt>dist/xpi-stage</tt> folder which will hold Lightning.

	=== Installing the lightning.xpi ===		= Installing the lightning.xpi =
	To install Lightning, run your Thunderbird build (located in <tt>dist/bin</tt>) and select Tools > Extensions to launch the Thunderbird extension manager. Then click "Install" and point to <tt>dist/xpi-stage/lightning.xpi</tt>. Exit Thunderbird and restart and Lightning should be enabled.		To install Lightning, run your Thunderbird build (located in <tt>dist/bin</tt>) and select Tools > Extensions to launch the Thunderbird extension manager. Then click "Install" and point to <tt>dist/xpi-stage/lightning.xpi</tt>. Exit Thunderbird and restart and Lightning should be enabled.

	=== Pointing to a different profile ===		= Pointing to a different profile =
	If you want to use a different profile for testing Lightning, make sure all Thunderbird windows are closed and run <tt>thunderbird -P</tt> to launch the Thunderbird Profile Manager. From here you can create new profiles and select which you want to use at startup. Once a profile has been created, you can launch Thunderbird using the profile either by invoking the Profile Manager or using the command <tt>thunderbird -P ''profilename''</tt>.		If you want to use a different profile for testing Lightning, make sure all Thunderbird windows are closed and run <tt>thunderbird -P</tt> to launch the Thunderbird Profile Manager. From here you can create new profiles and select which you want to use at startup. Once a profile has been created, you can launch Thunderbird using the profile either by invoking the Profile Manager or using the command <tt>thunderbird -P ''profilename''</tt>.