Desarrollo mobile

Documentar Código fuente PHP con ApiGen

Documentar código fuente PHP con ApiGen
Share on LinkedInShare on FacebookTweet about this on TwitterShare on Google+

Documentar con ApiGen

Hoy en día, la gran mayoría de la comunidad de programadores consideran como una buena práctica el hecho de comentar el código fuente, siempre y cuando estos comentarios estén estructurados y escritos de forma correcta; para que algún programa pueda ayúdanos a generar rápidamente nuestra documentación.

El principal objetivo de documentar el código fuente es básicamente es para facilitar la identificación y comprensión del funcionamiento o uso de las clases y sus métodos por todos los integrantes de un equipo de desarrolladores.

Hay muchas herramientas que nos pueden ayudar a documentar nuestro código fuente pero esta vez nos encargaremos de ApiGen.

1.- Documentar correctamente las clases y métodos.

ApiGen

2.- Descargar ApiGen desde su página web http://www.apigen.org/ y guardarlo en alguna ubicación del disco duro, en mi caso por ejemplo lo puse en C:/apigen/apigen.phar

3.- Verificar si ApiGen se ejecuta correctamente. Desde la consola de Windows nos ubicamos en el directorio donde guardamos el apigen.phar y ejecutamos la siguiente línea de comandos.

Documentar código Fuente con ApiGen

Si les aparece algo parecido a lo siguiente quiere decir que ya estamos listos para generar nuestra documentación de código fuente.

Documentar código Fuente con ApiGen

4.- Generamos nuestra documentación de código fuente; para ello es necesario tener identificado el directorio donde se encuentra nuestro código fuente PHP, y crear un directorio donde guardaremos los archivos generados por el ApiGen.

Ejecutar las siguientes líneas de comando en la consola de Windows.

Documentar código Fuente con ApiGen

5.- Revisar la documentación en el directorio asignado.

Referencias:

http://www.apigen.org/

https://www.sitepoint.com/generate-documentation-with-apigen/

http://code-epicenter.com/apigen-generate-documentation-for-your-php-project/

 

Share on LinkedInShare on FacebookTweet about this on TwitterShare on Google+
Read more

Phonegap en Netbeans 7.4

Share on LinkedInShare on FacebookTweet about this on TwitterShare on Google+

Hace unos meses atras ya ha salido netbeans un IDE el cual particularmente uso para trabajar y estos dias me anime bajarme la ultima version y oh! sorpresa el ide ahora tiene integrado phonegap antes lo usaba con el dreamweaver ya que tambien tiene integrado el phonegap pero no me parece tan chevere para programar.

Entonces vamos a integrar instalar todo para poder hacer nuestros proyectos phonegap (tambien llamado cordova desde la compra de adobe)

  1. Primero descargate la ultima version del netbeans 7.4 y instalalo
  2. descargar Git (http://git-scm.com/) instalalo
  3. descargar nodejs y si ya lo tienes instalado te recomiendo que lo actualices por que en algunas versiones no corre bien (http://nodejs.org/).
    Ahora ya tenemos instalado el nodejs podemos usar npm que nos permitira instalar el cordova
  4. Abrir el cmd  como administrador y ahora ejecutar esta linea
    npm install -g cordova@3.4 
    esta linea es para instalar el cordova globalmente en la version 3.4 es importante la version por que con versiones antiguas netbeans no lo reconoce o simplemente dan problemas.
  5.  para comprobar que todo se instalo bien ejecutamos en el cmd
    git –version
    |__git version 1.9.0.msysgit.0
    cordova –version 
    |__3.4.0-0.1.0
    pueda que les muestre una variación de versión.

con eso ya tenemos instalado todo para poder trabajar con  netbeans y phonegap abrimos el IDE y creamos nuevo proyecto y nos debe mostrar.

Nuevo proyecto -> HTML5 -> Cordova applicacion

con esto ya podemos crear proyectos con phonegap desde netbeans.

Share on LinkedInShare on FacebookTweet about this on TwitterShare on Google+
Read more

Phonegap solucion rapida para creacion de aplicaciones mobiles y tablets

Share on LinkedInShare on FacebookTweet about this on TwitterShare on Google+

Una nueva tecnologia de codigo libre (Open Source) creada por Nitobi Software  y fue comprada el 2011 por Abode que permite crear   aplicaciones celulares parar 7 plataformas  (iOS, Android, Blackberry, Windows Phone, WebOS y Symbian) desde un solo script que seria los nuevos estandares de la web HTML5 + CSS3 + JAVASCRIPT

El proceso grafico de phonegapUno de los puntos que mas sorprende es poder manipular elementros de celular por ejemplo:

  • Accelerometer
  • Camera
  • Connection
  • Contactos
  • File
  • Geolocation
  • Storage

Entre otros mas, Adobe en su nueva version de Dreamweaver CS6  integro esta tecnologia y JqueryMobile (podemos usar la opcion de usar estas liberias desde local o CDN) para tener interfaz de usuarios(UI) adecuados para celulares asi que ahora lo tenemos mas facil para comenzar nuestros desarrollos de aplicaciones celulares.

Explicare un poco del flujo del proceso de la creacion ya en el proximo articulo realizare un ejemplo claro de como crear un aplicacion desde el inicio
Todo esto desde Dreamweaver

  1. Se crea el proyecto con jquerymobile
  2. Desarrollamos la interfaz y funcionalidad de la app
  3. Ahora debemos tener una cuenta en Abode o Github para poder acceder a un panel en donde realmente sucede la magia http://build.phonegap.com
  4. Ahora en Dreamweaver cs6 entramos
    sitio>servicio phonegap build > servicio phonegap build
    nos debe mandar una pantalla de logeo
  5. Luego al logearnos y creamos un proyectos  que paralelamente lo crea en http://build.phonegap.com como muestra la imagen

    al hacer esto ya se crea y muestra  los ejecutable para instalar en el celular.

Y listo con eso ya tenemos podemos descargar  o por medio de QR  los ejecutables para varios sistemas operativos de celulares.

El pero de Phonegap

No todo es de color rosa  y el motivo mas importante que esta tecnologia no podra sacar del mercado las aplicaciones nativas (me refiero a aplicaciones creadas desde un lenguaje optimo para el sistema operativo del celular) es que son lentas y para aplicaciones complejas definitivamente no serian el camino ideal se deberia optar por algo nativo.

Entonces Phonegap es una herramienta util pero que solo para aplicaciones informativas y con poca interaccion.

 

 

Share on LinkedInShare on FacebookTweet about this on TwitterShare on Google+
Read more