From d1ff403399e6d8c13ae3efe794dbe1b503198345 Mon Sep 17 00:00:00 2001 From: Ray Date: Tue, 26 Jul 2016 00:35:26 +0200 Subject: [PATCH] Updated Compile for OSX (markdown) --- Compile-for-OSX.md | 76 +++++++++++++++++++++++++--------------------- 1 file changed, 42 insertions(+), 34 deletions(-) diff --git a/Compile-for-OSX.md b/Compile-for-OSX.md index 626eae7..83009aa 100644 --- a/Compile-for-OSX.md +++ b/Compile-for-OSX.md @@ -1,44 +1,52 @@ *NOTE: This tutorial is written in Spanish, it should be translated to English.* -Software utilizado: +This guide has been written using the following software: - OSX El Capitan (10.11.3) - Xcode 7.2.1 (7C1002) -Pasos: - -1) Tener un Mac preferiblemente con la última versión de OSX (10.11.3) - -2) Instalar la versión correspondiente (según versión de OSX) de las *Apple Developer Tools*. Estas tools incluyen Xcode, en este caso la versión 7.2.1. - -3) Instalar la librería: GLFW3 -- Para facilitar la instalación de packages instalar Homebrew, ejecuta en la app Terminal el siguiente comando: - - /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/ Homebrew/install/master/install)" - -- Una vez instalado Homebrew copia brew install glfw3 en Terminal para su instalación. - -4) Instalar la librería: raylib -- Descargar raylib desde GitHub (https://github.com/raysan5/raylib). El ZIP incluye todo raylib: código fuente, ejemplos, algunas tools, juegos… -- Descomprimir el ZIP en algún directorio. En caso de usar el navegador Safari se descomprimirá automáticamente. -- Desde la app Terminal, acceder al directorio raylib-master/src, para ello escribe cd, pon un espacio, arrastra la carpeta del Finder src hacia Terminal y dale a Enter. -- Escribir make y darle a Enter. Si ha funcionado se habrá creado un archivo en la misma carpeta que se llama libraylib.a. - -5) Añadir las librerías en el proyecto de Xcode para el correcto funcionamiento de Raylib. - -- Crear un proyecto nuevo con Xcode y usar el template de Command Line Tool en OS X, darle a Next y en opciones asegurar-se que el lenguaje es C. -- Una vez abierto, en a la ventana desplegable de la izquierda dentro del navegador del proyecto, donde se encuentran las carpetas i archivos, darle click a la carpeta principal o proyecto. En la ventana central aparecera Build Phases entre otras opciones, entrar allí y desplegar Link Binary With Libraries. Aquí es donde se añaden las librerías al proyecto. -- Para añadir OpenGL y OpenAL no hay complicación porque vienen por defecto, darle al + y allí buscar OpenGL.framework y OpenAL.framework. -- Para añadir Raylib darle al + y Add Other…, aquí se tiene que buscar el archivo libraylib.a creado anteriormente en la carpeta correspondiente. -- Para añadir GLFW3 hacer los mismos pasos que con Raylib pero en el buscador de archivos ejecutar ⇧⌘D y pegar este directorio /usr/local/lib, ya que se encuentra en un directorio oculto por el sistema. Dentro la carpeta buscar libglfw3(versión).dylib en mi caso es la 3.3.1. -- Ahora para que Xcode encuentre raylib.h ir a Build Settings > Search Paths y en Header y Library Search Paths doble click a su derecha para incluir el directorio arrastrando la carpeta src donde se encuentra raylib.h hacia allí. +_Steps:_ + +1) Get a Mac with OSX version 10.11.3. + +2) Install *Apple Developer Tools*. Those tools include XCode, in our case version 7.2.1. + +3) Install GLFW3 library + +- To install required packages easier, first install Homebrew, execute in Terminal app the following command: +``` + /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" +``` +- Once Homebrew app is installed, run the following command in Terminal: +``` + brew install glfw3 +``` +4) Install raylib library +- Download or Clone raylib from GitHub (https://github.com/raysan5/raylib). `raylib-master.zip` contains all required files: source code, examples, templates, games... +- Decompress `raylib-master.zip` in some folder. In case of using Safari browser, it will be automatically decompressed. +- From Terminal app, access raylib-master/src directory: +``` + cd raylib-master/src +``` +- Compile raylib library using the following command from Terminal: +``` + make PLATFORM=PLATFORM_DESKTOP +``` +- If everything worked ok, `libraylib.a` should be created in `raylib-master/release/osx` folder. + +5) Add generated libraries (raylib, glfw3) to XCode project. +- Create a new XCode project using `Command Line Tool`. Make sure selected language is C. +- Once project created and open, Mouse click over the project main folder in the left project-navigation panel. It should appear `Build Phases` window, just enter and select `Link Binary With Libraries`. There you should add project libraries: +- To add OpenGL and OpenAL: Click on + and add OpenGL.framework and OpenAL.framework +- To add raylib: Click on + and `Add Other...`, look for `libraylib.a` file created previously, it should be in folder `raylib-master/release/osx` (make sure library has been created in that folder). +- To add GLFW3: Click on + and `Add Other...`, look for folder `/usr/local/lib` and look for file `libglfw3(version).dylib`. +- Make sure XCode finds `raylib.h`: Go to `Build Settings > Search Paths` and add raylib header folder (raylib-master/src) to `Header Search Paths` and library folder (raylib-master/release/osx) to `Library Search Paths`. - Add raylib/src directory not only to the Build Settings -> Search Paths -> Library Search Paths, but also to the Build Settings -> Search Paths -> Header Search Paths -6) Raylib ya debería funcionar correctamente. Para hacer la prueba, en la pagina oficial de Raylib(www.raylib.com) hay varios ejemplos, por ahora coge el código de ejemplo de core > basic window, o el de a continuación. Lo pegas en el fichero main.c y le das a Run o ⌘R. - -Apuntes: +6) raylib should work correctly. To make sure, just go to [official raylib page](www.raylib.com) and check the different examples available. Just copy the code into `main.c` file and run it with Run button or ⌘R. -- Parece haber un problema con las pantallas retina en que la ventana de la aplicación se ve reducida, la solución es mover un poco la ventana y se reescalara correctamente. +_NOTES:_ -- Los recursos de los ejemplos o de tu programa se tendrán que situar donde Xcode genere los productos. +- It seems there is a problem with HiDPI displays, in that case, app Window appears smaller. Solution is just moving a bit the Window and it should get scaled automatically. +- Examples resources should be placed in the folder where XCode generates the product. -_Tutorial desarrollado por Aleix Rafegas_ \ No newline at end of file +_Tutorial written by Aleix Rafegas and trasnlated to english by Ray_ \ No newline at end of file