Italiano - English

WxWindows con Code::Blocks QuickRef

Questo documento è una bozza

Questa pagina è la traduzione NON UFFICIALE in italiano della pagina WxWindowsQuickRef: A beginner's quick reference for setting up wxWidgets with Code::Blocks in Windows http://wiki.codeblocks.org/index.php?title=WxWindowsQuickRef e descrive come compilare e usare wxWidgets con Code::Blocks

Requisiti

  • La versione recente di Code::Blocks - E' necessario aver installato e che sia funzionante una versione recente di Code::Blocks -- La versione the 10.05 oppure una nightly build recente.
  • La Path di sistema definita correttamente.
    • Assicurati che la cartella che contiene gli eseguibili del compilatore (tipicamente C:\Programmi\CodeBlocks\bin) è indicato nella tua Variabile d'ambiente PATH.
    • Per modificare il valore della variabile d'ambiente PATH nel modo seguente
      • click con tasto destro su "Risorse del Computer",
      • Selezionare "Proprietà",
      • click "Avanzate",
      • click sul pulsante "Variabili d'ambiente" in fondo alla finestra.
    • Per verificare che la variabile PATH sia impostata correttamente, aprire una finestra DOS e digitare mingw32-gcc.
      • Se si riceve una risposta del tipo "mingw32-gcc non è riconosciuto...." vuol dire che la PATH non  è impostata correttamente
      • Se si riceve una risposta del tipo "no input files" allora la PATH è Corretta
Microsoft Windows XP [Version 5.1.2600]
(C) Copyright 1985-2001 Microsoft Corp.
C:\>mingw32-gcc
mingw32-gcc: no input files
C:\>

Download wxWidgets

Puoi scegliere se scaricare i codici sorgenti di wxWidgets e compilarli da solo, oppure scaricare la versione precompilata "wxPack".

  • La versione con codici sorgenti di wxWidgets è un dowload molto piccolo, tuttavia la sua compilazione richiede diversi minuti.
  • wxPack è un download molto grande, ma non devi impiegare tempo per compilare e non devi preoccuparti di configurare le opzioni di compilazione.

Sorgenti di wxWidgets

La versione corrente raccomandata di wxWidgets da usare è la 2.8.10. Click here to download the wxWidgets 2.8.10 sources for Windows (wxMSW-2.8.10-Setup.exe; 12.2 MB). Puoi controllare sul sito the wxWidgets download page per verificare se esiste una versione stabile più recente. E' altamente raccomandato di installare i sorgenti in un percorso che non contiene spazi. Sono richiesti circa 300 MB di spazio disponibile per la compilazione

wxPack

wxPack makes the next step of building wxWidgets unnecessary. The current stable release of wxPack is v2.8.8.04, based on wxWidgets 2.8.8. Click here to download wxPack v2.8.8.04 (wxPack_v2.8.8.04.exe, 315.9 MB). You can check the wxPack download page to see if a newer stable version is available. It is highly recommended that you install wxPack in a path without spaces. You should choose a volume with at least 700 MB of free space for MSVC, or 2.2 GB of free space for MinGW/GCC.

Build wxWidgets

Questo step non è necessario se si usa wxPack

  • Open up a command prompt for building. If you are using MinGW/GCC, simply use the standard Windows command shell (open the Start menu, click "Run...", enter "cmd" and hit OK). If you are using MSVC, you should use the special command shell which sets up the correct environment variables for you. If you use a version of MSVC which required you to download the Platform SDK separately, ensure that whichever command environment you use includes the Platform SDK tools and paths as well as the standard compiler tools and paths.
  • Change to the wxWidgets build directory (where is the path you extracted the sources to; typically C:\wxWidgets-2.8.9):
cd \build\msw
  • Execute the build command. The recommended command to use for MinGW/GCC is:
mingw32-make -f makefile.gcc BUILD=release SHARED=1 MONOLITHIC=1 UNICODE=1
  • The recommended command to use for MSVC is:
