24
edits
Difference between revisions of "Compiling ScummVM/Wii"
Documented the new ./configure support.
(new git URLs) |
(Documented the new ./configure support.) |
||
| Line 26: | Line 26: | ||
* v0.12.0 (first official version) is built with devkitPPC r15 | * v0.12.0 (first official version) is built with devkitPPC r15 | ||
* | * starting with v0.13.0, devkitPPC r16 is used | ||
= Optional libraries = | = Optional libraries = | ||
| Line 151: | Line 151: | ||
= Compiling = | = Compiling = | ||
This port doesn't utilize ScummVM's <tt>configure</tt> system, instead it comes with a simple Makefile. The port code can be found in two directories: | == v0.13.0 and above == | ||
Starting with v0.13.0, the Wii and Gamecube port can be compiled with the <tt>configure</tt> script. The most basic way to accomplish this is to run: | |||
./configure --host=wii | |||
make | |||
If you want to build a Gamecube binary, just use | |||
./configure --host=gamecube | |||
make | |||
instead. | |||
The script supports various arguments, which you can use to toggle various features, see <tt>./configure --help</tt>. | |||
Two of the [[#Optional libraries|optional libraries]] are already part of libogc: | |||
* zlib, used to (de-)compress save games. It gets automatically detected with a recent libogc version. | |||
* libmad, used for MP3 playback. It gets automatically detected with a recent libogc version. | |||
Others are not, and if you want support for it, you need cross-compiled binaries: | |||
* libFLAC, used for FLAC lossless audio playback. Use the ''--with-flac-prefix=<directory>'' argument. | |||
* Tremor, used for OGG audio playback. Use the ''--with-tremor-prefix=<directory>'' argument. | |||
If you followed the [[#Optional libraries|above description]] and have those libraries in <tt>$DEVKITPRO/3rd/wii</tt>, the <tt>configure</tt> command line would look like this: | |||
./configure --host=wii --with-flac-prefix=$DEVKITPRO/3rd/wii --with-tremor-prefix=$DEVKITPRO/3rd/wii | |||
Additionally, there're a few make targets for convenience: | |||
* <tt>make wiiload</tt> - uploads a compiled Wii binary over TCP. | |||
* <tt>make geckoupload</tt> - uploads a compiled binary over a USBGecko device. | |||
* <tt>make wiidist</tt> - copies all required files for the Wii into the ''dist'' subdirectory, read to copy onto your SD card for the Homebrew Channel. | |||
* <tt>make gcdist</tt> - same for Gamecube. | |||
* <tt>make wiigdb</tt> - starts GDB and loads your compiled binary, ready to debug. | |||
* <tt>make wiidebug</tt> - starts GDB with your binary and attaches remotely to the Wii via a USBGecko device. | |||
== v0.12.0 == | |||
This port doesn't utilize ScummVM's <tt>configure</tt> system for v0.12.0, instead it comes with a simple Makefile. The port code can be found in two directories: | |||
./backends/fs/wii/ | ./backends/fs/wii/ | ||