Difference between revisions of "Mac OS X"

From Armagetron
(First draft)
 
 
(13 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This page will help you get up and running to hack [[Armagetron]] on [[Mac OS X]]
+
This page will help you get up and running to hack Armagetron on Mac OS X.
''I'm writing this as I go along so it is not yet complete!''
+
 
 +
Note: This is the old way. The new way is over at [[macOS]].
  
 
= Prerequisites =
 
= Prerequisites =
  
 
== Xcode ==
 
== Xcode ==
You'll need Apple's [http://developer.apple.com/tools/xcodeXcode], this guide was written for version 3.1. Xcode bundles important stuff for developping like gcc and stuff...
+
You'll need Apple's [http://developer.apple.com/tools/xcode Xcode] ≥ 2.4.  
 +
 
 +
== Libraries and dependancies ==
 +
 
 +
All the external libraries you'll need are on the [http://sourceforge.net/project/showfiles.php?group_id=110997&package_id=266788 SourceForge.net armagetronad project page].
 +
 
 +
Extract the archive and copy the ArmagetronAdvanced to <pre>/Library/Frameworks/ArmagetronAdvanced</pre> as stated in the <tt>README.txt</tt> file.
  
 
== MacPorts ==
 
== MacPorts ==
[http://www.macports.org/ MacPorts] may also come in handy for installing external libraries and stuff... who knows?
+
[http://www.macports.org MacPorts] comes in handy for installing software, like Bazaar. It is optional, but it reduces the maintance of keeping your installed software up-to-date.
  
== Libraries and dependancies ==
+
= Getting the Source =
 +
 
 +
The armagetronad source code is available from two sources: subversion and bazaar. Bazaar offers more features for developers wanting to work on and improve the game.
 +
 
 +
== [[Working with SVN | Subversion]] ==
 +
 
 +
If you are running Mac OS X 10.5, you already have subversion. If you are running an older version of Mac OS X, install svn with macports, using the command <code>sudo port install subversion</code>.
 +
 
 +
To get the unstable trunk branch:
 +
<pre>svn co https://armagetronad.svn.sourceforge.net/svnroot/armagetronad/armagetronad/trunk/armagetronad</pre>
  
I guess you need stuff like
+
To get the stable 0.2.8 branch:
* Boost
+
<pre>svn co https://armagetronad.svn.sourceforge.net/svnroot/armagetronad/armagetronad/branches/0.2.8/armagetronad</pre>
* OpenGL
 
* SDL
 
to build the project (I wouldn't know, I've havn't gone that far yet)
 
  
= Getting into it =
+
Check out [[Working with SVN]] for more information.
  
== Checking out a working copy ==
+
== [[Bazaar]] ==
I don't know sh*t about [[ Bazaar]] and [http://www.urbandictionary.com/define.php?term=cba CBA] to either... so I use SVN like everybody else.
 
You can check out the stable branch ''a la mano'' like so:
 
<pre>
 
svn co svn co https://svn.sourceforge.net/svnroot/armagetronad/armagetronad/trunk/armagetronad
 
</pre>
 
  
However, I recommend using Xcode's SCM repository manager ('''SCM''' -> '''Configure SCM Repositories...''' to set it up) because oh-my-god it's so damn HAWT!!
+
[http://bazaar-vcs.org Bazaar] can be installed by using the command <code>sudo port install bzr</code>. If you did not install Macports, you can download an install dmg from the [http://bazaar-vcs.org Bazaar website].
Then just browse and check out the same folder as above.
 
  
Check out [[working with SVN]] for more "information".
+
To get the unstable trunk branch:
 +
<pre>bzr branch lp:armagetronad</pre>
  
== Creating the project ==
+
To get the stable 0.2.8 branch:
 +
<pre>bzr branch lp:armagetronad/0.2.8</pre>
  
To open the project in Xcode, easy as pie : just open the '''Armagetron Advanced.xcodeproj''' in the '''MacOS''' folder where you checked out.
+
Check out [[Bazaar]] for more information.
  
 
== Building ==
 
== Building ==
  
Click the '''Build''' button ! Easy !
+
Open the <code>MacOS/Armagetron Advanced.xcodeproj</code> and build.
Now then... 6532 errors and 2warnings...
+
 
Hmmm....
+
[[Category:Installation]]

Latest revision as of 17:18, 23 August 2021

This page will help you get up and running to hack Armagetron on Mac OS X.

Note: This is the old way. The new way is over at macOS.

Prerequisites

Xcode

You'll need Apple's Xcode ≥ 2.4.

Libraries and dependancies

All the external libraries you'll need are on the SourceForge.net armagetronad project page.

Extract the archive and copy the ArmagetronAdvanced to

/Library/Frameworks/ArmagetronAdvanced

as stated in the README.txt file.

MacPorts

MacPorts comes in handy for installing software, like Bazaar. It is optional, but it reduces the maintance of keeping your installed software up-to-date.

Getting the Source

The armagetronad source code is available from two sources: subversion and bazaar. Bazaar offers more features for developers wanting to work on and improve the game.

Subversion

If you are running Mac OS X 10.5, you already have subversion. If you are running an older version of Mac OS X, install svn with macports, using the command sudo port install subversion.

To get the unstable trunk branch:

svn co https://armagetronad.svn.sourceforge.net/svnroot/armagetronad/armagetronad/trunk/armagetronad

To get the stable 0.2.8 branch:

svn co https://armagetronad.svn.sourceforge.net/svnroot/armagetronad/armagetronad/branches/0.2.8/armagetronad

Check out Working with SVN for more information.

Bazaar

Bazaar can be installed by using the command sudo port install bzr. If you did not install Macports, you can download an install dmg from the Bazaar website.

To get the unstable trunk branch:

bzr branch lp:armagetronad

To get the stable 0.2.8 branch:

bzr branch lp:armagetronad/0.2.8

Check out Bazaar for more information.

Building

Open the MacOS/Armagetron Advanced.xcodeproj and build.