nmake -f makefile.vc BUILD=release SHARED=1 MONOLITHIC=1 UNICODE=1
  • This step will generally take a long time; faster PCs may expect 30-minute build times, and slower PCs can take as much as several hours.
  • If using more recent versions of GCC, many warnings will occur during the build. This can slow the build process noticeably; you may want to redirect the warnings to a text file by appending "2>errlog.txt" to the build command, or supress them entirely by appending "2>nul".

See the section below titled "wxWidgets build options explained" for details on the meaning of the BUILD, SHARED, MONOLITHIC, and UNICODE options. These options are critically important, because they define the basic wxWidgets development environment you will be using. You must duplicate them exactly when running Code::Blocks' wxWidgets project wizard.

Create a wxWidgets project in Code::Blocks

  • On the Code::Blocks Start Page, select "Create a new project"; alternatively, open the File menu, highlight "New" and select "Project..."
  • Select "wxWidgets project"
  1. The first page is an introduction, which you can choose to skip in the future.
  2. Select which version of wxWidgets you will be using. If you followed the instructions above, you should select "wxWidgets 2.8.x".
  3. Set your project title and location.
  4. Enter author details if you wish (not required).
  5. Select options for automatic code and file generation.
  6. Select wxWidgets' location. It's highly recommended that you use a global variable for this: enter "$(#wx)" (without quotes). If you haven't already defined this global variable, the global variables dialog will appear; for the base path, select your wxWidgets installation location. You don't need to fill in the other paths.
  7. Select debug and/or release configurations for your project. The debug configuration at least is recommended.
  8. Choose your wxWidgets build options. These must match the options used when you built wxWidgets! If you followed the directions above, select all three of the options under "wxWidgets Library Settings". If you are using wxPack: wxPack includes each version, so you may select whichever options you prefer. The other settings on this page are not related to the wxWidgets build options; you may use them or not as you prefer. In order to avoid using a debug wxWidgets build (as recommended), you must select "Configure Advanced options" and then leave "Use __WXDEBUG__ and Debug wxWidgets lib" unchecked on the next page.
  9. Select additional libraries if required. You should not need to select any of these for normal usage.

Build and Run

Select "Build and run" (F9) to, well, build and run. If all goes well, your wxWidgets basic program should appear.

wxWidgets Build Options Explained

What do the BUILD, SHARED, MONOLITHIC, and UNICODE options mean?

BUILD

BUILD controls whether a debug version (BUILD=debug) or release version (BUILD=release) of wxWidgets itself is built. In the vast majority of cases you will only need a release version of wxWidgets, since you won't be interesting in debugging wxWidgets itself. You can still create debug builds of your own programs that link to a release build of wxWidgets.

  • A debug build of wxWidgets creates libraries with a "d" suffix -- for example, "libwxmsw28d.a"/"wxmsw28d_gcc_custom.dll".
  • A debug build of wxWidgets creates the folder "mswd" or "mswud" in the wxWidgets library output folder.
  • A release build of wxWidgets creates libraries without the "d" suffix -- for example, "libwxmsw28.a"/"wxmsw28_gcc_custom.dll".
  • A release build of wxWidgets creates the folder "msw" or "mswu" in the wxWidgets library output folder.

SHARED

SHARED controls whether a DLL (SHARED=1) or static (SHARED=0) version of wxWidgets is built. With a DLL build, compile times are faster and the executable size is smaller. The total size of a single executable plus the wxWidgets DLL is greater, but multiple executables can use the same DLL.

  • A DLL build of wxWidgets creates import libraries (such as libwxmsw28.a) and DLLs (such as wxmsw28_gcc_custom.dll). You must include the DLL when you distribute your program.
  • A static build of wxWidgets creates static libraries only (such as libwxmsw28.a), and you do not need to distribute a wxWidgets DLL.

MONOLITHIC

