Compiling wxWidgets 2.4.2 to develop Code::Blocks (MSW)

From CodeBlocks
Revision as of 10:10, 26 May 2005 by Mispunt (Talk | contribs) (Set up MSYS)

Jump to: navigation, search

These are the instructions to Install and compile wxWidgets 2.4.2 so you can later compile Code::Blocks on your own.

NOTE: The instructions are MS Windows (TM) specific, but some could be applied to other platforms as well

NOTE: This article is under construction. More info can be found in the forums.

Install MinGW

If you don't have the Code::Blocks+MinGW bundle, grab the latest MINGW stuff (including MSYS) from the MINGW site and install it under a directory you like. In this tutorial we're assumming you're installing MINGW under C:\MINGW.

If you DO have the Code::Blocks + MinGW bundle, or have already installed MINGW on your own, you can skip this section.

NOTE: The files are compressed in the tar.gz format. You need a third-party extraction utility to unzip them.

The files I (Rick) have installed are:

After you install, make sure you have the following directories under your path:

  • C:\MINGW\bin;
  • C:\MINGW\mingw32\bin;

(I'm assumming you installed under C:\MINGW)

Set up MSYS

NOTE: MSYS is not actually required for the following procedure to work. Just replace /c/ with c: and it works without MSYS ;) and make sure you have the extra.zip

The MSYS package (NOT included in the Code::Blocks+MinGW bundle) allows you to run unix scripts with Mingw. Think of it as a "mini-linux emulator". When you run the executable installer, it will provide a link to msys.bat. If it doesn't appear in your desktop, search for it in your programs menu.

The wxWidgets 2.4.2 compilation must be run from inside MSYS. Drive C is found under /c/, drive D under /d/ and so on.

Download and Install the wxWidgets source code

The wxWidgets 2.4.2 distribution can be found at the wxWidgets site. (Note that there's also a winhelp file available). You can choose to install either the setup version or the plain zip version (which I find ridiculous, because the setup version is zipped too!).

If you use the plain zip version, make sure to unzip using the full path. Otherwise the directories won't be created correctly. On a second thought, you might like to use the setup version :P

I have my wxWidgets installed in C:\wxWindows-2.4.2 . Under MSYS, that should be /c/wxWindows-2.4.2 .

And now that you have all the ingredients, it's time to compile :)

Build wxWidgets

NOTE: We're assumming you installed under C:\wxWindows-2.4.2 .

Before anything, let me warn you: wxWidgets compilation is SLOW. And by SLOW I mean the time equivalent to one or two evolution cycles, like from Triasic to Jurasic, but doubled. So make sure there's a nice show on the TV, or you could invite a friend to play cards. OR you could start preparing the coffee :)

Now, open up your MSYS prompt, and change to the wxWidgets src/msw directory:

cd /c/wxWindows-2.4.2/src/msw

Then proceed to the build. But first, an important warning that will save you many headaches.


WARNING!
If due to a misconfiguration (like changing the version of your MINGW), your compilation fails, MAKE SURE you clean out the outputs directory with the following command:
mingw32-make -f makefile.g95 clean
(do it for wxwidgets, stc and xrc. I had weird linker errors and crashes because I didn't clean up the partial compilations).


And now that everything's clean, proceed to the build:

mingw32-make -f makefile.g95 FINAL=1 UNICODE=0 WXMAKINGDLL=1

If no "mingw32-make" is found, try this:

make -f makefile.g95 FINAL=1 UNICODE=0 WXMAKINGDLL=1

Is it compiling OK? Good! You can now enjoy your coffee :-)

Build the STC library

Still inside MSYS, type:

cd ../../contrib/src/stc

That should change the directory to /c/wxWindows-2.4.2/contrib/src/stc. Now type:

mingw32-make -f makefile.g95 FINAL=1 UNICODE=0 WXUSINGDLL=1

(NOTE: There are NO line breaks in the command, if you see them, they're shown for readability)

Build the XRC library

Still inside MSYS, type:

cd ../xrc

That should change the directory to /c/wxWindows-2.4.2/contrib/src/xrc. Now type:

mingw32-make -f makefile.g95 FINAL=1 UNICODE=0 WXUSINGDLL=1

And that's it! Now you only have to copy the lib and include directories so your MINGW installation can find them.

Copy the files to your mingw directory or set up the paths

This section provides you with two alternatives: The easy one, and the hard one. The easy one consists of just copying the files to your MINGW directory. The hard one consists of setting up the paths in codeblocks.

Option 1: Copying the wxWidgets files over your MINGW installation

NOTE: The following instructions will overwrite part of your MINGW installation. If you're planning to build unicode applications, or use another version of wxWidgets, DO NOT, repeat, DO NOT follow these! Instead you'll have to set up the paths manually.

So, here's how to copy the files. I (Rick) guarantee this option works, since it's the one I used.

Close your MSYS window, and now open your windows explorer (NOT internet explorer, but Windows explorer. To open it, just press "(Windows key)+E"

It's recommended to open TWO explorer windows: One for your wxWidgets directory (which we'll change to copy different files), and another to

Copying the header files

In the location bar, select the following path:

C:\wxWindows-2.4.2\include

Select all the files AND DIRECTORIES and copy. Change to the directory "include" under your MINGW main directory, and paste.

Now change again the directory to:

<C:\wxWindows-2.4.2\contrib\include

Copy all files and directories, and paste them to your MINGW include directory.

Copying the library files

Change the explorer directory to:

C:\wxWindows-2.4.2\lib

And select all the files. Copy and Paste under your MINGW "lib" directory.

Copying the setup.h file

This one's very important! Normally people know to copy the headers and libs, but miss this step. If you miss it, you'll get LOTS of compilation errors.

Change the explorer directory to:

C:\wxWindows-2.4.2\lib

There is a "mswdll" directory there. Under it, there's a "wx" subdirectory, too. Inside it there's a "setup.h".

Copy it, and paste under your MINGW include/wx directory.

(END of option 1)

Option 2: Setting up the paths manually

These instructions are to be followed by those who plan to use the 2.6 version of wxWidgets, or want to build their own version (i.e. with unicode support). Since you can't use both 2.4.2 and 2.6 libraries at the same time, you have to keep them in separate directories.

(Under construction - Somebody who has done this step, please edit)


And that's it. Now you're ready to compile Code::Blocks!