Compiling the viewer (Mac OS X) - Revision history

Oz Linden: Redirected page to Compiling the viewer (Mac OS X XCode 6.1)

2015-04-23T19:30:48Z

Redirected page to Compiling the viewer (Mac OS X XCode 6.1)

← Older revision		Revision as of 12:30, 23 April 2015
Line 1:		Line 1:
	~~{{Multi-lang}}~~		#REDIRECT [[Compiling the viewer (Mac OS X XCode 6.1)]]
	~~{{CompileNav}}~~
	~~For recent information check the [[Project Snowstorm]] page.~~

	~~==Getting Development Tools==~~

	* '''Xcode 4''': Xcode 4.6 is now supported for building, but involves also downloading Xcode 4.3 and following the steps explained below: [[Compiling_the_viewer_(Mac_OS_X)#~~Updating_Xcode_4.6]]. ''We hope to have eliminated this hack soon''.~~
	* '''CMake''': Install CMake from [~~http://www.cmake.org cmake.org], or using~~ [~~http://macports.org/ MacPorts] with 'port install cmake'. You will need at least CMake 2.8.8.~~
	*'''Command line Tools''': These are included in Apple's Xcode product. Download and install Xcode from Apple.
	*'''Mercurial''': Needed for cloning/updating the repository and also generating a version number.

	~~==Downloading Source Code==~~

	~~Linden Lab [[ Project Snowstorm]] uses [http://mercurial.selenica.com Mercurial] and [http://bitbucket.org Bit Bucket] for~~ the ~~[[version control repository]].~~
	~~The repository is http://hg.secondlife.com/~~viewer~~-release~~

	~~==Installing Proprietary Libraries==~~

	~~Some builds of the the Viewer depends on proprietary libraries~~ (alternative open source libraries are also provided for developers who prefer or are not licensed to use the proprietary libraries). Lindens do not distribute these libraries, so you will need to fetch and install these even if you download the libraries packages. (This is due to licensing restrictions. Don't ask, Lindens already did, and can't get permission. So you do have to get them yourself.)

	~~===Fmod===~~

	~~==== Fmod method~~ 1 ~~(using autobuild~~) ~~====~~

	~~CD to where you want to install the 3p-fmod repository and do:~~
	~~<pre>~~
	~~$ hg clone <nowiki>https://bitbucket.org/lindenlab/3p-fmod</nowiki>~~
	~~$ cd 3p-fmod~~
	~~$ autobuild build --all~~
	~~$ autobuild package~~
	~~</pre>~~

	~~You will see the result looks like:~~
	~~<pre>~~
	~~packing fmod~~
	~~wrote /3p-fmod/fmod-3.75-darwin-20120614.tar.bz2~~
	~~md5 527422281dbe49abac29380996d41230~~
	~~</pre>~~

	~~CD to your repository root and update autobuild configulation file with the filename and hash just displayed. For the example above, run:~~
	~~<pre>~~
	~~$ autobuild installables edit fmod platform=darwin hash=527422281dbe49abac29380996d41230 url=file:///3p-fmod/fmod-3.75-darwin-20120614.tar.bz2~~
	~~</pre>~~

	Note: FMOD does not host the appropriate version any longer. You will need fmodapi375mac.zip from elsewhere; currently, [https://my.secondlife.com/kittin.ninetails Kittin Ninetails] is hosting it on her [http://cid-6a2f42d7b470f408.office.live.com/browse.aspx/Public/Second%20Life SkyDrive].

	~~==== Fmod method 2 (using system module) ====~~

	~~(to be written)~~


	~~==Configuration and Building==~~

	~~===With Autobuild===~~

	~~This is the preferred method (the one the Lindens consider "normal").~~

	~~Configuring and building with autobuild works the same on all platforms. Full instructions may be found at [[Build_Viewer_With_Autobuild]].~~

	~~Example:~~

	~~autobuild configure -c RelWithDebInfoOS -- -DPACKAGE:BOOL=FALSE -DFMOD:BOOL=TRUE~~
	~~autobuild build -c RelWithDebInfoOS --no-configure~~


	~~===On Xcode===~~

	If you have followed the configure instructions from [[Build_Viewer_With_Autobuild]], the directory ''build-darwin-i386'' will have been created in the root of your source distribution. Inside that directory you will find the ''SecondLife.xcodeproj'' project file which can be used with Xcode. When opened it should be configured correctly to build, so just '''Build and Run'''.

	~~==Running your newly built viewer==~~

	~~===On Console===~~

	~~In your source tree root directory, run:~~

	~~$build-darwin-i386/newview/''configuration-type''/Second\ Life.app/Contents/MacOS/Second\ Life~~

	~~where ''configuration-type'' depends on your built configuration ("DebugOS", "ReleaseOS" or "RelWithDebInfoOS").~~

	~~===On Xcode===~~

	~~"secondlife-bin" scheme is what you look for.~~

	~~===Using Finder===~~

	~~# Navigate to <tt>build-darwin-i386/newview/''configuration-type''</tt>.~~
	~~# Double click the application.~~
	~~:You can create and put the alias wherever you find convenient.~~

	~~==Running the Unit Tests==~~

	~~From Xcode, open the project ''build-darwin-i386/test/test.xcodeproj'' and select "test" for scheme and run. ''SecondLife.xcodeproj'' project also has "test" scheme.~~

	~~==Handling Problems==~~

	~~If you encounter errors or run into problems following the instructions above, please first check whether someone else already had the same issue. A solution might be known already.~~

	~~You may find the solution in any of these resources:~~
	* [[{{TALKPAGENAME}}\|This talk page]] (Report useful experiences there)
	* [[#Common_Issues.2FBugs.2FGlitches_And_Solutions\|Issue list below]] (If new issues, please add it to talk page above instead of there)
	* [[Talk:Microsoft_Windows_Builds\|Old talk page]]
	* [[Common compilation problems]] (Rather old)
	* [[Issue tracker]]

	* Fix it: [[Modifying CMake Files‎]] and please, submit a patch!

	~~===Getting Help===~~
	~~Even when no description of your problem has been written down yet, someone might know about it, so get in touch with the community to get help.~~

	* Subscribe to [[OpenSource-Dev\|OpenSource-Dev Mailing List]] ([https://lists.secondlife.com/cgi-bin/mailman/listinfo/opensource-dev subscribe]) and post your question there.
	* For faster response, join the general open source viewer discussion and development [[IRC]] channel [irc://irc.freenode.org/opensl #opensl on freenode]. Hopefully a helpful person is online when you ask your question.

	~~===Submitting Changes===~~

	~~This is probably far down the road, but if you make changes to the source and want to submit them, see the page about [[Submitting patches\|submitting patches]].~~

	~~----~~
	~~[[Category:Compiling viewer~~]]

Cinder Roxley: /* Updating Xcode 4.6 */ This section is unnecessary since cocoa project was released, Removing

2015-02-12T00:37:35Z

Updating Xcode 4.6: This section is unnecessary since cocoa project was released, Removing

← Older revision		Revision as of 17:37, 11 February 2015
Line 116:		Line 116:

	----		----
	~~== Updating Xcode 4.6 ==~~

	~~If you use Xcode 4.6, you need to do these additional steps to succeed in building:~~
	~~# Download Xcode 4.6.x, install and run - install command line tools via Preferences->Downloads and anything else it ask for then quit.~~
	~~# Download Xcode 4.3 from the Apple Developer site~~
	~~# Mount xcode_4.3_for_lion.dmg~~
	~~# Pull down the xcode_fix script from: https://bitbucket.org/jj_linden/build-scripts~~
	~~Clone the repository; cd into build-scripts; sudo bash xcode_fix [[User:Nicky Perian\|Nicky Perian]]~~
	~~# Run the script in a folder you have write permissions for. You will need to enter your password for the sudo commands in the script.~~

	The script will pull the MacOSX 10.6 SDK from the 4.3 installer into a temporary folder ('temp') that it creates and will unpack the SDK to be used by Xcode 4.6. Then the temporary folder will be deleted.

	[[Category:Compiling viewer]]		[[Category:Compiling viewer]]

Cinder Roxley: Add mercurial as a dependency (CMake will fail without it.

2014-08-19T14:57:18Z

Add mercurial as a dependency (CMake will fail without it.

← Older revision		Revision as of 07:57, 19 August 2014
Line 7:		Line 7:
	* '''Xcode 4''': Xcode 4.6 is now supported for building, but involves also downloading Xcode 4.3 and following the steps explained below: [[Compiling_the_viewer_(Mac_OS_X)#Updating_Xcode_4.6]]. ''We hope to have eliminated this hack soon''.		* '''Xcode 4''': Xcode 4.6 is now supported for building, but involves also downloading Xcode 4.3 and following the steps explained below: [[Compiling_the_viewer_(Mac_OS_X)#Updating_Xcode_4.6]]. ''We hope to have eliminated this hack soon''.
	* '''CMake''': Install CMake from [http://www.cmake.org cmake.org], or using [http://macports.org/ MacPorts] with 'port install cmake'. You will need at least CMake 2.8.8.		* '''CMake''': Install CMake from [http://www.cmake.org cmake.org], or using [http://macports.org/ MacPorts] with 'port install cmake'. You will need at least CMake 2.8.8.
	*'''Command line ~~Makefiles~~''': These are included in Apple's Xcode product. Download and install Xcode from Apple.		*'''Command line Tools''': These are included in Apple's Xcode product. Download and install Xcode from Apple.
	~~<!-- I think this is obsolete... Oz~~		*'''Mercurial''': Needed for cloning/updating the repository and also generating a version number.
	~~Note: I had to get~~ ''~~bison~~'' ~~and~~ ''~~flex'' from MacPorts; strangely enough,~~ the ~~ones provided by Xcode didn't install properly. ''bison'' needs to be 2.3 (2.6~~ and ~~2.7 will throw an error), ''flex'' was tested with 2~~.~~5.35.~~
	~~-->~~

	==Downloading Source Code==		==Downloading Source Code==

Nicky Perian: /* Updating Xcode 4.6 */

2013-11-20T14:37:38Z

Updating Xcode 4.6

← Older revision		Revision as of 07:37, 20 November 2013
Line 125:		Line 125:
	# Mount xcode_4.3_for_lion.dmg		# Mount xcode_4.3_for_lion.dmg
	# Pull down the xcode_fix script from: https://bitbucket.org/jj_linden/build-scripts		# Pull down the xcode_fix script from: https://bitbucket.org/jj_linden/build-scripts
			Clone the repository; cd into build-scripts; sudo bash xcode_fix [[User:Nicky Perian\|Nicky Perian]]
	# Run the script in a folder you have write permissions for. You will need to enter your password for the sudo commands in the script.		# Run the script in a folder you have write permissions for. You will need to enter your password for the sudo commands in the script.

Oz Linden at 16:05, 9 August 2013

2013-08-09T16:05:08Z

Show changes

JJ Linden: the old information had said that 4.3.3 is needed, but from the Apple site the file is just selected as 4.3 (which I believe is actually 4.3.3) removed the extra .3 to prevent confusion

2013-04-30T21:30:06Z

the old information had said that 4.3.3 is needed, but from the Apple site the file is just selected as 4.3 (which I believe is actually 4.3.3) removed the extra .3 to prevent confusion

← Older revision		Revision as of 14:30, 30 April 2013
Line 6:		Line 6:

	* '''Xcode 3''': Most Lindens use Xcode 3.2 on Snow Leopard (OS X 10.6) for building on Macintosh computers. For simplicity, we suggest installing everything from the mpkg. Note that later versions of Xcode have build options to be backwards compatible to 3.1. (See [[Talk:Compiling_the_viewer_(Mac_OS_X)#Trying_newer_versions_of_tools]]. Later versions of Xcode (3.2.4) work fine.)		* '''Xcode 3''': Most Lindens use Xcode 3.2 on Snow Leopard (OS X 10.6) for building on Macintosh computers. For simplicity, we suggest installing everything from the mpkg. Note that later versions of Xcode have build options to be backwards compatible to 3.1. (See [[Talk:Compiling_the_viewer_(Mac_OS_X)#Trying_newer_versions_of_tools]]. Later versions of Xcode (3.2.4) work fine.)
	* '''Xcode 4''': Xcode 4.6 is now supported for building on Macintosh computers, but involves also downloading Xcode 4.3.3 and following the steps explained here: [[Compiling_the_viewer_(Mac_OS_X)#Updating_Xcode_4.6]]		* '''Xcode 4''': Xcode 4.6 is now supported for building on Macintosh computers, but involves also downloading Xcode 4.3 and following the steps explained here: [[Compiling_the_viewer_(Mac_OS_X)#Updating_Xcode_4.6]]
	* '''CMake''': Install CMake from [http://www.cmake.org cmake.org], or using [http://macports.org/ MacPorts] with 'port install cmake'. You will need at least CMake 2.6; CMake 2.8 may be required in the future.		* '''CMake''': Install CMake from [http://www.cmake.org cmake.org], or using [http://macports.org/ MacPorts] with 'port install cmake'. You will need at least CMake 2.6; CMake 2.8 may be required in the future.
	*'''Command line Makefiles''': These are included in Apple's Xcode product. Download and install Xcode from Apple.		*'''Command line Makefiles''': These are included in Apple's Xcode product. Download and install Xcode from Apple.
Line 24:		Line 24:
	# Download Xcode 4.6.x, install and run - install command line tools via Preferences->Downloads and anything else it ask for then quit.		# Download Xcode 4.6.x, install and run - install command line tools via Preferences->Downloads and anything else it ask for then quit.
	# Download Xcode 4.3 from the Apple Developer site		# Download Xcode 4.3 from the Apple Developer site
	# Mount xcode_4.3_for_lion.dmg ~~[QUESTION: this filename implies we need version 4.3, but above it says we need 4.3.3. can you clarify?]~~		# Mount xcode_4.3_for_lion.dmg
	# Pull down the xcode_fix script from: https://bitbucket.org/jj_linden/build-scripts		# Pull down the xcode_fix script from: https://bitbucket.org/jj_linden/build-scripts
	# Run the script in a folder you have write permissions for. You will need to enter your password for the sudo commands in the script.		# Run the script in a folder you have write permissions for. You will need to enter your password for the sudo commands in the script.

Qarl Fizz: question about which version of xcode 4.3 should be used?

2013-04-19T17:18:43Z

question about which version of xcode 4.3 should be used?

← Older revision		Revision as of 10:18, 19 April 2013
Line 24:		Line 24:
	# Download Xcode 4.6.x, install and run - install command line tools via Preferences->Downloads and anything else it ask for then quit.		# Download Xcode 4.6.x, install and run - install command line tools via Preferences->Downloads and anything else it ask for then quit.
	# Download Xcode 4.3 from the Apple Developer site		# Download Xcode 4.3 from the Apple Developer site
	# Mount xcode_4.3_for_lion.dmg		# Mount xcode_4.3_for_lion.dmg [QUESTION: this filename implies we need version 4.3, but above it says we need 4.3.3. can you clarify?]
	# Pull down the xcode_fix script from: https://bitbucket.org/jj_linden/build-scripts		# Pull down the xcode_fix script from: https://bitbucket.org/jj_linden/build-scripts
	# Run the script in a folder you have write permissions for. You will need to enter your password for the sudo commands in the script.		# Run the script in a folder you have write permissions for. You will need to enter your password for the sudo commands in the script.

JJ Linden: /* Getting Development Tools */

2013-04-18T17:27:12Z

Getting Development Tools

← Older revision		Revision as of 10:27, 18 April 2013
Line 6:		Line 6:

	* '''Xcode 3''': Most Lindens use Xcode 3.2 on Snow Leopard (OS X 10.6) for building on Macintosh computers. For simplicity, we suggest installing everything from the mpkg. Note that later versions of Xcode have build options to be backwards compatible to 3.1. (See [[Talk:Compiling_the_viewer_(Mac_OS_X)#Trying_newer_versions_of_tools]]. Later versions of Xcode (3.2.4) work fine.)		* '''Xcode 3''': Most Lindens use Xcode 3.2 on Snow Leopard (OS X 10.6) for building on Macintosh computers. For simplicity, we suggest installing everything from the mpkg. Note that later versions of Xcode have build options to be backwards compatible to 3.1. (See [[Talk:Compiling_the_viewer_(Mac_OS_X)#Trying_newer_versions_of_tools]]. Later versions of Xcode (3.2.4) work fine.)
	* '''Xcode 4''': Xcode 4.6 is now supported for building on Macintosh computers, but involves also downloading Xcode 4.3.3 and following the steps explained here: [[Compiling_the_viewer_(Mac_OS_X)#~~Updating_Xcode~~]]		* '''Xcode 4''': Xcode 4.6 is now supported for building on Macintosh computers, but involves also downloading Xcode 4.3.3 and following the steps explained here: [[Compiling_the_viewer_(Mac_OS_X)#Updating_Xcode_4.6]]
	* '''CMake''': Install CMake from [http://www.cmake.org cmake.org], or using [http://macports.org/ MacPorts] with 'port install cmake'. You will need at least CMake 2.6; CMake 2.8 may be required in the future.		* '''CMake''': Install CMake from [http://www.cmake.org cmake.org], or using [http://macports.org/ MacPorts] with 'port install cmake'. You will need at least CMake 2.6; CMake 2.8 may be required in the future.
	*'''Command line Makefiles''': These are included in Apple's Xcode product. Download and install Xcode from Apple.		*'''Command line Makefiles''': These are included in Apple's Xcode product. Download and install Xcode from Apple.

JJ Linden: /* Updating Xcode */

2013-04-18T17:26:56Z

Updating Xcode

← Older revision		Revision as of 10:26, 18 April 2013
Line 19:		Line 19:


	= Updating Xcode =		= Updating Xcode 4.6 =

	If you use Xcode 4.6, you need to do these additional steps to succeed in building:		If you use Xcode 4.6, you need to do these additional steps to succeed in building:

JJ Linden: /* Updating Xcode */

2013-04-18T17:26:18Z

Updating Xcode

← Older revision		Revision as of 10:26, 18 April 2013
Line 25:		Line 25:
	# Download Xcode 4.3 from the Apple Developer site		# Download Xcode 4.3 from the Apple Developer site
	# Mount xcode_4.3_for_lion.dmg		# Mount xcode_4.3_for_lion.dmg
	# Pull down the xcode_fix script from ~~(insert URL)~~		# Pull down the xcode_fix script from: https://bitbucket.org/jj_linden/build-scripts
	# Run the script in a folder you have write permissions for. You will need to enter your password for the sudo commands in the script.		# Run the script in a folder you have write permissions for. You will need to enter your password for the sudo commands in the script.