MONOLITHIC controls whether a single library (MONOLITHIC=1) or multiple component libraries (MONOLITHIC=0) are built. With a monolithic build, project setup and development are much easier, and you only have one DLL to distribute if you're using a DLL build. With a non-monolithic (multilib) build, several different libraries are built and you can avoid linking with the entire wxWidgets codebase for programs that don't need it. You do have to ensure that you choose the correct component libraries.

  • A monolithic build of wxWidgets creates a single wxWidgets import library (such as libwxmsw28.a) and a single DLL (such as wxmsw28_gcc_custom.dll).
  • A multilib build of wxWidgets creates multiple import libraries (libwx28_base.a, etc.) and multiple DLLs.
  • Additional static libraries are always created with any wxWidgets build (libwxexpat.a, libwxjpeg.a, etc.). These libraries do not normally need to be used with DLL builds of wxWidgets, but they are required when using static builds.

UNICODE

UNICODE controls whether wxWidgets and your program use wide-character strings with Unicode support. Most programs for Windows 2000 and later should do so. Earlier versions of Windows don't have the necessary Unicode support. You should always use wxWidget's _("string") and _T("string") macros to ensure that your hardcoded strings are the correct type.

  • A Unicode (UNICODE=1) build of wxWidgets creates libraries with a "u" suffix -- for example, "libwxmsw28u.a"/"wxmsw28u_gcc_custom.dll".
  • A Unicode build of wxWidgets creates the folder "mswu" or "mswud" in the wxWidgets library output folder.
  • An ANSI (UNICODE=0) build of wxWidgets creates libraries without the "u" suffix -- for example, "libwxmsw28.a"/"wxmsw28_gcc_custom.dll".
  • An ANSI build of wxWidgets creates the folder "msw" or "mswd" in the wxWidgets library output folder.

Frequently Asked Questions

I get errors like "wx/setup.h: No such file or directory"

You're missing an important compiler search path in your build options. Make sure you choose the correct wxWidgets build configuration when running the wxWidgets project wizard. If re-running the wizard isn't an option, then open your project's build options and add "$(#wx.lib)\gcc_dll\mswu" (assuming a monolithic Unicode DLL build) to the compiler search paths.

I get errors like "cannot find -lwxmsw28u"

You have an incorrect link library in your build options. Make sure you choose the correct wxWidgets build configuration when running the wxWidgets project wizard. If re-running the wizard isn't an option, determine which version of the library is built and adjust the library name in your build options accordingly.

I get errors like "undefined reference to _Unwind_*"

wxWidgets was built with a different version of GCC than the one you're currently using. You need to rebuild wxWidgets with the same version of GCC that you use to compile your program.

External Links

Newbie problem in setting up wxwidgets and Codeblocks

Vota questa pagina:

3 Commenti:

#1 Inviato da web promotion 31-12-2012

Congratulations on having one of the most sophisticated blogs I've came across in some time! Its just incredible how much you can take away from something simply because of how visually beautiful it is. Youve put together a great blog space great graphics, videos, layout. www.pklab.net is definitely a must-see blog! Happy new Year!

#2 Inviato da forex tutorial 09-02-2013

Great stuff from youR www.pklab.net , man. Ive read your stuff before and youre just too awesome. I love what youve got here, love what youre saying and the way you say it. You make it entertaining and you still manage to keep it smart. I cant wait to read more from you. This is really a great blog.

#3 Inviato da Williamgum 06-05-2016

I appreciate you sharing this forum. Fantastic.

Lascia il tuo commento:

Note:
  • La tua email non è obligatoria e non sarà visibile in alcun modo
  • Si prega di inviare solo commenti relativi a questa pagina
  • Commenti inappropriati o offensivi saranno modificati o eliminati
  • Codici HTML non sono consentiti. Prego usare i BB code:
    [b]bold[/b], [u]underline[/u], [i]italic[/i], [code]code[/code]
Il codice, le illustrazioni e gli esempi riportati in questa pagina sono solo a scopo illustrativo. L'autore non prende alcuna responsabilità per il loro utilizzo da parte dell'utente finale.
Questo materiale è di proprietà di Pk Lab ed è utilizzabile liberamente a condizione di citarne la fonte.