Spring - User contributions [en]

Spring on MacOSX

2011-10-18T08:04:12Z

Daftalx:

'''Important notice: as of the next engine release, this tutorial will be discontinued, as Spring will be available as a standalone Mac OS X .app bundle (so will SpringLobby).'''

Last page update: 2011/08/01 by daftalx (updated SpringLobby to 0.135)

Current milestones available:
* Spring: 0.82.7.1
* SpringLobby: 0.135

=Preamble=

This tutorial is intended for Mac OS X Snow Leopard (10.6.*) users running in 32bit kernel mode. Although Spring compiles and runs in 64 bits, '''it does not work in 64bit kernel mode''' (thanks to ''frequencyandsulphur'' for digging this one out).

This tutorial has not been tested on older releases of Mac OS X (10.5-). Yet, there are big chances that you can get through and still be able to run Spring. Keep in mind though that due to architecture incompatibilities, Intel-powered macs will be able to discuss online together, as well as with PCs, but not with PPC-powered Macs.

Finally, please bear in mind that this tutorial is mostly for testing purposes and proof of concept. Although no manual compilation is required, using the Terminal application is necessary (for now). Due to the little amount of time people are dedicating to the Mac version of Spring, things will move only slowly and often behind the other platforms. Once things get stabilized, an all-in-one installer will (hopefully one day) replace this tutorial.

Good luck, and have fun !

=Basics=

==Install the XCode tools==

These are available on your Mac OS X install DVD, the installer is called "XCode Tools" in the "Optional installs" folder.

==Install the Java developer packages==

As of Apple's "Java for Mac OS X 10.6 Update 3", headers for JNI (among other stuff) are no longer provided by default. In order to build spring AIs but also various dependencies, you should download and install the Java Developer package available on Apple's support site [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20719 here] (NOTE: you must have an Apple ID to access this page. Feel free to post any public hard link in the forum to be added here instead).

==Install MacPorts==

