Código fuente
De Apogeus Wiki
Contenido |
Código fuente
Agadoth online es un juego de código abierto (open source) y el código fuente está disponible para su descarga.
Licencia
La licencia del código es GPLv3.
- Versión oficial en inglés: http://www.gnu.org/copyleft/gpl.html
- Traducción no oficial al español: http://www.viti.es/gnu/licenses/gpl.html
- Artículo resumen en la wikipedia española: http://es.wikipedia.org/wiki/GNU_General_Public_License
Las imágenes, vídeos y otros contenidos multimedia se rigen bajo la licencia de Creative Commons.
- Traducción oficial al español: http://creativecommons.org/licenses/by/2.0/es/legalcode.es
- Artículo resumen en la wikipedia española: http://es.wikipedia.org/wiki/Creative_Commons
Descargar código
Por el momento no existen archivos de descarga. Se puede descargar la última versión en desarrollo en http://www.launchpad.net/ao
Para ello necesitas instalar Bazaar. Existe versión tanto para Windows como para GNU/Linux.
Para sistemas Debian, Ubuntu puedes instalar bazaar con:
sudo apt-get install bzr
Después puedes obtener el código con el siguiente comando:
bzr branch lp:ao
Una vez ejecutado este comando se creara en la carpeta actual una carpeta llamado ao (Agadoth Online) con todo el código fuente.
Si no tienes cuenta Launchpad asociada, el código se bajará pero puede ser que obtengas mensaje de aviso por ello.
Si quieres evitarlo crea una cuenta en launchpad.net y ejecuta el comando (siendo usuario tu nombre de usuario en launchpad):
bzr launchpad-login usuario
Editar y modificar el código
Cualquiera puede ayudar y modificar el código de Agadoth Online para incorporar nuevas características, corregir fallos, etc.
Una vez que hayas bajado el código, edita los ficheros que creas convenientes.
Para ver las diferencias, puedes utilizar el comando:
bzr diff
Si has creado un nuevo archivo, necesitaras añadirlo al proyecto para que sea versionado con:
bzr add fichero
También puedes eliminarlo con:
bzr rm fichero
Para ver el estado general del proyecto, puedes utilizar:
bzr status
Una vez que hayas hecho los cambios, debes commitearlos (hacer commit o confirmar los cambios) para que sean tenidos en cuenta. Para ello es necesario indicar un mensaje simple y conciso de lo que has cambiado y modificado en un mensaje con el siguiente comando:
bzr commit -m 'Mensaje resumen de la modificación'
También puedes utilizar la forma abreviada:
bzr ci -m 'Mensaje resuemn de la modificación'
Y si deseas hacer commit sólo sobre un fichero y no todos, debes indicar el archivo por ejemplo:
bzr ci -m 'Mensaje resumen de la modificación' ruta/archivo.php
Enviar los cambios
Una vez que hagas tus cambios del código en tu copia local, puedes enviarlos a la versión de desarrollo, para ello usa:
bzr push
Sincronizar con la versión de desarrollo
Si ha pasado un tiempo y se han hecho modificaciones en la versión de desarrollo y tu también has hecho, pero deseas sincronizar las copias para tener la versión actual (sin perder tus cambios) debes usar:
bzr pull
Instalar Agadoth online en local en GNU/Linux Ubuntu
Para visualizar o arrancar el proyecto para desarrollo de forma local, necesitas instalar apache, php y mysql, es decir tener un entorno LAMP (LInux Apache MySql PHP) en tu ordenador. Para hacerlo de forma sencilla, se usa la aplicación tasksel para instalar el lote de dependencias y programas. Para instalarlo:
$ sudo apt-get install tasksel
Despues ejecutar el siguiente comando para instalar el entorno LAMP:
$ sudo tasksel install lamp-server
Si todo es correcto, el servidor Apache debería funcionar en tu ordenador y escribiendo en el navegador localhost debería aparecer:
It works! This is the default web page for this server. The web server software is running but no content has been added, yet.
Despues es necesario instalar phpmyadmin y algunas extensiones de mysql y php ejecutando:
$ sudo apt-get install mysql-server libapache2-mod-auth-mysql php5-mysql phpmyadmin
En el proceso de instalación te solicitará un usuario y una contraseña, este usuario y contraseña será el de phpmyadmin. Por lo general puedes usar root como usuario y tu contraseña habitual de acceso a tu máquina.
Una vez terminado, debes arrancar el servidor MySql con:
$ sudo service mysql start
Posteriormente para tener acceso local a phpmyadmin debes crear el siguiente enlace simbólico:
$ sudo ln -s /usr/share/phpmyadmin /var/www
De igual forma para poder acceder mediante localhost/ao en el navegador, debes crear otro enlace simbólico a la ruta donde quieras tener instalado el código fuente del proyecto, por defecto, en este manual usaremos el directorio personal del usuario /home, dentro de una carpeta Projects (puedes usar cualquier otra alternativa):
$ ln -s /var/www/ao ~/Projects/ao
Si tienes problemas de permisos puede que necesites ejecutar (siendo usuario, el usuario de tu ordenador):
$ sudo chmod 755 ~/Projects/ao $ sudo chown usuario.usuario ~/Projects/ao
Una vez finalizado, utilice el bzr para descargar todo en la carpeta /Projects/ao como se indica en la parte superior de esta página.
El siguiente paso es aumentar el limite de upload en el archivo php.ini para poder subir las bases de datos mysql del proyecto. Para ello editaremos el archivo php.ini de Apache, utilizando un editor de consola como nano (puede usar su preferido, siempre que sea en modo root):.
$ sudo nano /etc/php5/apache2/php.ini
Pulsando Control+W busque “upload_max_filesize” y poner el valor de 2M a 20M (o uno superior según la necesidad). De igual forma edite “post_max_size” a un valor igual o superior que “upload_max_filesize”
Una vez guardado el archivo, pulsando Control+O y saliendo con Control+X, reinicie apache:
$ sudo /etc/init.d/apache2 restart
Finalmente debe ir a phpmyadmin para crear la base de datos. Escriba la siguiente ruta en el navegador:
http://localhost/phpmyadmin
Le solicitará el usuario y contraseña que usted puso en la instalación de phpmyadmin.
Por seguridad, es recomendado crear un usuario alternativo en phpmyadmin para utilizar el proyecto, por defecto se utiliza test_ao en el archivo de configuración. Cree un usuario con todos los privilegios y una base de datos para el proyecto, que por defecto también es test_ao.
Como alternativa puedes usar las siguientes consultas SQL para crear un usuario llamado tester y con usuario tester:
CREATE USER 'tester'@'localhost' IDENTIFIED BY '***'; GRANT ALL PRIVILEGES ON * . * TO 'tester'@'localhost' IDENTIFIED BY '***' WITH GRANT OPTION MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_USER_CONNECTIONS 0 ; CREATE DATABASE IF NOT EXISTS `tester` ; GRANT ALL PRIVILEGES ON `tester` . * TO 'tester'@'localhost';
Por último importe los datos sql en la base de datos de phpmyadmin, pinchando en la pestaña importar de la zona superior y suba los archivos que se encuentran en la carpeta /sql del proyecto. Es necesario importar primero el archivo test_ao.sql y después el resto en cualquier orden.
Para evitar problemas de errores de escritura de php antes ejecuta:
$ sudo chmod 777 ~/Projects/ao/inc/config.php $ sudo chmod 777 ~/Projects/ao/inc/gconf.php
Una vez creado, puede ir a http://localhost/ao donde encontrará un asistente de instalación y donde debe introducir los datos de usuario myql, contraseña, servidor (para local utilizar localhost).
Ese instalador, modificara el archivo config.php en ao/inc/config.php gerando las varaibles de configuración de acceso (puede editarlas manualmente)
Y ya podrá acceder al juego en http://localhost/ao de forma normal.
Instalar Agadoth online en local en Windows
Para visualizar o arrancar el proyecto para desarrollo de forma local, necesitas instalar apache, php y mysql, es decir tener un entorno WAMP (Windows Apache MySql PHP) en tu ordenador.
Existen múltiples formas de instalar un entorno WAMP, la más cómoda es instalar una aplicación que realice todas estas instalaciones y configuraciones desde un solo instalador. En nuestro caso elegimos EasyPHP.
Para instalarlo dirígete a la página de descargas de EasyPHP y descarga la última versión. En el momento de edición, la ultima versión para descarga es la versión EasyPHP 5.3.3:
Ejecuta el instalador con las configuraciones por defecto. Al finalizar encontraras un pequeño icono con una E negra y un punto rojo en la barra de tareas. En ese icono por defecto se habrá iniciado el servidor web Apache y el servidor de base de datos MySQL.
El siguiente paso es conocer el directorio donde el servidor web publica los archivos. Para ello, realiza click con el botón derecho del ratón sobre el icono de la barra de tareas de EasyPHP y pincha sobre la opción "Explore" que te abrirá dicha carpeta. Para Windows 7, suele ser: C:\Program Files (x86)\EasyPHP-5.3.3\www aunque puede variar.
Si escribes en el navegador http://localhost/ o http://127.0.0.1/ se mostrarán los contenidos de ese directorio.
Para descargar el código de Agadoth Online desde la versión en desarrollo, necesitas instalar Bazaar en Windows. En la página de descargas de Bazaar puedes obtener la versión. En el momento de edición, la última versión para descarga es la versión Bazaar 2.3.1 StandAlone:
Descargar Bazaar 2.3.1 StandAlone
Ejecuta el instalador con las configuraciones por defecto, excepto en los componentes que recomendamos hacer una instalación completa ("Full installation").
Una vez instalado encontraras un icono de señal amarilla llamado "Bazaar Explorer". Ejecuta el acceso directo y se abrirá la interfaz del explorador de Bazaar.
Pulsa sobre el botón "Obtener fuente del proyecto de otro lugar" y después sobre el botón "Obtener". Se abrirá una ventana donde te pedirá el "Código de la rama".
Introduce:
https://code.launchpad.net/~apogeus/ao/trunk
Y bajo "Directorio local donde el árbol de trabajo será creado" introduce el directorio de EasyPHP, que para este tutorial es "C:\Program Files (x86)\EasyPHP-5.3.3\www" y pulsa Aceptar. Bazaar descargará todo el código desde la versión de desarrollo.
Otro método alternativo es realizar la descarga mediante los comandos de bazaar. Para ello ves a Inicio>Ejecutar y escribe "cmd" o bien pulsa la tecla del icono de windows + R y escribe "cmd", te abrirá la consola del sistema.
Escribe:
cd C:\Program Files (x86)\EasyPHP-5.3.3\www
Registrate en launchpad.net e identifica tu usuario con:
bzr launchpad-login nombreusuario
Siendo nombreusuario tu nombre de usuario registrado en Launchpad.
Y despues descarga el los archivos con:
bzr branch lp:ao
Una vez descargados los archivo, encontraras en la dirección local http://localhost/ o http://127.0.0.1/ una carpeta llamada "ao".
La primera vez que inicies Agadoth Online, te aparecerá un pequeño asistente de instalación para crear una configuración que tiene el siguiente aspecto:
Tras rellenar los datos solicitados y pulsar en instalar, podrás visualizar el juego instalado listo para tus jugadores.
|
