Creación de un proyecto con
Code::Blocks
Roberto Albornoz Figueroa © 2006-2007
ralbornoz@[Link]
[Link]
Introducción
Este artículo tiene como objetivo aprender a crear un proyecto con Code::Blocks, compilarlo y
ejecutarlo.
Aunque el ejemplo que se crea es una ventana en SDL, los pasos explicados se pueden extender a
otros tipos de proyectos, por lo tanto será independiente de la API o bibliotecas externas que se
usen.
También veremos como dejar el ejecutable sin la consola, es decir, crear una aplicación tipo GUI.
Los pasos son bien sencillos, y se mostrará cada uno de ellos a través de imágenes y finalmente
será posible ver un video que muestra todo el proceso.
Se da por hecho que ya tenemos instalado en nuestro sistema, el compilador MinGW y la IDE
Code::Blocks, que vimos en un artículo anterior llamado Preparando el entorno para desarrollar
videojuegos.
Pasos para la creación de un proyecto
1. Al abrir Code::Blocks nos encontraremos con la siguiente interfaz.
2. El segundo paso es crear un nuevo proyecto desde el menú File->New->Project...
3. Y aparecerá la siguiente ventana, donde seleccionaremos Empty Project y presionaremos el
botón Go.
Como podemos ver en la imagen existe la posibilidad de crear otro tipo de proyectos, destinados a
APIs o Engines específicos.
Incluso Code::Blocks trae una plantilla para generar proyectos de tipo SDL, pero como el fin de este
tutorial es aprender cada uno de los pasos, no lo usaremos.
4. Ahora veremos una ventana que nos guiará paso a paso para crear el nombre del proyecto y el
lugar donde se almacenarán los archivos de proyecto y código fuente.
Para comenzar solo presionaremos el botón Next.
5. En esta nueva ventana seleccionaremos la carpeta donde ubicaremos el proyecto.
Para este ejemplo ya tenemos creado en c: una carpeta llamada Mis Proyectos.
6. Ahora debemos buscar en nuestro disco duro dicha carpeta, seleccionarla y presionar Aceptar.
7. Luego llenamos el campo Project Title, el cual será el nombre del proyecto y debe ser un nombre
lo más descriptivo posible. En este caso lo llamaremos Ventana SDL.
Esto creará una nueva carpeta en Mis Proyectos con el mismo nombre definido y un archivo de
extensión .cbp que contiene la configuración del proyecto. Luego presionamos el botón Next.
8. En esta ventana tenemos la posibilidad de seleccionar el compilador que usaremos, para este
caso dejamos el que aparece por defecto: GNU GCC Compiler.
Además tenemos dos opciones adicionales para crear el futuro ejecutable. Crear una configuración
Debug, Release o ambas.
La versión Debug generará un ejecutable más grande en tamaño, debido a que contiene toda la
información de variables y funciones que nos servirán después para depurar el programa.
En cambio la versión Release, será un ejecutable más pequeño, pero sin la información para
depuración, y es la que deberemos usar para distribuir nuestro programa.
Para este ejemplo lo dejaremos tal cual y finalizaremos la creación del proyecto con el botón Finish.
9. De esta forma la estructura básica del proyecto ya está lista, pero aun vacío, así que agregaremos
un nuevo archivo, que será nuestro código fuente. Esto lo haremos desde el menú File->Empty file.
10. Luego se nos preguntará si queremos realmente agregar este archivo al proyecto actual, así que
presionaremos el botón Si.
11. Ahora escribiremos el nombre que tendrá el nuevo archivo, para este caso lo llamaremos
[Link], y presionaremos el botón Guardar.
Al crear el archivo con extensión .cpp automáticamente al compilar se usará el compilador de C++
(g++), si hubiésemos creado un archivo con extensión .c se usaría el compilador para C (gcc).
12. Como se vio anteriormente, nuevamente se nos preguntará si queremos que el archivo sea parte
de Debug, Release o ambas.
En este caso presionaremos el botón Select All, para tener disponible el código fuente en las dos
versiones de ejecutables.
Por último presionamos el botón OK.
Los pasos 9 al 12 deberían realizarse para cada archivo nuevo que agreguemos al proyecto.
13. Ahora solo nos quedaría escribir el código que debe estar en la función [Link].
En la imagen vemos un pequeño código para crear una ventana en SDL y mostrar rectángulos de
diferentes tamaños y colores.
14. Una vez escrito el código, configuraremos algunas opciones extras para nuestro proyecto.
Como estamos usando SDL, escribiremos las bibliotecas con las que enlazaremos nuestro
ejecutable.
Para esto iremos al menú Project -> Build options...
15. En la ventana Project build options, seleccionaremos del segundo list box, la opción Linker
Settings.
16. Y veremos la siguiente ventana donde debemos ingresar los parámetros de cada una de las
bibliotecas, que necesitamos enlazar para obtener el ejecutable final.
Estos parámetros los ingresamos en el campo Other linker options.
Para este ejemplo necesitamos enlazar las bibliotecas mingw32, SDL_main y SDL. Es importante
que sea en este orden, debido a las dependencias que existen entre ellas.
Recordemos que las bibliotecas usadas en los compiladores GNU GCC, tienen una estructura ya
definida, por ejemplo para SDL debe existir un archivo llamado libSDL.a y libSDLmain.a (en la
carpeta lib del compilador) que tienen como prefijo la palabra lib, lo que nos permite hacer una
referencia a dichos archivos con el parámetro -l.
Así que deberíamos escribir:
-lmingw32
-lSDLmain
-lSDL
Si estuviéramos usando más bibliotecas las agregaríamos al final, por ejemplo:
-lSDL_mixer
-lSDL_gfx
-lSDL_ttf
-lSDL_net
etc.
Para el caso de Allegro, bastaría con colocar -lalleg
Para OpenGL: -lopengl32 y el mismo procedimiento para cualquier otra API que necesitemos usar.
Por último presionamos el botón OK para guardar los cambios.
17. Ahora cambiaremos otras propiedades del proyecto, para esto iremos al menú Project ->
Properties...
18. En esta ventana del list box seleccionaremos Build targets.
19. Acá tenemos la posibilidad de cambiar las propiedades para las dos versiones de ejecutables:
Debug y Release.
Para este ejemplo cambiaremos solo el tipo de la versión Release.
Primero seleccionamos de la sección Build targets (a la izquierda) la opción Release.
Luego desde Selected build target options (a la derecha), cambiaremos el tipo de aplicación desde
el list box llamado Type, y seleccionaremos GUI application.
Si no hiciéramos este cambio, cada vez que ejecutemos el programa creado, se abriría también la
ventana consola.
Esto nos puede ser útil mientras estamos desarrollando un programa, ya que por esta ventana se
mostrarían los mensajes generados por funciones de salida como printf.
No es el caso de SDL, ya que todos los mensajes los envía al archivo [Link] y/o [Link]
Finalmente presionamos el botón OK para guardar los cambios.
20. Antes de construir el ejecutable, tenemos la posibilidad de seleccionar cual versión queremos
compilar, para este caso seleccionaremos Release, de la opción Build target de la IDE.
21. Ya tenemos todo configurado, así que podemos compilar nuestro proyecto que consta de solo un
archivo de código fuente.
Para realizar esta acción existen dos formas: ir al menú Project->Build o ejecutar la combinación de
teclas Ctrl + F9.
Luego de unos momentos se habrá creado el ejecutable en la carpeta .\bin\Release
22. Ahora podemos ejecutar el programa desde el menú Project -> Run, presionando la
combinación de teclas Ctrl+F10 o desde el icono de color azul (con forma de botón play).
23. Y finalmente el programa ejecutándose.