*If you never had MacPorts installed, the latest version is available as a ".dmg" installer on [http://www.macports.org/install.php this page]
*If you already have MacPorts, make sure you run the latest version with

sudo port selfupdate

==Configure MacPorts==

Spring and it's lobbies are published in a different repository than MacPorts's official one. So you must edit (as root) the MacPorts sources file (located by default in /opt/local/etc/macports/sources.conf), and add the following line '''before''' the last one:

rsync://daftserve.dyndns.org/macports/

==Keep MacPorts up-to-date==

To sync your MacPorts install with the latest repositories hit

sudo port sync

and upgrade any outdated ports with

sudo port upgrade outdated

From now on I assume your Portfiles will always be up-to-date, therefore I will get straight to the point during the remainder of this tutorial.

=Spring=

==Install spring==

Crazy as it may seem, installing spring now comes down to this command:

sudo port install springrts binutils

WARNING: this will take a *long* while, especially on a fresh system (ballpark figure: over an hour with an Intel C2D 2.2GHz cpu).

the binutils are required for finding the source of a crash of spring, the utility addr2line is used.

==Setup game data==

create a ".spring" folder in your home directory, and create the usual "games", "maps" and "demos" folder. There you can store your favorite game data (most of the content is cross-platform compatible).

==Check if Spring works==

spring

should launch the standalone GUI in window mode, which allows offline gaming, e.g. if you have demo scripts or single player games (my favorite these days is Chicken BA).

=Lobbies=

==SpringLobby==

Although the Mac OS port of SpringLobby should be considered "barely alpha"-stage, quite a lot of features are already functional, so you should be able to play online with patience and little effort.

===Install SpringLobby===

As for the engine, installing SpringLobby comes down to a simple command:

sudo port install springlobby

In the end you should get two "double-clickable" .app bundles (springlobby and [[SpringSettings]]) in MacPorts's binary folder (/opt/local/bin by default).

===Setup SpringLobby===

Upon first run, you'll have to tell SpringLobby where to find the spring executable and unitsync library manually. The spring executable is in "/opt/local/bin/spring" and the unitsync library in "/opt/local/lib/libunitsync.so".

As mentioned earlier the lobby is in a very early port stage. One major feature that does *NOT* work yet is to join (or autojoin) an IRC channel (but you may chat inside a battleroom). So before connecting to the main server, open the "Autojoin channels" options window and remove all default channels.

That's it, connect and enjoy
NOTE: SpringLobby will mostly crash upon startup (much less afterwards). Don't worry, just keep trying until you get through...

===Known bugs===

*Add bot in a game opens a tiny (one-pixel wide) window. Clicking it restores its size, but be precise !

=Troubleshooting=

In case you encounter compile or install errors on the way, MacPorts will let you know that a log file has been stored somewhere like /opt/local/var/macports/logs/??/main.log, where the "??" describes the port you are installing. Paste the contents of this file into a paste bin (http://www.pastebin.ca) and post the shortlink to the pastebin in [http://springrts.com/phpbb/viewtopic.php?f=65&t=23455 this topic], together will your full system info (OS, CPU, ARCH, MacPorts version).

That's it ! Enjoy !

Spring on MacOSX

2011-08-01T12:39:33Z

Daftalx: /* Known bugs */

Last page update: 2011/08/01 by daftalx (updated SpringLobby to 0.135)

Current milestones available:
* Spring: 0.82.7.1
* SpringLobby: 0.135

=Preamble=

This tutorial is intended for Mac OS X Snow Leopard (10.6.*) users running in 32bit kernel mode. Although Spring compiles and runs in 64 bits, '''it does not work in 64bit kernel mode''' (thanks to ''frequencyandsulphur'' for digging this one out).

This tutorial has not been tested on older releases of Mac OS X (10.5-). Yet, there are big chances that you can get through and still be able to run Spring. Keep in mind though that due to architecture incompatibilities, Intel-powered macs will be able to discuss online together, as well as with PCs, but not with PPC-powered Macs.

Finally, please bear in mind that this tutorial is mostly for testing purposes and proof of concept. Although no manual compilation is required, using the Terminal application is necessary (for now). Due to the little amount of time people are dedicating to the Mac version of Spring, things will move only slowly and often behind the other platforms. Once things get stabilized, an all-in-one installer will (hopefully one day) replace this tutorial.

Good luck, and have fun !

=Basics=

==Install the XCode tools==

These are available on your Mac OS X install DVD, the installer is called "XCode Tools" in the "Optional installs" folder.

==Install the Java developer packages==

As of Apple's "Java for Mac OS X 10.6 Update 3", headers for JNI (among other stuff) are no longer provided by default. In order to build spring AIs but also various dependencies, you should download and install the Java Developer package available on Apple's support site [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20719 here] (NOTE: you must have an Apple ID to access this page. Feel free to post any public hard link in the forum to be added here instead).

==Install MacPorts==

*If you never had MacPorts installed, the latest version is available as a ".dmg" installer on [http://www.macports.org/install.php this page]
*If you already have MacPorts, make sure you run the latest version with

sudo port selfupdate

==Configure MacPorts==

Spring and it's lobbies are published in a different repository than MacPorts's official one. So you must edit (as root) the MacPorts sources file (located by default in /opt/local/etc/macports/sources.conf), and add the following line '''before''' the last one:

rsync://daftserve.dyndns.org/macports/

==Keep MacPorts up-to-date==

To sync your MacPorts install with the latest repositories hit

sudo port sync

and upgrade any outdated ports with

sudo port upgrade outdated

From now on I assume your Portfiles will always be up-to-date, therefore I will get straight to the point during the remainder of this tutorial.

=Spring=

==Install spring==

Crazy as it may seem, installing spring now comes down to this command:

sudo port install springrts binutils

WARNING: this will take a *long* while, especially on a fresh system (ballpark figure: over an hour with an Intel C2D 2.2GHz cpu).

the binutils are required for finding the source of a crash of spring, the utility addr2line is used.

==Setup game data==

create a ".spring" folder in your home directory, and create the usual "games", "maps" and "demos" folder. There you can store your favorite game data (most of the content is cross-platform compatible).

==Check if Spring works==

spring

should launch the standalone GUI in window mode, which allows offline gaming, e.g. if you have demo scripts or single player games (my favorite these days is Chicken BA).

=Lobbies=

==SpringLobby==

Although the Mac OS port of SpringLobby should be considered "barely alpha"-stage, quite a lot of features are already functional, so you should be able to play online with patience and little effort.

===Install SpringLobby===

As for the engine, installing SpringLobby comes down to a simple command:

sudo port install springlobby

In the end you should get two "double-clickable" .app bundles (springlobby and springsettings) in MacPorts's binary folder (/opt/local/bin by default).

===Setup SpringLobby===

Upon first run, you'll have to tell SpringLobby where to find the spring executable and unitsync library manually. The spring executable is in "/opt/local/bin/spring" and the unitsync library in "/opt/local/lib/libunitsync.so".

As mentioned earlier the lobby is in a very early port stage. One major feature that does *NOT* work yet is to join (or autojoin) an IRC channel (but you may chat inside a battleroom). So before connecting to the main server, open the "Autojoin channels" options window and remove all default channels.

That's it, connect and enjoy
NOTE: SpringLobby will mostly crash upon startup (much less afterwards). Don't worry, just keep trying until you get through...

===Known bugs===

*Add bot in a game opens a tiny (one-pixel wide) window. Clicking it restores its size, but be precise !

=Troubleshooting=

In case you encounter compile or install errors on the way, MacPorts will let you know that a log file has been stored somewhere like /opt/local/var/macports/logs/??/main.log, where the "??" describes the port you are installing. Paste the contents of this file into a paste bin (http://www.pastebin.ca) and post the shortlink to the pastebin in [http://springrts.com/phpbb/viewtopic.php?f=65&t=23455 this topic], together will your full system info (OS, CPU, ARCH, MacPorts version).

That's it ! Enjoy !

Spring on MacOSX

2011-08-01T12:38:20Z

Daftalx: /* Configure MacPorts */

Last page update: 2011/08/01 by daftalx (updated SpringLobby to 0.135)

Current milestones available:
* Spring: 0.82.7.1
* SpringLobby: 0.135

=Preamble=

This tutorial is intended for Mac OS X Snow Leopard (10.6.*) users running in 32bit kernel mode. Although Spring compiles and runs in 64 bits, '''it does not work in 64bit kernel mode''' (thanks to ''frequencyandsulphur'' for digging this one out).

This tutorial has not been tested on older releases of Mac OS X (10.5-). Yet, there are big chances that you can get through and still be able to run Spring. Keep in mind though that due to architecture incompatibilities, Intel-powered macs will be able to discuss online together, as well as with PCs, but not with PPC-powered Macs.

Finally, please bear in mind that this tutorial is mostly for testing purposes and proof of concept. Although no manual compilation is required, using the Terminal application is necessary (for now). Due to the little amount of time people are dedicating to the Mac version of Spring, things will move only slowly and often behind the other platforms. Once things get stabilized, an all-in-one installer will (hopefully one day) replace this tutorial.

Good luck, and have fun !

=Basics=

==Install the XCode tools==

These are available on your Mac OS X install DVD, the installer is called "XCode Tools" in the "Optional installs" folder.

==Install the Java developer packages==

As of Apple's "Java for Mac OS X 10.6 Update 3", headers for JNI (among other stuff) are no longer provided by default. In order to build spring AIs but also various dependencies, you should download and install the Java Developer package available on Apple's support site [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20719 here] (NOTE: you must have an Apple ID to access this page. Feel free to post any public hard link in the forum to be added here instead).

==Install MacPorts==

*If you never had MacPorts installed, the latest version is available as a ".dmg" installer on [http://www.macports.org/install.php this page]
*If you already have MacPorts, make sure you run the latest version with

sudo port selfupdate

==Configure MacPorts==

Spring and it's lobbies are published in a different repository than MacPorts's official one. So you must edit (as root) the MacPorts sources file (located by default in /opt/local/etc/macports/sources.conf), and add the following line '''before''' the last one:

rsync://daftserve.dyndns.org/macports/

==Keep MacPorts up-to-date==

To sync your MacPorts install with the latest repositories hit

sudo port sync

and upgrade any outdated ports with

sudo port upgrade outdated

From now on I assume your Portfiles will always be up-to-date, therefore I will get straight to the point during the remainder of this tutorial.

=Spring=

==Install spring==

Crazy as it may seem, installing spring now comes down to this command:

sudo port install springrts binutils

WARNING: this will take a *long* while, especially on a fresh system (ballpark figure: over an hour with an Intel C2D 2.2GHz cpu).

the binutils are required for finding the source of a crash of spring, the utility addr2line is used.

==Setup game data==

create a ".spring" folder in your home directory, and create the usual "games", "maps" and "demos" folder. There you can store your favorite game data (most of the content is cross-platform compatible).

==Check if Spring works==

spring

should launch the standalone GUI in window mode, which allows offline gaming, e.g. if you have demo scripts or single player games (my favorite these days is Chicken BA).

=Lobbies=

==SpringLobby==

Although the Mac OS port of SpringLobby should be considered "barely alpha"-stage, quite a lot of features are already functional, so you should be able to play online with patience and little effort.

===Install SpringLobby===

As for the engine, installing SpringLobby comes down to a simple command:

sudo port install springlobby

In the end you should get two "double-clickable" .app bundles (springlobby and springsettings) in MacPorts's binary folder (/opt/local/bin by default).

===Setup SpringLobby===

Upon first run, you'll have to tell SpringLobby where to find the spring executable and unitsync library manually. The spring executable is in "/opt/local/bin/spring" and the unitsync library in "/opt/local/lib/libunitsync.so".

As mentioned earlier the lobby is in a very early port stage. One major feature that does *NOT* work yet is to join (or autojoin) an IRC channel (but you may chat inside a battleroom). So before connecting to the main server, open the "Autojoin channels" options window and remove all default channels.

That's it, connect and enjoy
NOTE: SpringLobby will mostly crash upon startup (much less afterwards). Don't worry, just keep trying until you get through...

===Known bugs===

*Join a chat channel (the /join command stalls the app)
*Add bot in a game (hitting the "Add bot" button stalls the app)
*Loading replays (they appear in the list but wouldn't run)

=Troubleshooting=

In case you encounter compile or install errors on the way, MacPorts will let you know that a log file has been stored somewhere like /opt/local/var/macports/logs/??/main.log, where the "??" describes the port you are installing. Paste the contents of this file into a paste bin (http://www.pastebin.ca) and post the shortlink to the pastebin in [http://springrts.com/phpbb/viewtopic.php?f=65&t=23455 this topic], together will your full system info (OS, CPU, ARCH, MacPorts version).

That's it ! Enjoy !

Spring on MacOSX

2011-08-01T12:37:51Z

Daftalx: updated SL to 0.135

Last page update: 2011/08/01 by daftalx (updated SpringLobby to 0.135)

Current milestones available:
* Spring: 0.82.7.1
* SpringLobby: 0.135

=Preamble=

This tutorial is intended for Mac OS X Snow Leopard (10.6.*) users running in 32bit kernel mode. Although Spring compiles and runs in 64 bits, '''it does not work in 64bit kernel mode''' (thanks to ''frequencyandsulphur'' for digging this one out).

This tutorial has not been tested on older releases of Mac OS X (10.5-). Yet, there are big chances that you can get through and still be able to run Spring. Keep in mind though that due to architecture incompatibilities, Intel-powered macs will be able to discuss online together, as well as with PCs, but not with PPC-powered Macs.

Finally, please bear in mind that this tutorial is mostly for testing purposes and proof of concept. Although no manual compilation is required, using the Terminal application is necessary (for now). Due to the little amount of time people are dedicating to the Mac version of Spring, things will move only slowly and often behind the other platforms. Once things get stabilized, an all-in-one installer will (hopefully one day) replace this tutorial.

Good luck, and have fun !

=Basics=

==Install the XCode tools==

These are available on your Mac OS X install DVD, the installer is called "XCode Tools" in the "Optional installs" folder.

==Install the Java developer packages==

As of Apple's "Java for Mac OS X 10.6 Update 3", headers for JNI (among other stuff) are no longer provided by default. In order to build spring AIs but also various dependencies, you should download and install the Java Developer package available on Apple's support site [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20719 here] (NOTE: you must have an Apple ID to access this page. Feel free to post any public hard link in the forum to be added here instead).

==Install MacPorts==

*If you never had MacPorts installed, the latest version is available as a ".dmg" installer on [http://www.macports.org/install.php this page]
*If you already have MacPorts, make sure you run the latest version with

sudo port selfupdate

==Configure MacPorts==

Spring and it's lobbies are published in a different repository than MacPorts's official one. So you must edit (as root) the MacPorts sources file (located by default in /opt/local/etc/macports/sources.conf), and add the following line '''before''' the last one:

rsync://81.57.111.4/macports/

==Keep MacPorts up-to-date==

To sync your MacPorts install with the latest repositories hit

sudo port sync

and upgrade any outdated ports with

sudo port upgrade outdated

From now on I assume your Portfiles will always be up-to-date, therefore I will get straight to the point during the remainder of this tutorial.

=Spring=

==Install spring==

Crazy as it may seem, installing spring now comes down to this command:

sudo port install springrts binutils

WARNING: this will take a *long* while, especially on a fresh system (ballpark figure: over an hour with an Intel C2D 2.2GHz cpu).

the binutils are required for finding the source of a crash of spring, the utility addr2line is used.

==Setup game data==

create a ".spring" folder in your home directory, and create the usual "games", "maps" and "demos" folder. There you can store your favorite game data (most of the content is cross-platform compatible).

==Check if Spring works==

spring

should launch the standalone GUI in window mode, which allows offline gaming, e.g. if you have demo scripts or single player games (my favorite these days is Chicken BA).

=Lobbies=

==SpringLobby==

Although the Mac OS port of SpringLobby should be considered "barely alpha"-stage, quite a lot of features are already functional, so you should be able to play online with patience and little effort.

===Install SpringLobby===

As for the engine, installing SpringLobby comes down to a simple command:

sudo port install springlobby

In the end you should get two "double-clickable" .app bundles (springlobby and springsettings) in MacPorts's binary folder (/opt/local/bin by default).

===Setup SpringLobby===

Upon first run, you'll have to tell SpringLobby where to find the spring executable and unitsync library manually. The spring executable is in "/opt/local/bin/spring" and the unitsync library in "/opt/local/lib/libunitsync.so".

As mentioned earlier the lobby is in a very early port stage. One major feature that does *NOT* work yet is to join (or autojoin) an IRC channel (but you may chat inside a battleroom). So before connecting to the main server, open the "Autojoin channels" options window and remove all default channels.

That's it, connect and enjoy
NOTE: SpringLobby will mostly crash upon startup (much less afterwards). Don't worry, just keep trying until you get through...

===Known bugs===

*Join a chat channel (the /join command stalls the app)
*Add bot in a game (hitting the "Add bot" button stalls the app)
*Loading replays (they appear in the list but wouldn't run)

=Troubleshooting=

In case you encounter compile or install errors on the way, MacPorts will let you know that a log file has been stored somewhere like /opt/local/var/macports/logs/??/main.log, where the "??" describes the port you are installing. Paste the contents of this file into a paste bin (http://www.pastebin.ca) and post the shortlink to the pastebin in [http://springrts.com/phpbb/viewtopic.php?f=65&t=23455 this topic], together will your full system info (OS, CPU, ARCH, MacPorts version).

That's it ! Enjoy !

Spring on MacOSX

2011-07-12T22:47:28Z

Daftalx: /* Install SpringLobby */

Last page update: 2011/07/13 by daftalx (updated SpringLobby)

Current milestones available:
* Spring: 0.82.7.1
* SpringLobby: 0.131

=Preamble=

This tutorial is intended for Mac OS X Snow Leopard (10.6.*) users running in 32bit kernel mode. Although Spring compiles and runs in 64 bits, '''it does not work in 64bit kernel mode''' (thanks to ''frequencyandsulphur'' for digging this one out).

This tutorial has not been tested on older releases of Mac OS X (10.5-). Yet, there are big chances that you can get through and still be able to run Spring. Keep in mind though that due to architecture incompatibilities, Intel-powered macs will be able to discuss online together, as well as with PCs, but not with PPC-powered Macs.

Finally, please bear in mind that this tutorial is mostly for testing purposes and proof of concept. Although no manual compilation is required, using the Terminal application is necessary (for now). Due to the little amount of time people are dedicating to the Mac version of Spring, things will move only slowly and often behind the other platforms. Once things get stabilized, an all-in-one installer will (hopefully one day) replace this tutorial.

Good luck, and have fun !

=Basics=

==Install the XCode tools==

These are available on your Mac OS X install DVD, the installer is called "XCode Tools" in the "Optional installs" folder.

==Install the Java developer packages==

As of Apple's "Java for Mac OS X 10.6 Update 3", headers for JNI (among other stuff) are no longer provided by default. In order to build spring AIs but also various dependencies, you should download and install the Java Developer package available on Apple's support site [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20719 here] (NOTE: you must have an Apple ID to access this page. Feel free to post any public hard link in the forum to be added here instead).

==Install MacPorts==

*If you never had MacPorts installed, the latest version is available as a ".dmg" installer on [http://www.macports.org/install.php this page]
*If you already have MacPorts, make sure you run the latest version with

sudo port selfupdate

==Configure MacPorts==

Spring and it's lobbies are published in a different repository than MacPorts's official one. So you must edit (as root) the MacPorts sources file (located by default in /opt/local/etc/macports/sources.conf), and add the following line '''before''' the last one:

rsync://81.57.111.4/macports/

==Keep MacPorts up-to-date==

To sync your MacPorts install with the latest repositories hit

sudo port sync

and upgrade any outdated ports with

sudo port upgrade outdated

From now on I assume your Portfiles will always be up-to-date, therefore I will get straight to the point during the remainder of this tutorial.

=Spring=

==Install spring==

Crazy as it may seem, installing spring now comes down to this command:

sudo port install springrts binutils

WARNING: this will take a *long* while, especially on a fresh system (ballpark figure: over an hour with an Intel C2D 2.2GHz cpu).

the binutils are required for finding the source of a crash of spring, the utility addr2line is used.

==Setup game data==

create a ".spring" folder in your home directory, and create the usual "games", "maps" and "demos" folder. There you can store your favorite game data (most of the content is cross-platform compatible).

==Check if Spring works==

spring

should launch the standalone GUI in window mode, which allows offline gaming, e.g. if you have demo scripts or single player games (my favorite these days is Chicken BA).

=Lobbies=

==SpringLobby==

Although the Mac OS port of SpringLobby should be considered "barely alpha"-stage, quite a lot of features are already functional, so you should be able to play online with patience and little effort.

===Install SpringLobby===

As for the engine, installing SpringLobby comes down to a simple command:

sudo port install springlobby

In the end you should get two "double-clickable" .app bundles (springlobby and springsettings) in MacPorts's binary folder (/opt/local/bin by default).

===Setup SpringLobby===

Upon first run, you'll have to tell SpringLobby where to find the spring executable and unitsync library manually. The spring executable is in "/opt/local/bin/spring" and the unitsync library in "/opt/local/lib/libunitsync.so".

As mentioned earlier the lobby is in a very early port stage. One major feature that does *NOT* work yet is to join (or autojoin) an IRC channel (but you may chat inside a battleroom). So before connecting to the main server, open the "Autojoin channels" options window and remove all default channels.

That's it, connect and enjoy
NOTE: SpringLobby will mostly crash upon startup (much less afterwards). Don't worry, just keep trying until you get through...

===Known bugs===

*Join a chat channel (the /join command stalls the app)
*Add bot in a game (hitting the "Add bot" button stalls the app)
*Loading replays (they appear in the list but wouldn't run)

=Troubleshooting=

In case you encounter compile or install errors on the way, MacPorts will let you know that a log file has been stored somewhere like /opt/local/var/macports/logs/??/main.log, where the "??" describes the port you are installing. Paste the contents of this file into a paste bin (http://www.pastebin.ca) and post the shortlink to the pastebin in [http://springrts.com/phpbb/viewtopic.php?f=65&t=23455 this topic], together will your full system info (OS, CPU, ARCH, MacPorts version).

That's it ! Enjoy !

Spring on MacOSX

2011-07-12T22:47:01Z

Daftalx: updated SL to 0.131 and cleanup page

Last page update: 2011/07/13 by daftalx (updated SpringLobby)

Current milestones available:
* Spring: 0.82.7.1
* SpringLobby: 0.131

=Preamble=

This tutorial is intended for Mac OS X Snow Leopard (10.6.*) users running in 32bit kernel mode. Although Spring compiles and runs in 64 bits, '''it does not work in 64bit kernel mode''' (thanks to ''frequencyandsulphur'' for digging this one out).

This tutorial has not been tested on older releases of Mac OS X (10.5-). Yet, there are big chances that you can get through and still be able to run Spring. Keep in mind though that due to architecture incompatibilities, Intel-powered macs will be able to discuss online together, as well as with PCs, but not with PPC-powered Macs.

Finally, please bear in mind that this tutorial is mostly for testing purposes and proof of concept. Although no manual compilation is required, using the Terminal application is necessary (for now). Due to the little amount of time people are dedicating to the Mac version of Spring, things will move only slowly and often behind the other platforms. Once things get stabilized, an all-in-one installer will (hopefully one day) replace this tutorial.

Good luck, and have fun !

=Basics=

==Install the XCode tools==

These are available on your Mac OS X install DVD, the installer is called "XCode Tools" in the "Optional installs" folder.

==Install the Java developer packages==

As of Apple's "Java for Mac OS X 10.6 Update 3", headers for JNI (among other stuff) are no longer provided by default. In order to build spring AIs but also various dependencies, you should download and install the Java Developer package available on Apple's support site [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20719 here] (NOTE: you must have an Apple ID to access this page. Feel free to post any public hard link in the forum to be added here instead).

==Install MacPorts==

*If you never had MacPorts installed, the latest version is available as a ".dmg" installer on [http://www.macports.org/install.php this page]
*If you already have MacPorts, make sure you run the latest version with

sudo port selfupdate

==Configure MacPorts==

Spring and it's lobbies are published in a different repository than MacPorts's official one. So you must edit (as root) the MacPorts sources file (located by default in /opt/local/etc/macports/sources.conf), and add the following line '''before''' the last one:

rsync://81.57.111.4/macports/

==Keep MacPorts up-to-date==

To sync your MacPorts install with the latest repositories hit

sudo port sync

and upgrade any outdated ports with

sudo port upgrade outdated

From now on I assume your Portfiles will always be up-to-date, therefore I will get straight to the point during the remainder of this tutorial.

=Spring=

==Install spring==

Crazy as it may seem, installing spring now comes down to this command:

sudo port install springrts binutils

WARNING: this will take a *long* while, especially on a fresh system (ballpark figure: over an hour with an Intel C2D 2.2GHz cpu).

the binutils are required for finding the source of a crash of spring, the utility addr2line is used.

==Setup game data==

create a ".spring" folder in your home directory, and create the usual "games", "maps" and "demos" folder. There you can store your favorite game data (most of the content is cross-platform compatible).

==Check if Spring works==

spring

should launch the standalone GUI in window mode, which allows offline gaming, e.g. if you have demo scripts or single player games (my favorite these days is Chicken BA).

=Lobbies=

==SpringLobby==

Although the Mac OS port of SpringLobby should be considered "barely alpha"-stage, quite a lot of features are already functional, so you should be able to play online with patience and little effort.

===Install SpringLobby===

As for the engine, installing SpringLobby comes down to a simple command:

sudo port install boost +debug

In the end you should get two "double-clickable" .app bundles (springlobby and springsettings) in MacPorts's binary folder (/opt/local/bin by default).

===Setup SpringLobby===

Upon first run, you'll have to tell SpringLobby where to find the spring executable and unitsync library manually. The spring executable is in "/opt/local/bin/spring" and the unitsync library in "/opt/local/lib/libunitsync.so".

As mentioned earlier the lobby is in a very early port stage. One major feature that does *NOT* work yet is to join (or autojoin) an IRC channel (but you may chat inside a battleroom). So before connecting to the main server, open the "Autojoin channels" options window and remove all default channels.

That's it, connect and enjoy
NOTE: SpringLobby will mostly crash upon startup (much less afterwards). Don't worry, just keep trying until you get through...

===Known bugs===

*Join a chat channel (the /join command stalls the app)
*Add bot in a game (hitting the "Add bot" button stalls the app)
*Loading replays (they appear in the list but wouldn't run)

=Troubleshooting=

In case you encounter compile or install errors on the way, MacPorts will let you know that a log file has been stored somewhere like /opt/local/var/macports/logs/??/main.log, where the "??" describes the port you are installing. Paste the contents of this file into a paste bin (http://www.pastebin.ca) and post the shortlink to the pastebin in [http://springrts.com/phpbb/viewtopic.php?f=65&t=23455 this topic], together will your full system info (OS, CPU, ARCH, MacPorts version).

That's it ! Enjoy !

Spring on MacOSX

2011-06-07T21:53:03Z

Daftalx: /* Sync MacPorts regularly */

Last page update: 2011/06/07 by daftalx (updated Spring version; changed MacPorts repo; removed qtlobby)

Current milestones available:
* Spring: 0.82.7.1
* SpringLobby: 0.95

=Preamble=

This tutorial is intended for Mac OS X Snow Leopard (10.6.*) users running in 32bit kernel mode. Although Spring compiles and runs in 64 bits, '''it does not work in 64bit kernel mode''' (thanks to ''frequencyandsulphur'' for digging this one out).

This tutorial has not been tested on older releases of Mac OS X (10.5-). Yet, there are big chances that you can get through and still be able to run Spring. Keep in mind though that due to architecture incompatibilities, Intel-powered macs will be able to discuss online together, as well as with PCs, but not with PPC-powered Macs.

Finally, please bear in mind that this tutorial is mostly for testing purposes and proof of concept. Although no manual compilation is required, using the Terminal application is necessary (for now). Due to the little amount of time people are dedicating to the Mac version of Spring, things will move only slowly and often behind the other platforms. Once things get stabilized, an all-in-one installer will (hopefully one day) replace this tutorial.

Good luck, and have fun !

=Basics=

==Install the XCode tools==

These are available on your Mac OS X install DVD, the installer is called "XCode Tools" in the "Optional installs" folder.

==Install the Java developer packages==

As of Apple's "Java for Mac OS X 10.6 Update 3", headers for JNI (among other stuff) are no longer provided by default. In order to build spring AIs but also various dependencies, you should download and install the Java Developer package available on Apple's support site [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20719 here] (NOTE: you must have an Apple ID to access this page. Feel free to post any public hard link in the forum to be added here instead).

==Install MacPorts==

*If you never had MacPorts installed, the latest version is available as a ".dmg" installer on [http://www.macports.org/install.php this page]
*If you already have MacPorts, make sure you run the latest version with

sudo port selfupdate

==Configure MacPorts==

Spring and it's lobbies are published in a different repository than MacPorts's official one. So you must edit (as root) the MacPorts sources file (located by default in /opt/local/etc/macports/sources.conf), and add the following line '''before''' the last one:

rsync://81.57.111.4/macports/

==Keep MacPorts up-to-date==

To sync your MacPorts install with the latest repositories hit

sudo port sync

and upgrade any outdated ports with

sudo port upgrade outdated

From now on I assume your Portfiles will always be up-to-date, therefore I will get straight to the point during the remainder of this tutorial.

=Spring=

==Install spring==

Crazy as it may seem, installing spring now comes down to this command:

sudo port install springrts

WARNING: this will take a *long* while, especially on a fresh system (ballpark figure: over an hour with an Intel C2D 2.2GHz cpu).

==Setup game data==

create a ".spring" folder in your home directory, and create the usual "mods", "maps" and "demos" folder. There you can store your favorite game data (most of the content is cross-platform compatible).

==Check if Spring works==

spring

should launch the standalone GUI in window mode, which allows offline gaming, e.g. if you have demo scripts or single player mods (my favorite these days is Chicken BA).

=Lobbies=

==SpringLobby==

Although the Mac OS port of SpringLobby should be considered "barely alpha"-stage, quite a lot of features are already functional, so you should be able to play online with patience and little effort.

===Install SpringLobby===

SpringLobby currently relies on the boost library in debug mode. To install or upgrade boost with debug option on hit

sudo port install boost +debug

then proceed to SpringLobby with

sudo port install springlobby

In the end you should get two "double-clickable" .app bundles (springlobby and springsettings) in MacPorts's binary folder (/opt/local/bin by default).

===Setup SpringLobby===

Upon first run, you'll have to tell SpringLobby where to find the spring executable and unitsync library manually. The spring executable is in "/opt/local/bin/spring" and the unitsync library in "/opt/local/lib/libunitsync.dylib".

As mentioned earlier the lobby is in a very early port stage. One major feature that does *NOT* work yet is to join (or autojoin) an IRC channel (but you may chat inside a battleroom). So before connecting to the main server, open the "Autojoin channels" options window and remove all default channels.

That's it, connect and enjoy
NOTE: SpringLobby will mostly crash upon startup (much less afterwards). Don't worry, just keep trying until you get through... or try QtLobby (see below)...

===Known bugs===

*Join a chat channel (the /join command stalls the app)
*Add bot in a game (hitting the "Add bot" button stalls the app)
*Loading replays (they appear in the list but wouldn't run)

==QtLobby==

With the latest upgrade of the Qt framework, and since QtLobby is now an unmaintained project, non-backwards compatibility have pushed qtlobby out of the game. So long for a promising lobby which died a bit too prematurely.

=Troubleshooting=

In case you encounter compile or install errors on the way, MacPorts will let you know that a log file has been stored somewhere like /opt/local/var/macports/logs/??/main.log, where the "??" describes the port you are installing. Paste the contents of this file into a paste bin (http://www.pastebin.ca) and post the shortlink to the pastebin in [http://springrts.com/phpbb/viewtopic.php?f=65&t=23455 this topic], together will your full system info (OS, CPU, ARCH, MacPorts version).

That's it ! Enjoy !

Spring on MacOSX

2011-06-07T21:51:02Z

Daftalx: /* Install MacPorts */

Last page update: 2011/06/07 by daftalx (updated Spring version; changed MacPorts repo; removed qtlobby)

Current milestones available:
* Spring: 0.82.7.1
* SpringLobby: 0.95

=Preamble=

This tutorial is intended for Mac OS X Snow Leopard (10.6.*) users running in 32bit kernel mode. Although Spring compiles and runs in 64 bits, '''it does not work in 64bit kernel mode''' (thanks to ''frequencyandsulphur'' for digging this one out).

This tutorial has not been tested on older releases of Mac OS X (10.5-). Yet, there are big chances that you can get through and still be able to run Spring. Keep in mind though that due to architecture incompatibilities, Intel-powered macs will be able to discuss online together, as well as with PCs, but not with PPC-powered Macs.

Finally, please bear in mind that this tutorial is mostly for testing purposes and proof of concept. Although no manual compilation is required, using the Terminal application is necessary (for now). Due to the little amount of time people are dedicating to the Mac version of Spring, things will move only slowly and often behind the other platforms. Once things get stabilized, an all-in-one installer will (hopefully one day) replace this tutorial.

Good luck, and have fun !

=Basics=

==Install the XCode tools==

These are available on your Mac OS X install DVD, the installer is called "XCode Tools" in the "Optional installs" folder.

==Install the Java developer packages==

As of Apple's "Java for Mac OS X 10.6 Update 3", headers for JNI (among other stuff) are no longer provided by default. In order to build spring AIs but also various dependencies, you should download and install the Java Developer package available on Apple's support site [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20719 here] (NOTE: you must have an Apple ID to access this page. Feel free to post any public hard link in the forum to be added here instead).

==Install MacPorts==

*If you never had MacPorts installed, the latest version is available as a ".dmg" installer on [http://www.macports.org/install.php this page]
*If you already have MacPorts, make sure you run the latest version with

sudo port selfupdate

==Configure MacPorts==

Spring and it's lobbies are published in a different repository than MacPorts's official one. So you must edit (as root) the MacPorts sources file (located by default in /opt/local/etc/macports/sources.conf), and add the following line '''before''' the last one:

rsync://81.57.111.4/macports/

==Sync MacPorts regularly==

To sync your MacPorts install with the latest repositories hit

sudo port sync

Note that you should hit this command again everytime a Portfile is added and/or updated. To give you a hint on whether you should sync or not, here is a quick changelog of the repository:
*2011/06/01 11:40 PM: spring: added "freetype" & "py27-libxml2" dependencies (ver. 0.82.7.1)
*2011/04/15 11:27 AM: spring: Port updated (ver. 0.82.7.1)
*2010/10/21 02:31 PM: libtorrent-rasterbar: Port update (ver. 0.15.4)
*2010/08/16 12:07 PM: springlobby: Port release (ver. 0.95)
*2010/08/06 01:37 PM: qtlobby: Port release (ver. 1.0alpha)
*2010/08/03 02:35 PM: wxWidgets: Fixed shared library linking
*2010/07/30 11:26 PM: springlobby-devel: Port release (fetches latest git)
*2010/07/25 01:22 AM: wxWidgets: Port release (ver. 2.9.1)
*2010/07/09 01:02 AM: spring: Removed unnecessary Python 2.5 dependency
*2010/07/07 01:05 AM: spring: Port release (ver. 0.8.2.1)

From now on I assume your Portfiles will always be up-to-date, therefore I will get straight to the point during the remainder of this tutorial.

=Spring=

==Install spring==

Crazy as it may seem, installing spring now comes down to this command:

sudo port install springrts

WARNING: this will take a *long* while, especially on a fresh system (ballpark figure: over an hour with an Intel C2D 2.2GHz cpu).

==Setup game data==

create a ".spring" folder in your home directory, and create the usual "mods", "maps" and "demos" folder. There you can store your favorite game data (most of the content is cross-platform compatible).

==Check if Spring works==

spring

should launch the standalone GUI in window mode, which allows offline gaming, e.g. if you have demo scripts or single player mods (my favorite these days is Chicken BA).

=Lobbies=

==SpringLobby==

Although the Mac OS port of SpringLobby should be considered "barely alpha"-stage, quite a lot of features are already functional, so you should be able to play online with patience and little effort.

===Install SpringLobby===

SpringLobby currently relies on the boost library in debug mode. To install or upgrade boost with debug option on hit

sudo port install boost +debug

then proceed to SpringLobby with

sudo port install springlobby

In the end you should get two "double-clickable" .app bundles (springlobby and springsettings) in MacPorts's binary folder (/opt/local/bin by default).

===Setup SpringLobby===

Upon first run, you'll have to tell SpringLobby where to find the spring executable and unitsync library manually. The spring executable is in "/opt/local/bin/spring" and the unitsync library in "/opt/local/lib/libunitsync.dylib".

As mentioned earlier the lobby is in a very early port stage. One major feature that does *NOT* work yet is to join (or autojoin) an IRC channel (but you may chat inside a battleroom). So before connecting to the main server, open the "Autojoin channels" options window and remove all default channels.

That's it, connect and enjoy
NOTE: SpringLobby will mostly crash upon startup (much less afterwards). Don't worry, just keep trying until you get through... or try QtLobby (see below)...

===Known bugs===

*Join a chat channel (the /join command stalls the app)
*Add bot in a game (hitting the "Add bot" button stalls the app)
*Loading replays (they appear in the list but wouldn't run)

==QtLobby==

With the latest upgrade of the Qt framework, and since QtLobby is now an unmaintained project, non-backwards compatibility have pushed qtlobby out of the game. So long for a promising lobby which died a bit too prematurely.

=Troubleshooting=

In case you encounter compile or install errors on the way, MacPorts will let you know that a log file has been stored somewhere like /opt/local/var/macports/logs/??/main.log, where the "??" describes the port you are installing. Paste the contents of this file into a paste bin (http://www.pastebin.ca) and post the shortlink to the pastebin in [http://springrts.com/phpbb/viewtopic.php?f=65&t=23455 this topic], together will your full system info (OS, CPU, ARCH, MacPorts version).

That's it ! Enjoy !

Spring on MacOSX

2011-06-07T21:49:14Z

Daftalx: Updated MacPorts repository and Spring version

Last page update: 2011/06/07 by daftalx (updated Spring version; changed MacPorts repo; removed qtlobby)

Current milestones available:
* Spring: 0.82.7.1
* SpringLobby: 0.95

=Preamble=

This tutorial is intended for Mac OS X Snow Leopard (10.6.*) users running in 32bit kernel mode. Although Spring compiles and runs in 64 bits, '''it does not work in 64bit kernel mode''' (thanks to ''frequencyandsulphur'' for digging this one out).

This tutorial has not been tested on older releases of Mac OS X (10.5-). Yet, there are big chances that you can get through and still be able to run Spring. Keep in mind though that due to architecture incompatibilities, Intel-powered macs will be able to discuss online together, as well as with PCs, but not with PPC-powered Macs.

Finally, please bear in mind that this tutorial is mostly for testing purposes and proof of concept. Although no manual compilation is required, using the Terminal application is necessary (for now). Due to the little amount of time people are dedicating to the Mac version of Spring, things will move only slowly and often behind the other platforms. Once things get stabilized, an all-in-one installer will (hopefully one day) replace this tutorial.

Good luck, and have fun !

=Basics=

==Install the XCode tools==

These are available on your Mac OS X install DVD, the installer is called "XCode Tools" in the "Optional installs" folder.

==Install the Java developer packages==

As of Apple's "Java for Mac OS X 10.6 Update 3", headers for JNI (among other stuff) are no longer provided by default. In order to build spring AIs but also various dependencies, you should download and install the Java Developer package available on Apple's support site [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20719 here] (NOTE: you must have an Apple ID to access this page. Feel free to post any public hard link in the forum to be added here instead).

==Install MacPorts==

*If you never had MacPorts installed, the latest version is available as a ".dmg" installer on [http://www.macports.org/install.php this page]
*If you already have MacPorts, make sure you run the latest version with

sudo port selfupdate

and upgrade your ports with

sudo port upgrade outdated

==Configure MacPorts==

Spring and it's lobbies are published in a different repository than MacPorts's official one. So you must edit (as root) the MacPorts sources file (located by default in /opt/local/etc/macports/sources.conf), and add the following line '''before''' the last one:

rsync://81.57.111.4/macports/

==Sync MacPorts regularly==

To sync your MacPorts install with the latest repositories hit

sudo port sync

Note that you should hit this command again everytime a Portfile is added and/or updated. To give you a hint on whether you should sync or not, here is a quick changelog of the repository:
*2011/06/01 11:40 PM: spring: added "freetype" & "py27-libxml2" dependencies (ver. 0.82.7.1)
*2011/04/15 11:27 AM: spring: Port updated (ver. 0.82.7.1)
*2010/10/21 02:31 PM: libtorrent-rasterbar: Port update (ver. 0.15.4)
*2010/08/16 12:07 PM: springlobby: Port release (ver. 0.95)
*2010/08/06 01:37 PM: qtlobby: Port release (ver. 1.0alpha)
*2010/08/03 02:35 PM: wxWidgets: Fixed shared library linking
*2010/07/30 11:26 PM: springlobby-devel: Port release (fetches latest git)
*2010/07/25 01:22 AM: wxWidgets: Port release (ver. 2.9.1)
*2010/07/09 01:02 AM: spring: Removed unnecessary Python 2.5 dependency
*2010/07/07 01:05 AM: spring: Port release (ver. 0.8.2.1)

From now on I assume your Portfiles will always be up-to-date, therefore I will get straight to the point during the remainder of this tutorial.

=Spring=

==Install spring==

Crazy as it may seem, installing spring now comes down to this command:

sudo port install springrts

WARNING: this will take a *long* while, especially on a fresh system (ballpark figure: over an hour with an Intel C2D 2.2GHz cpu).

==Setup game data==

create a ".spring" folder in your home directory, and create the usual "mods", "maps" and "demos" folder. There you can store your favorite game data (most of the content is cross-platform compatible).

==Check if Spring works==

spring

should launch the standalone GUI in window mode, which allows offline gaming, e.g. if you have demo scripts or single player mods (my favorite these days is Chicken BA).

=Lobbies=

==SpringLobby==

Although the Mac OS port of SpringLobby should be considered "barely alpha"-stage, quite a lot of features are already functional, so you should be able to play online with patience and little effort.

===Install SpringLobby===

SpringLobby currently relies on the boost library in debug mode. To install or upgrade boost with debug option on hit

sudo port install boost +debug

then proceed to SpringLobby with

sudo port install springlobby

In the end you should get two "double-clickable" .app bundles (springlobby and springsettings) in MacPorts's binary folder (/opt/local/bin by default).

===Setup SpringLobby===

Upon first run, you'll have to tell SpringLobby where to find the spring executable and unitsync library manually. The spring executable is in "/opt/local/bin/spring" and the unitsync library in "/opt/local/lib/libunitsync.dylib".

As mentioned earlier the lobby is in a very early port stage. One major feature that does *NOT* work yet is to join (or autojoin) an IRC channel (but you may chat inside a battleroom). So before connecting to the main server, open the "Autojoin channels" options window and remove all default channels.

That's it, connect and enjoy
NOTE: SpringLobby will mostly crash upon startup (much less afterwards). Don't worry, just keep trying until you get through... or try QtLobby (see below)...

===Known bugs===

*Join a chat channel (the /join command stalls the app)
*Add bot in a game (hitting the "Add bot" button stalls the app)
*Loading replays (they appear in the list but wouldn't run)

==QtLobby==

With the latest upgrade of the Qt framework, and since QtLobby is now an unmaintained project, non-backwards compatibility have pushed qtlobby out of the game. So long for a promising lobby which died a bit too prematurely.

=Troubleshooting=

In case you encounter compile or install errors on the way, MacPorts will let you know that a log file has been stored somewhere like /opt/local/var/macports/logs/??/main.log, where the "??" describes the port you are installing. Paste the contents of this file into a paste bin (http://www.pastebin.ca) and post the shortlink to the pastebin in [http://springrts.com/phpbb/viewtopic.php?f=65&t=23455 this topic], together will your full system info (OS, CPU, ARCH, MacPorts version).

That's it ! Enjoy !

Spring on MacOSX

2010-12-19T22:44:58Z

Daftalx:

Last page update: 2010/12/19 by daftalx (changed MacPorts repo; added Java Developer Package requirement)

Current milestones available:
* Spring: 0.81.2.1
* SpringLobby: 0.95
* QtLobby: 1.0 alpha rev. 597

=Preamble=

This tutorial is intended for Mac OS X Snow Leopard (10.6.*) users running in 32bit kernel mode. Although Spring compiles and runs in 64 bits, '''it does not work in 64bit kernel mode''' (thanks to ''frequencyandsulphur'' for digging this one out).

This tutorial has not been tested on older releases of Mac OS X (10.5-). Yet, there are big chances that you can get through and still be able to run Spring. Keep in mind though that due to architecture incompatibilities, Intel-powered macs will be able to discuss online together, as well as with PCs, but not with PPC-powered Macs.

Finally, please bear in mind that this tutorial is mostly for testing purposes and proof of concept. Although no manual compilation is required, using the Terminal application is necessary (for now). Due to the little amount of time people are dedicating to the Mac version of Spring, things will move only slowly and often behind the other platforms. Once things get stabilized, an all-in-one installer will (hopefully one day) replace this tutorial.

Good luck, and have fun !

=Basics=

==Install the XCode tools==

These are available on your Mac OS X install DVD, the installer is called "XCode Tools" in the "Optional installs" folder.

==Install the Java developer packages==

As of Apple's "Java for Mac OS X 10.6 Update 3", headers for JNI (among other stuff) are no longer provided by default. In order to build spring AIs but also various dependencies, you should download and install the Java Developer package available on Apple's support site [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20719 here] (NOTE: you must have an Apple ID to access this page. Feel free to post any public hard link in the forum to be added here instead).

==Install MacPorts==

*If you never had MacPorts installed, the latest version is available as a ".dmg" installer on [http://www.macports.org/install.php this page]
*If you already have MacPorts, make sure you run the latest version with

sudo port selfupdate

and upgrade your ports with

sudo port upgrade outdated

==Configure MacPorts==

Spring and it's lobbies are published in a different repository than MacPorts's official one. So you must edit (as root) the MacPorts sources file (located by default in /opt/local/etc/macports/sources.conf), and add the following line '''before''' the last one:

rsync://daftserver.dyndns.org/macports/

==Sync MacPorts regularly==

To sync your MacPorts install with the latest repositories hit

sudo port sync

Note that you should hit this command again everytime a Portfile is added and/or updated. To give you a hint on whether you should sync or not, here is a quick changelog of the repository:
*2010/10/21 14:31 PM: libtorrent-rasterbar: Port update (ver. 0.15.4)
*2010/08/16 12:07 PM: springlobby: Port release (ver. 0.95)
*2010/08/06 01:37 PM: qtlobby: Port release (ver. 1.0alpha)
*2010/08/03 02:35 PM: wxWidgets: Fixed shared library linking
*2010/07/30 11:26 PM: springlobby-devel: Port release (fetches latest git)
*2010/07/25 01:22 AM: wxWidgets: Port release (ver. 2.9.1)
*2010/07/09 01:02 AM: spring: Removed unnecessary Python 2.5 dependency
*2010/07/07 01:05 AM: spring: Port release (ver. 0.8.2.1)

From now on I assume your Portfiles will always be up-to-date, therefore I will get straight to the point during the remainder of this tutorial.

=Spring=

==Install spring==

Crazy as it may seem, installing spring now comes down to this command:

sudo port install springrts

WARNING: this will take a *long* while, especially on a fresh system (ballpark figure: over an hour with an Intel C2D 2.2GHz cpu).

==Setup game data==

create a ".spring" folder in your home directory, and create the usual "mods", "maps" and "demos" folder. There you can store your favorite game data (most of the content is cross-platform compatible).

==Check if Spring works==

spring

should launch the standalone GUI in window mode, which allows offline gaming, e.g. if you have demo scripts or single player mods (my favorite these days is Chicken BA).

=Lobbies=

==SpringLobby==

Although the Mac OS port of SpringLobby should be considered "barely alpha"-stage, quite a lot of features are already functional, so you should be able to play online with patience and little effort.

===Install SpringLobby===

SpringLobby currently relies on the boost library in debug mode. To install or upgrade boost with debug option on hit

sudo port install boost +debug

then proceed to SpringLobby with

sudo port install springlobby

In the end you should get two "double-clickable" .app bundles (springlobby and springsettings) in MacPorts's binary folder (/opt/local/bin by default).

===Setup SpringLobby===

Upon first run, you'll have to tell SpringLobby where to find the spring executable and unitsync library manually. The spring executable is in "/opt/local/bin/spring" and the unitsync library in "/opt/local/lib/libunitsync.dylib".

As mentioned earlier the lobby is in a very early port stage. One major feature that does *NOT* work yet is to join (or autojoin) an IRC channel (but you may chat inside a battleroom). So before connecting to the main server, open the "Autojoin channels" options window and remove all default channels.

That's it, connect and enjoy
NOTE: SpringLobby will mostly crash upon startup (much less afterwards). Don't worry, just keep trying until you get through... or try QtLobby (see below)...

===Known bugs===

*Join a chat channel (the /join command stalls the app)
*Add bot in a game (hitting the "Add bot" button stalls the app)
*Loading replays (they appear in the list but wouldn't run)

==QtLobby==

Although QtLobby is now an unmaintained project, it had acquired the reputation of being a both fast and stable alternative to TASclient and SpringLobby. Here is how it compares to the Mac port of SpringLobby:
*Interface is faster and more responsive
*Great IRC chat management
*Bots & Replays not supported (at all)

Again, installing is as simple as

sudo port install qtlobby

and launching is as simple as hitting

qtlobby

As for SpringLobby, upon first run you will have to point to spring executable, unitsync library and data folder manually.

=Troubleshooting=

In case you encounter compile or install errors on the way, MacPorts will let you know that a log file has been stored somewhere like /opt/local/var/macports/logs/??/main.log, where the "??" describes the port you are installing. Paste the contents of this file into a paste bin (http://www.pastebin.ca) and post the shortlink to the pastebin in [http://springrts.com/phpbb/viewtopic.php?f=65&t=23455 this topic], together will your full system info (OS, CPU, ARCH, MacPorts version).

That's it ! Enjoy !

Spring on MacOSX

2010-12-19T22:43:28Z

Daftalx: Added Java Developer Package requirement

Last page update: 2010/10/21 by daftalx (migrated the tutorial from the forum)

Current milestones available:
* Spring: 0.81.2.1
* SpringLobby: 0.95
* QtLobby: 1.0 alpha rev. 597

=Preamble=

This tutorial is intended for Mac OS X Snow Leopard (10.6.*) users running in 32bit kernel mode. Although Spring compiles and runs in 64 bits, '''it does not work in 64bit kernel mode''' (thanks to ''frequencyandsulphur'' for digging this one out).

This tutorial has not been tested on older releases of Mac OS X (10.5-). Yet, there are big chances that you can get through and still be able to run Spring. Keep in mind though that due to architecture incompatibilities, Intel-powered macs will be able to discuss online together, as well as with PCs, but not with PPC-powered Macs.

Finally, please bear in mind that this tutorial is mostly for testing purposes and proof of concept. Although no manual compilation is required, using the Terminal application is necessary (for now). Due to the little amount of time people are dedicating to the Mac version of Spring, things will move only slowly and often behind the other platforms. Once things get stabilized, an all-in-one installer will (hopefully one day) replace this tutorial.

Good luck, and have fun !

=Basics=

==Install the XCode tools==

These are available on your Mac OS X install DVD, the installer is called "XCode Tools" in the "Optional installs" folder.

==Install the Java developer packages==

As of Apple's "Java for Mac OS X 10.6 Update 3", headers for JNI (among other stuff) are no longer provided by default. In order to build spring AIs but also various dependencies, you should download and install the Java Developer package available on Apple's support site [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20719 here] (NOTE: you must have an Apple ID to access this page. Feel free to post any public hard link in the forum to be added here instead).

==Install MacPorts==

*If you never had MacPorts installed, the latest version is available as a ".dmg" installer on [http://www.macports.org/install.php this page]
*If you already have MacPorts, make sure you run the latest version with

sudo port selfupdate

and upgrade your ports with

sudo port upgrade outdated

==Configure MacPorts==

Spring and it's lobbies are published in a different repository than MacPorts's official one. So you must edit (as root) the MacPorts sources file (located by default in /opt/local/etc/macports/sources.conf), and add the following line '''before''' the last one:

rsync://daftserver.dyndns.org/macports/

==Sync MacPorts regularly==

To sync your MacPorts install with the latest repositories hit

sudo port sync

Note that you should hit this command again everytime a Portfile is added and/or updated. To give you a hint on whether you should sync or not, here is a quick changelog of the repository:
*2010/10/21 14:31 PM: libtorrent-rasterbar: Port update (ver. 0.15.4)
*2010/08/16 12:07 PM: springlobby: Port release (ver. 0.95)
*2010/08/06 01:37 PM: qtlobby: Port release (ver. 1.0alpha)
*2010/08/03 02:35 PM: wxWidgets: Fixed shared library linking
*2010/07/30 11:26 PM: springlobby-devel: Port release (fetches latest git)
*2010/07/25 01:22 AM: wxWidgets: Port release (ver. 2.9.1)
*2010/07/09 01:02 AM: spring: Removed unnecessary Python 2.5 dependency
*2010/07/07 01:05 AM: spring: Port release (ver. 0.8.2.1)

From now on I assume your Portfiles will always be up-to-date, therefore I will get straight to the point during the remainder of this tutorial.

=Spring=

==Install spring==

Crazy as it may seem, installing spring now comes down to this command:

sudo port install springrts

WARNING: this will take a *long* while, especially on a fresh system (ballpark figure: over an hour with an Intel C2D 2.2GHz cpu).

==Setup game data==

create a ".spring" folder in your home directory, and create the usual "mods", "maps" and "demos" folder. There you can store your favorite game data (most of the content is cross-platform compatible).

==Check if Spring works==

spring

should launch the standalone GUI in window mode, which allows offline gaming, e.g. if you have demo scripts or single player mods (my favorite these days is Chicken BA).

=Lobbies=

==SpringLobby==

Although the Mac OS port of SpringLobby should be considered "barely alpha"-stage, quite a lot of features are already functional, so you should be able to play online with patience and little effort.

===Install SpringLobby===

SpringLobby currently relies on the boost library in debug mode. To install or upgrade boost with debug option on hit

sudo port install boost +debug

then proceed to SpringLobby with

sudo port install springlobby

In the end you should get two "double-clickable" .app bundles (springlobby and springsettings) in MacPorts's binary folder (/opt/local/bin by default).

===Setup SpringLobby===

Upon first run, you'll have to tell SpringLobby where to find the spring executable and unitsync library manually. The spring executable is in "/opt/local/bin/spring" and the unitsync library in "/opt/local/lib/libunitsync.dylib".

As mentioned earlier the lobby is in a very early port stage. One major feature that does *NOT* work yet is to join (or autojoin) an IRC channel (but you may chat inside a battleroom). So before connecting to the main server, open the "Autojoin channels" options window and remove all default channels.

That's it, connect and enjoy
NOTE: SpringLobby will mostly crash upon startup (much less afterwards). Don't worry, just keep trying until you get through... or try QtLobby (see below)...

===Known bugs===

*Join a chat channel (the /join command stalls the app)
*Add bot in a game (hitting the "Add bot" button stalls the app)
*Loading replays (they appear in the list but wouldn't run)

==QtLobby==

Although QtLobby is now an unmaintained project, it had acquired the reputation of being a both fast and stable alternative to TASclient and SpringLobby. Here is how it compares to the Mac port of SpringLobby:
*Interface is faster and more responsive
*Great IRC chat management
*Bots & Replays not supported (at all)

Again, installing is as simple as

sudo port install qtlobby

and launching is as simple as hitting

qtlobby

As for SpringLobby, upon first run you will have to point to spring executable, unitsync library and data folder manually.

=Troubleshooting=

In case you encounter compile or install errors on the way, MacPorts will let you know that a log file has been stored somewhere like /opt/local/var/macports/logs/??/main.log, where the "??" describes the port you are installing. Paste the contents of this file into a paste bin (http://www.pastebin.ca) and post the shortlink to the pastebin in [http://springrts.com/phpbb/viewtopic.php?f=65&t=23455 this topic], together will your full system info (OS, CPU, ARCH, MacPorts version).

That's it ! Enjoy !

Spring on MacOSX

2010-12-18T23:12:55Z

Daftalx: /* Configure MacPorts */

Last page update: 2010/10/21 by daftalx (migrated the tutorial from the forum)

Current milestones available:
* Spring: 0.81.2.1
* SpringLobby: 0.95
* QtLobby: 1.0 alpha rev. 597

=Preamble=

This tutorial is intended for Mac OS X Snow Leopard (10.6.*) users running in 32bit kernel mode. Although Spring compiles and runs in 64 bits, '''it does not work in 64bit kernel mode''' (thanks to ''frequencyandsulphur'' for digging this one out).

This tutorial has not been tested on older releases of Mac OS X (10.5-). Yet, there are big chances that you can get through and still be able to run Spring. Keep in mind though that due to architecture incompatibilities, Intel-powered macs will be able to discuss online together, as well as with PCs, but not with PPC-powered Macs.

Finally, please bear in mind that this tutorial is mostly for testing purposes and proof of concept. Although no manual compilation is required, using the Terminal application is necessary (for now). Due to the little amount of time people are dedicating to the Mac version of Spring, things will move only slowly and often behind the other platforms. Once things get stabilized, an all-in-one installer will (hopefully one day) replace this tutorial.

Good luck, and have fun !

=Basics=

==Install the XCode tools==

These are available on your Mac OS X install DVD, the installer is called "XCode Tools" in the "Optional installs" folder.

==Install MacPorts==

*If you never had MacPorts installed, the latest version is available as a ".dmg" installer on [http://www.macports.org/install.php this page]
*If you already have MacPorts, make sure you run the latest version with

sudo port selfupdate

and upgrade your ports with

sudo port upgrade outdated

==Configure MacPorts==

Spring and it's lobbies are published in a different repository than MacPorts's official one. So you must edit (as root) the MacPorts sources file (located by default in /opt/local/etc/macports/sources.conf), and add the following line '''before''' the last one:

rsync://daftserver.dyndns.org/macports/

==Sync MacPorts regularly==

To sync your MacPorts install with the latest repositories hit

sudo port sync

Note that you should hit this command again everytime a Portfile is added and/or updated. To give you a hint on whether you should sync or not, here is a quick changelog of the repository:
*2010/10/21 14:31 PM: libtorrent-rasterbar: Port update (ver. 0.15.4)
*2010/08/16 12:07 PM: springlobby: Port release (ver. 0.95)
*2010/08/06 01:37 PM: qtlobby: Port release (ver. 1.0alpha)
*2010/08/03 02:35 PM: wxWidgets: Fixed shared library linking
*2010/07/30 11:26 PM: springlobby-devel: Port release (fetches latest git)
*2010/07/25 01:22 AM: wxWidgets: Port release (ver. 2.9.1)
*2010/07/09 01:02 AM: spring: Removed unnecessary Python 2.5 dependency
*2010/07/07 01:05 AM: spring: Port release (ver. 0.8.2.1)

From now on I assume your Portfiles will always be up-to-date, therefore I will get straight to the point during the remainder of this tutorial.

=Spring=

==Install spring==

Crazy as it may seem, installing spring now comes down to this command:

sudo port install springrts

WARNING: this will take a *long* while, especially on a fresh system (ballpark figure: over an hour with an Intel C2D 2.2GHz cpu).

==Setup game data==

create a ".spring" folder in your home directory, and create the usual "mods", "maps" and "demos" folder. There you can store your favorite game data (most of the content is cross-platform compatible).

==Check if Spring works==

spring

should launch the standalone GUI in window mode, which allows offline gaming, e.g. if you have demo scripts or single player mods (my favorite these days is Chicken BA).

=Lobbies=

==SpringLobby==

Although the Mac OS port of SpringLobby should be considered "barely alpha"-stage, quite a lot of features are already functional, so you should be able to play online with patience and little effort.

===Install SpringLobby===

SpringLobby currently relies on the boost library in debug mode. To install or upgrade boost with debug option on hit

sudo port install boost +debug

then proceed to SpringLobby with

sudo port install springlobby

In the end you should get two "double-clickable" .app bundles (springlobby and springsettings) in MacPorts's binary folder (/opt/local/bin by default).

===Setup SpringLobby===

Upon first run, you'll have to tell SpringLobby where to find the spring executable and unitsync library manually. The spring executable is in "/opt/local/bin/spring" and the unitsync library in "/opt/local/lib/libunitsync.dylib".

As mentioned earlier the lobby is in a very early port stage. One major feature that does *NOT* work yet is to join (or autojoin) an IRC channel (but you may chat inside a battleroom). So before connecting to the main server, open the "Autojoin channels" options window and remove all default channels.

That's it, connect and enjoy
NOTE: SpringLobby will mostly crash upon startup (much less afterwards). Don't worry, just keep trying until you get through... or try QtLobby (see below)...

===Known bugs===

*Join a chat channel (the /join command stalls the app)
*Add bot in a game (hitting the "Add bot" button stalls the app)
*Loading replays (they appear in the list but wouldn't run)

==QtLobby==

Although QtLobby is now an unmaintained project, it had acquired the reputation of being a both fast and stable alternative to TASclient and SpringLobby. Here is how it compares to the Mac port of SpringLobby:
*Interface is faster and more responsive
*Great IRC chat management
*Bots & Replays not supported (at all)

Again, installing is as simple as

sudo port install qtlobby

and launching is as simple as hitting

qtlobby

As for SpringLobby, upon first run you will have to point to spring executable, unitsync library and data folder manually.

=Troubleshooting=

In case you encounter compile or install errors on the way, MacPorts will let you know that a log file has been stored somewhere like /opt/local/var/macports/logs/??/main.log, where the "??" describes the port you are installing. Paste the contents of this file into a paste bin (http://www.pastebin.ca) and post the shortlink to the pastebin in [http://springrts.com/phpbb/viewtopic.php?f=65&t=23455 this topic], together will your full system info (OS, CPU, ARCH, MacPorts version).

That's it ! Enjoy !

Spring on MacOSX

2010-12-18T23:05:09Z

Daftalx: updated MacPorts repository address

Last page update: 2010/10/21 by daftalx (migrated the tutorial from the forum)

Current milestones available:
* Spring: 0.81.2.1
* SpringLobby: 0.95
* QtLobby: 1.0 alpha rev. 597

=Preamble=

This tutorial is intended for Mac OS X Snow Leopard (10.6.*) users running in 32bit kernel mode. Although Spring compiles and runs in 64 bits, '''it does not work in 64bit kernel mode''' (thanks to ''frequencyandsulphur'' for digging this one out).

This tutorial has not been tested on older releases of Mac OS X (10.5-). Yet, there are big chances that you can get through and still be able to run Spring. Keep in mind though that due to architecture incompatibilities, Intel-powered macs will be able to discuss online together, as well as with PCs, but not with PPC-powered Macs.

Finally, please bear in mind that this tutorial is mostly for testing purposes and proof of concept. Although no manual compilation is required, using the Terminal application is necessary (for now). Due to the little amount of time people are dedicating to the Mac version of Spring, things will move only slowly and often behind the other platforms. Once things get stabilized, an all-in-one installer will (hopefully one day) replace this tutorial.

Good luck, and have fun !

=Basics=

==Install the XCode tools==

These are available on your Mac OS X install DVD, the installer is called "XCode Tools" in the "Optional installs" folder.

==Install MacPorts==

*If you never had MacPorts installed, the latest version is available as a ".dmg" installer on [http://www.macports.org/install.php this page]
*If you already have MacPorts, make sure you run the latest version with

sudo port selfupdate

and upgrade your ports with

sudo port upgrade outdated

==Configure MacPorts==

Spring and it's lobbies are published in a different repository than MacPorts's official one. So you must edit (as root) the MacPorts sources file (located by default in /opt/local/etc/macports/sources.conf), and add the following line before the last one:

rsync://daftserver.dyndns.org/macports/

==Sync MacPorts regularly==

To sync your MacPorts install with the latest repositories hit

sudo port sync

Note that you should hit this command again everytime a Portfile is added and/or updated. To give you a hint on whether you should sync or not, here is a quick changelog of the repository:
*2010/10/21 14:31 PM: libtorrent-rasterbar: Port update (ver. 0.15.4)
*2010/08/16 12:07 PM: springlobby: Port release (ver. 0.95)
*2010/08/06 01:37 PM: qtlobby: Port release (ver. 1.0alpha)
*2010/08/03 02:35 PM: wxWidgets: Fixed shared library linking
*2010/07/30 11:26 PM: springlobby-devel: Port release (fetches latest git)
*2010/07/25 01:22 AM: wxWidgets: Port release (ver. 2.9.1)
*2010/07/09 01:02 AM: spring: Removed unnecessary Python 2.5 dependency
*2010/07/07 01:05 AM: spring: Port release (ver. 0.8.2.1)

From now on I assume your Portfiles will always be up-to-date, therefore I will get straight to the point during the remainder of this tutorial.

=Spring=

==Install spring==

Crazy as it may seem, installing spring now comes down to this command:

sudo port install springrts

WARNING: this will take a *long* while, especially on a fresh system (ballpark figure: over an hour with an Intel C2D 2.2GHz cpu).

==Setup game data==

create a ".spring" folder in your home directory, and create the usual "mods", "maps" and "demos" folder. There you can store your favorite game data (most of the content is cross-platform compatible).

==Check if Spring works==

spring

should launch the standalone GUI in window mode, which allows offline gaming, e.g. if you have demo scripts or single player mods (my favorite these days is Chicken BA).

=Lobbies=

==SpringLobby==

Although the Mac OS port of SpringLobby should be considered "barely alpha"-stage, quite a lot of features are already functional, so you should be able to play online with patience and little effort.

===Install SpringLobby===

SpringLobby currently relies on the boost library in debug mode. To install or upgrade boost with debug option on hit

sudo port install boost +debug

then proceed to SpringLobby with

sudo port install springlobby

In the end you should get two "double-clickable" .app bundles (springlobby and springsettings) in MacPorts's binary folder (/opt/local/bin by default).

===Setup SpringLobby===

Upon first run, you'll have to tell SpringLobby where to find the spring executable and unitsync library manually. The spring executable is in "/opt/local/bin/spring" and the unitsync library in "/opt/local/lib/libunitsync.dylib".

As mentioned earlier the lobby is in a very early port stage. One major feature that does *NOT* work yet is to join (or autojoin) an IRC channel (but you may chat inside a battleroom). So before connecting to the main server, open the "Autojoin channels" options window and remove all default channels.

That's it, connect and enjoy
NOTE: SpringLobby will mostly crash upon startup (much less afterwards). Don't worry, just keep trying until you get through... or try QtLobby (see below)...

===Known bugs===

*Join a chat channel (the /join command stalls the app)
*Add bot in a game (hitting the "Add bot" button stalls the app)
*Loading replays (they appear in the list but wouldn't run)

==QtLobby==

Although QtLobby is now an unmaintained project, it had acquired the reputation of being a both fast and stable alternative to TASclient and SpringLobby. Here is how it compares to the Mac port of SpringLobby:
*Interface is faster and more responsive
*Great IRC chat management
*Bots & Replays not supported (at all)

Again, installing is as simple as

sudo port install qtlobby

and launching is as simple as hitting

qtlobby

As for SpringLobby, upon first run you will have to point to spring executable, unitsync library and data folder manually.

=Troubleshooting=

In case you encounter compile or install errors on the way, MacPorts will let you know that a log file has been stored somewhere like /opt/local/var/macports/logs/??/main.log, where the "??" describes the port you are installing. Paste the contents of this file into a paste bin (http://www.pastebin.ca) and post the shortlink to the pastebin in [http://springrts.com/phpbb/viewtopic.php?f=65&t=23455 this topic], together will your full system info (OS, CPU, ARCH, MacPorts version).

That's it ! Enjoy !

Building Spring on MacOSX

2010-10-21T13:28:33Z

Daftalx: /* Duplicate and missing information */

[[Engine_Development|Development]] < [[Building_spring|Building Spring]] < {{FULLPAGENAME}}

= Outdated information =

This page now outdated and has been replaced by a more recent tutorial at [[Spring_on_MacOSX]].

It is kept here for history and archiving purposes.

=Build from source on MacOSX=

'''Guide is for x86/Intel based OSX installs'''

I am hoping that with our efforts on the forum that we can have an .app bundle released everytime spring is updated and that will save most people needing to go through the headache of compiling from source code. But if you must try, then here's the steps to help!

I cannot stress enough that this will most likely only work on Intel based systems at this stage. With my understanding of how unitsync works, it seems like online play will not be possible between PPC and x86 architecture.

=Obtaining the Source=
{{Obtaining_The_Source_Code}}

=Get Dependencies=

You will need to install some development packages Spring depends on. Most of these are available using [http://http://www.macports.org/ Macports] (similar to portage / apt-get etc available on various linux distro's)

You will also need to install the [http://developer.apple.com/TOOLS/Xcode/ Xcode developers package] (this requires a free membership to apple's ADC website)

==Full list==

*Programs necessary to build
**Xcode
**cmake (or scons)
**zip
**The usual build toolchain
***gcc ''(comes with Xcode tools)''
***make ''(comes with Xcode tools)''
*Libraries
**SDL
**boost (version 1.35 or later recommended)
***threads
***regex
***signals
***system
**DeviL (IL, ILU)
**OpenAL ''Please check the OpenAL section for MacOSX specific info''
**OpenGL headers (mesa, glew, etc.) ''(comes with Xcode tools)''
**zlib
**freetype
**ogg,vorbis and vorbisfile
*Optional, for bindings and Ais
**Python (2.5)
**Java-SDK ''(pre-installed on OSX)''

==Using Macports==

Once you have downloaded and configured Macports use these commands to download / compile and install the required dependencies:

<code><pre>
sudo port install cmake
sudo port install libsdl
sudo port install libsdl-framework
sudo port install boost
sudo port install boost-jam
sudo port install libpng # These image libraries might not be needed, but may save you some headaches
sudo port install jpeg
sudo port install tiff
sudo port install libogg
sudo port install libvorbis
sudo port install python25
sudo port install libdevil
</pre></code>

As of October 12th 2009, the Macports install of ''libdevil'' (''1.6.8-rc2_0'') is broken for some people.
If you get errors like:
<code>/opt/local/include/IL/il.h:505: error: â€˜<anonymous>â€™ has incomplete type</code>
while building spring, you will probably need to install it from source.

If all was successful, you are very close to being able to compile Spring naively!

==Installing ''libdevil'' from source==

Make sure that all the other port packages are installed first!
Download the source. Right now ''1.6.8-rc2_0'' has the bug we are trying to work around, so do not use that one, or earlier versions.

Extract the source code.

Configure with this command:
<code><pre>
./configure --enable-png --enable-ILU --enable-ILUT --enable-x86_64 CPPFLAGS="-I/opt/local/include/ -L/opt/local/lib/" LDFLAGS=-L/opt/local/lib/
</pre></code>

Make sure you have support for png, jpg, dds, and tga

Build it with:
<code><pre>
make
</pre></code>

Part way through you'll get an error about ''malloc.h'' not being found. To fix it, replace ''<malloc.h>'' with ''<sys/malloc.h>''

install with:
<code><pre>
sudo make install
</pre></code>

==OpenAL==

After having mountains of problems myself with the OpenAL pre-installed with the Xcode tools, I discovered that it is version 1.0 of OpenAL (not the correct version we want).

Head to your ''/System/Library/Framework/'' folder and delete any trace of OpenAL framework / folders that are there.

[http://kcat.strangesoft.net/openal-releases/openal-soft-1.8.466.tar.bz2 Now download this copy of OpenAL]

Using the terminal, go into the folder where you downloaded openal-soft and pass these commands:

<code><pre>
bzip2 -d openal-soft-xxxx.tar.bz2 | tar xvf -
cd openal-soft-xxxx
cmake .
make
make install
</pre></code>

All done, now you will have no problems compiling the ''Sound.cpp'' file in spring!

=Build And Install=

The build will spew out warnings like the following, which you can safely ignore:<br>
warning: division by zero<br>
warning: 'q' may be used uninitialized in this function<br>

==Removing duplicate libraries==

Make sure that you remove all extra libraries before the first time you call ''cmake''. If not, ''cmake'' will make your life a living hell. Check in ''/usr'', ''/usr/local'', ''/opt/local'' and ''/Library/Frameworks''. Also, do not change the location of the source directory, librarys, or includes after calling ''cmake''. If you do change any of the locations you can not just call ''cmake'' again. The only way I know to tell it to recompute everything from scratch is this:

* Change to the root of the source tree
* Remove every single visible file (NOT the ''.git/'' dir)
* Run <code>git reset --hard</code>

==Using CMake (2.6 or newer) (Adso's method)==
This is the only way I have compiled spring successfully so far:

(could someone please add a better way? As I cannot workout how to get xcodebuild to run the "install portion of the make file")

<code><pre>cmake .
make spring
make install-spring</pre></code>

This will install spring in all the right places to be run from a command line (but don't yet, it compiles an unusable executable, we just needed to get the makefile to install everything to the right place)

Now pass these commands

<code><pre>cmake -G Xcode
xcodebuild</pre></code>

This will have made a folder called "Debug" and will contain a command line program Spring, and ''Libunitsync.dylib''

now to make sure the correct copy of spring runs when you are using the terminal pass the following command

<code><pre>sudo cp spring /usr/local/bin</pre></code>

Now you are ready to ready to play Spring on your MacOSX system!
Enjoy!

==Using CMake (2.6 or newer) (patmo98's method)==
The worst problem I ran into while trying to use Adso's method was getting the include and library paths to work.
'''This probably won't be needed unless you you been installing libraries from source or using fink.'''

Make sure before you start that you don't have any extra copies of libraries laying around.

Get the dependencies and source code.

<code><pre>ccmake .
</pre></code>

If you see a list of options here, you've already run (''c'')''cmake'' before and that may cause you trouble. Press ''c'' to have it auto configure. Press ''t'' to switch to advanced mode. Manually add the following includes and librarys. Yes, this is an ugly hack that should be instead fixed in the build system, but I don't know enough about ''cmake'' to fix it.

<code><pre>
CMAKE_CXX_FLAGS -I/usr/local/include -I/opt/local/include
CMAKE_C_FLAGS -I/usr/local/include -I/opt/local/include
CMAKE_EXE_LINKER_FLAGS -L/usr/local/lib -L/opt/local/lib
</pre></code>

You may need to add more directories.

Now you can compile:
<code><pre>make spring
</pre></code>

If the build finishes successfully, you will now have the ''spring'' executable, ''unitsync.dylib'', and some other assorted things.

Spring will search for ''Libunitsync.dylib'' in the same directory as the executable (and possibly other places), and search for the data files in ''~/.spring/''.
If you have access to a working windows install, just copy the windows install to ''~/.spring/'' and run the executable from where ever you like.

Now you are ready to play Spring on your Mac OS X system!
Enjoy!

=Finalizing installation=

Will update later once I update the Springlobby wiki with all my OSX information!

If you need to contact me, send a PM to '''adso''' on the forums, or catch me in #sy or #springlobby in the lobby chat :)

--[[User:Adso|Adso]] 06:23, 29 August 2009 (UTC)

[[Category:Compiling]]

Spring on MacOSX

2010-10-21T13:07:22Z

Daftalx: Migrated the forum tutorial to this page (old page kept as archive)

Last page update: 2010/10/21 by daftalx (migrated the tutorial from the forum)

Current milestones available:
* Spring: 0.81.2.1
* SpringLobby: 0.95
* QtLobby: 1.0 alpha rev. 597

=Preamble=

This tutorial is intended for Mac OS X Snow Leopard (10.6.*) users running in 32bit kernel mode. Although Spring compiles and runs in 64 bits, '''it does not work in 64bit kernel mode''' (thanks to ''frequencyandsulphur'' for digging this one out).

This tutorial has not been tested on older releases of Mac OS X (10.5-). Yet, there are big chances that you can get through and still be able to run Spring. Keep in mind though that due to architecture incompatibilities, Intel-powered macs will be able to discuss online together, as well as with PCs, but not with PPC-powered Macs.

Finally, please bear in mind that this tutorial is mostly for testing purposes and proof of concept. Although no manual compilation is required, using the Terminal application is necessary (for now). Due to the little amount of time people are dedicating to the Mac version of Spring, things will move only slowly and often behind the other platforms. Once things get stabilized, an all-in-one installer will (hopefully one day) replace this tutorial.

Good luck, and have fun !

=Basics=

==Install the XCode tools==

These are available on your Mac OS X install DVD, the installer is called "XCode Tools" in the "Optional installs" folder.

==Install MacPorts==

*If you never had MacPorts installed, the latest version is available as a ".dmg" installer on [http://www.macports.org/install.php this page]
*If you already have MacPorts, make sure you run the latest version with

sudo port selfupdate

and upgrade your ports with

sudo port upgrade outdated

==Configure MacPorts==

Spring and it's lobbies are published in a different repository than MacPorts's official one. So you must edit (as root) the MacPorts sources file (located by default in /opt/local/etc/macports/sources.conf), and add the following line before the last one:

rsync://daftserver.game-host.org/macports/

==Sync MacPorts regularly==

To sync your MacPorts install with the latest repositories hit

sudo port sync

Note that you should hit this command again everytime a Portfile is added and/or updated. To give you a hint on whether you should sync or not, here is a quick changelog of the repository:
*2010/10/21 14:31 PM: libtorrent-rasterbar: Port update (ver. 0.15.4)
*2010/08/16 12:07 PM: springlobby: Port release (ver. 0.95)
*2010/08/06 01:37 PM: qtlobby: Port release (ver. 1.0alpha)
*2010/08/03 02:35 PM: wxWidgets: Fixed shared library linking
*2010/07/30 11:26 PM: springlobby-devel: Port release (fetches latest git)
*2010/07/25 01:22 AM: wxWidgets: Port release (ver. 2.9.1)
*2010/07/09 01:02 AM: spring: Removed unnecessary Python 2.5 dependency
*2010/07/07 01:05 AM: spring: Port release (ver. 0.8.2.1)

From now on I assume your Portfiles will always be up-to-date, therefore I will get straight to the point during the remainder of this tutorial.

=Spring=

==Install spring==

Crazy as it may seem, installing spring now comes down to this command:

sudo port install springrts

WARNING: this will take a *long* while, especially on a fresh system (ballpark figure: over an hour with an Intel C2D 2.2GHz cpu).

==Setup game data==

create a ".spring" folder in your home directory, and create the usual "mods", "maps" and "demos" folder. There you can store your favorite game data (most of the content is cross-platform compatible).

==Check if Spring works==

spring

should launch the standalone GUI in window mode, which allows offline gaming, e.g. if you have demo scripts or single player mods (my favorite these days is Chicken BA).

=Lobbies=

==SpringLobby==

Although the Mac OS port of SpringLobby should be considered "barely alpha"-stage, quite a lot of features are already functional, so you should be able to play online with patience and little effort.

===Install SpringLobby===

SpringLobby currently relies on the boost library in debug mode. To install or upgrade boost with debug option on hit

sudo port install boost +debug

then proceed to SpringLobby with

sudo port install springlobby

In the end you should get two "double-clickable" .app bundles (springlobby and springsettings) in MacPorts's binary folder (/opt/local/bin by default).

===Setup SpringLobby===

Upon first run, you'll have to tell SpringLobby where to find the spring executable and unitsync library manually. The spring executable is in "/opt/local/bin/spring" and the unitsync library in "/opt/local/lib/libunitsync.dylib".

As mentioned earlier the lobby is in a very early port stage. One major feature that does *NOT* work yet is to join (or autojoin) an IRC channel (but you may chat inside a battleroom). So before connecting to the main server, open the "Autojoin channels" options window and remove all default channels.

That's it, connect and enjoy
NOTE: SpringLobby will mostly crash upon startup (much less afterwards). Don't worry, just keep trying until you get through... or try QtLobby (see below)...

===Known bugs===

*Join a chat channel (the /join command stalls the app)
*Add bot in a game (hitting the "Add bot" button stalls the app)
*Loading replays (they appear in the list but wouldn't run)

==QtLobby==

Although QtLobby is now an unmaintained project, it had acquired the reputation of being a both fast and stable alternative to TASclient and SpringLobby. Here is how it compares to the Mac port of SpringLobby:
*Interface is faster and more responsive
*Great IRC chat management
*Bots & Replays not supported (at all)

Again, installing is as simple as

sudo port install qtlobby

and launching is as simple as hitting

qtlobby

As for SpringLobby, upon first run you will have to point to spring executable, unitsync library and data folder manually.

=Troubleshooting=

In case you encounter compile or install errors on the way, MacPorts will let you know that a log file has been stored somewhere like /opt/local/var/macports/logs/??/main.log, where the "??" describes the port you are installing. Paste the contents of this file into a paste bin (http://www.pastebin.ca) and post the shortlink to the pastebin in [http://springrts.com/phpbb/viewtopic.php?f=65&t=23455 this topic], together will your full system info (OS, CPU, ARCH, MacPorts version).

That's it ! Enjoy !