Compiling WiiFlow

Note: This is for the new GitHub.  For the old Google Code SVN go here.

You will need:

• • devkitPPC r26/r27

  • Libogc (the correct version, see below)

  • TortoiseGit

  • Source Code

DevkitPPC & Libogc

First Install devkitPPC.  This guide describes setting up such a system under Windows.  A guide for Mac OS X 10.5.x users can be found here and a guide for Linux here.

• • Download the latest devkitProUpdater.  Note:  If you need a older version - click on file and choose Automated installer to get a list of older versions.

  • Let it install to C:\devkitPro\ to make it easier to follow the tutorial for now.

  • When installing it, you can deselect devkitARM and devkitPSP.

  • Click next until it finishes installing.

IMPORTANT! You must use the correct version of Libogc.

For beta revisions r1073 and below use libogc 1.8.10).  Get it here.

For beta revisions r1074 thru 1076 use libogc 1.8.11.  Get it here.

Create a folder named libogc in your C:\devkitpro\ folder and extract it to there. 

If you have more than one libogc for various compiling I recommend keeping the zipped libogc's in C:\devkitpro\ and rename them to include the version number.  Then when you need to change libogc just delete the contents of C:\devkitpro\libogc\ and extract the correct libogc into that folder.

TortoiseGit

Next you will need to get an Git management application.  The most commonly recommended Git management application for Windows is TortoiseGit.

Go to the TortoiseGit site and download the version for your system whether it be 32bit or 64bit and install it with default options.

(There are translations lower down on the page in many languages.)

A command line git.exe is required by TortoiseGit.  Git for Windows 2.0+ is recommended.  You must download and install it too for TortoiseGit to work correctly.

Installation of Git for Windows can be done with preselected options, however, no need to install the "Windows explorer integration".  So deselect that option and leave everything else alone when installing.

Source Code

Next you will need to get the WiiFlow source code.

Create a folder in the base of a drive where you want to store your source code at and name it wiiflow.

(it can be in something like c:\Sources\wiiflow, but make sure your path has no spaces in it or it wont compile!)

From here on we will assume it is c:/wiiflow/

Now you need to Git Clone (download) the code.

Right click on this newly created folder ( c:/wiiflow ) and select "Git Clone...".

In the window that pops up you will want to enter:

URL of Repository: https://github.com/FIX94/open-wiiflow-mod.git

and click OK.

You have now successfully Git Cloned  the latest source for WiiFlow!

But for some reason you will need to create a folder named 'bins' in the 'out' folder.  For some reason it's missing.  You need it for compiling.

To Checkout a Older Revision:

Git Clone the code like normal (per above).

Right click actual Git folder (open-wiiflow-mod).  Select TortoiseGit>Show Log.

Now you will see a list of all the commits at the top.  Scroll down to find the one you want and right click on it.

Select "Switch/Checkout to this..." and click OK in the window that opens.

Compiling

After properly installing DevkitPPC and checking out the source with TortoiseGit, open the folder you downloaded your source into and double click "wiiflow.pnproj"

This will open a program called Programmer's Notepad, which optionally you could use as a C/C++ editor if you wish, but the main focus here is to compile.

All you need to do to compile from here is Click Tools>make or press Alt+1

Pay attention to the little window in the bottom, you should see some activity there, if the second to last line is "> Process Exit Code: 0"  Then you have compiled successfully.

You will find a boot.dol in your wiiflow directory now.  Copy it to your apps/wiiflow folder and you're good to go.

Updating & More

Now, when a new update is available to the source, or when you are about to compile and you are unsure if you have the latest changes, all you need to do is right click it and select "TortoiseGit>Pull" and it will update you to the latest source!

Whenever you are about to compile WiiFlow, you should always right click the folder you checked wiiflow into and select "TortoiseGit>Pull"

TortoiseGit will also visually mark files that have been modified, added, excluded, or are out of date.

If your main source folder has a red circle with an exclamation point in it (!) then something is not in sync with the Git.

To remedy this try an Pull, and then refresh the folder containing your checked out version.  

If you still have a red circle, it means you have modified a file.  Unless you are trying to develop something in WiiFlow, find the file that is marked that way and delete it, and then do an Pull before compiling.