Difference between revisions of "Building ioquake3 on Windows - cygwin"
(Added section) |
ZTurtleMan (talk | contribs) (Replaced entire page based on MAN-AT-ARMS's guide.) |
||
| Line 1: | Line 1: | ||
| − | + | __NOTOC__ | |
| + | Return to [[Building ioquake3]] | ||
| − | + | = Windows - cygwin = | |
| − | + | How to compile ioquake3 using MinGW in a Cygwin environment. | |
| − | + | ||
| − | < | + | ''NOTE: These instructions apply to the git version.'' |
| − | + | # Install Cygwin and required packages (see guide below). | |
| − | + | # Check out the source from git://github.com/ioquake/ioq3.git with <code>git clone git://github.com/ioquake/ioq3.git</code> | |
| − | + | # Change to the ioq3 directory | |
| − | + | # Run <code>[http://www.gnu.org/software/make/ make]</code> | |
| − | + | ||
| − | + | == Detailed Guide == | |
| − | < | + | Detailed guide based on a [http://community.ioquake.org/t/how-to-build-ioquake3-using-cygwin/223 post by MAN-AT-ARMS]. |
| − | + | ||
| − | + | === 1. Install Cygwin === | |
| − | + | Download the Cygwin setup package from http://cygwin.com/install.html. | |
| − | + | ||
| − | + | Choose either the 32-bit or 64-bit environment. 32-bit will work fine on both 32 and 64 bit versions of Windows. The setup program is also your Cygwin environment updater. If you have an existing Cygwin environment, the setup program will, by default, update your existing packages. | |
| − | + | ||
| − | In the | + | * Choose where you want to install Cygwin. The entire environment is self-contained in it's own folder, but you can also interact with files from outside the environment if you want to as well. The default install path is <code>C:\Cygwin</code>. |
| − | + | * Choose a mirror to download packages from, such as the kernel.org mirrors. | |
| − | + | * Choose a "storage area" for your package downloads. | |
| − | + | ||
| − | + | === 2. Package selection === | |
| − | + | The next screen you see will be the package selections screen. In the upper left is a search box. This is where you will want to search for the necessary packages. | |
| − | + | ||
| − | + | These are the package names you'll want to search for: | |
| − | + | ||
| − | + | # mingw64-i686-gcc-core (For building 32bit binaries) | |
| − | + | # mingw64-i686-gcc-g++ (Also for 32bit... C++ support... not required for ioquake3, but useful for compiling other software) | |
| − | + | # mingw64-x86_64-gcc-core (For building 64bit binaries) | |
| − | + | # mingw64-x86_64-gcc-g++ (For 64bit, same as above) | |
| − | + | # make | |
| − | + | # bison | |
| − | + | # git | |
| − | + | ||
| − | + | When you search for your packages you'll see category listings. These packages would all be under the 'Devel' category. | |
| − | + | ||
| − | + | To select a package, change the 'Skip' to the version of the package you want to install. The first click will be the newest version and subsequent clicks will allow you to choose older versions of the package. In our case here, you're probably good choosing the latest and greatest. | |
| − | + | ||
| − | + | === 3. Install packages === | |
| − | + | After you have selected your packages, just hit 'Next' in the lower right. Cygwin will automatically add package dependencies. Hit next again to let the install run. Done. | |
| − | + | ||
| − | + | The entire environment uses about 1GB of disk space (as opposed to about 6GB for a Visual Studio install). | |
| − | + | ||
| − | + | === 4. Using Cygwin to check out and build ioquake3 === | |
| − | + | After the install has completed you should have a 'Cygwin Terminal' icon on your Desktop. This is the bash shell for Cygwin, so go ahead and run it. | |
| − | + | ||
| − | + | At the command prompt type: | |
| − | + | <code>git clone git://github.com/ioquake/ioq3.git</code> | |
| − | + | ||
| − | + | This will download the ioquake3 master branch source into a new ioq3 folder. | |
| − | + | ||
| − | + | Change to the new ioq3 folder that was created: <code>cd ioq3</code> | |
| − | + | ||
| − | + | You can build ioquake3 for 32 or 64 bit Windows by running one of the following | |
| − | + | * <code>make ARCH=x86</code> (32 bit) | |
| − | < | + | * <code>make ARCH=x86_64</code> (64 bit) |
| − | + | ||
| − | + | After the build completes the output files will be in the 'build' folder. For the default Cygwin install the path it would be C:\Cygwin\home\Your_Username\ioq3\build\release-mingw32-arch. | |
| − | < | + | |
| − | + | === 5. Have fun! === | |
| − | |||
| − | . | ||
| − | |||
Revision as of 23:13, 29 September 2015
Return to Building ioquake3
Windows - cygwin
How to compile ioquake3 using MinGW in a Cygwin environment.
NOTE: These instructions apply to the git version.
- Install Cygwin and required packages (see guide below).
- Check out the source from git://github.com/ioquake/ioq3.git with
git clone git://github.com/ioquake/ioq3.git - Change to the ioq3 directory
- Run
make
Detailed Guide
Detailed guide based on a post by MAN-AT-ARMS.
1. Install Cygwin
Download the Cygwin setup package from http://cygwin.com/install.html.
Choose either the 32-bit or 64-bit environment. 32-bit will work fine on both 32 and 64 bit versions of Windows. The setup program is also your Cygwin environment updater. If you have an existing Cygwin environment, the setup program will, by default, update your existing packages.
- Choose where you want to install Cygwin. The entire environment is self-contained in it's own folder, but you can also interact with files from outside the environment if you want to as well. The default install path is
C:\Cygwin. - Choose a mirror to download packages from, such as the kernel.org mirrors.
- Choose a "storage area" for your package downloads.
2. Package selection
The next screen you see will be the package selections screen. In the upper left is a search box. This is where you will want to search for the necessary packages.
These are the package names you'll want to search for:
- mingw64-i686-gcc-core (For building 32bit binaries)
- mingw64-i686-gcc-g++ (Also for 32bit... C++ support... not required for ioquake3, but useful for compiling other software)
- mingw64-x86_64-gcc-core (For building 64bit binaries)
- mingw64-x86_64-gcc-g++ (For 64bit, same as above)
- make
- bison
- git
When you search for your packages you'll see category listings. These packages would all be under the 'Devel' category.
To select a package, change the 'Skip' to the version of the package you want to install. The first click will be the newest version and subsequent clicks will allow you to choose older versions of the package. In our case here, you're probably good choosing the latest and greatest.
3. Install packages
After you have selected your packages, just hit 'Next' in the lower right. Cygwin will automatically add package dependencies. Hit next again to let the install run. Done.
The entire environment uses about 1GB of disk space (as opposed to about 6GB for a Visual Studio install).
4. Using Cygwin to check out and build ioquake3
After the install has completed you should have a 'Cygwin Terminal' icon on your Desktop. This is the bash shell for Cygwin, so go ahead and run it.
At the command prompt type:
git clone git://github.com/ioquake/ioq3.git
This will download the ioquake3 master branch source into a new ioq3 folder.
Change to the new ioq3 folder that was created: cd ioq3
You can build ioquake3 for 32 or 64 bit Windows by running one of the following
-
make ARCH=x86(32 bit) -
make ARCH=x86_64(64 bit)
After the build completes the output files will be in the 'build' folder. For the default Cygwin install the path it would be C:\Cygwin\home\Your_Username\ioq3\build\release-mingw32-arch.
