4. Guías - JorgePedraza2019/fbcmd4j GitHub Wiki

Guías: Para configurar y ejecutar el programa “fbcmd4j” se deberán descargar y configurar los siguientes programas:

  • Visual Studio Code: Este programa se necesita para modificar el código Java del programa fcmd4j ya que este será nuestro ambiente de trabajo (IDE).
  • Git bash: Este programa se necesita para ser la terminal por donde se podrá compilar y ejecutar el código.
  • Gradle: Este programa se necesita para poder utilizarlo como comando para compilar (gradle build) y ejecutar el código (gradle run).
  • Postman: Este programa se necesita para poder crear el oauth.accessToken en base a los permisos (public_profile,email,user_age_range,user_birthday,user_friends,user_gender,user_hometown, user_likes,user_link, user_location,user_photos, user_status, user_tagged_places, user_videos), el oauthSecret otorgado por la página Facebook developer y el oauth.appId otorgado también por la página Facebook developer.

El proceso de instalación y configuración de dichos programas se encuentra en la sección de "Instalación de aplicaciones".

Una vez instalado y configurado dichos programas se continua con lo siguiente:

Nota: Se debe crear una carpeta con cualquier nombre (por ejemplo: Prueba) y recordar su ubicación ya que allí dentro será donde se clonará el código.

Antes de configurar y ejecutar el código se deben tener en cuenta los siguientes comandos para la aplicación de Git Bash:

  • Para conocer la ubicación donde te encuentras se usa el comando "pwd".
  • Para entrar a una carpeta se usa el comando “cd”.
  • Para salir de una carpeta se usa el comando "cd ..".
  • Para conocer la lista de archivos de la ubicación actual se usa el comando "dir" o "ls".

Para configurar y ejecutar el código se deberá seguir los siguientes pasos:

No obstante, con ello se descarga el repositorio del Branch master, sin embargo, se debe descargar el Branch develop ya que ahí es donde se encuentran todos los archivos del código. Para descargar el Branch develop se debe realizar lo siguiente:

  • Después de descargar el repositorio, dentro de la aplicación de Git Bash en la misma ubicación se deberá escribir los siguientes códigos:
    • git Branch -a
    • git checkout master
    • ls
    • cd fbcmd4j
    • git checkout -b develop origin/develop
  • Finalmente, ya se descargó el código con los archivos del Branch develop.

Para configurar el programa desde el código fuente se siguen los siguientes pasos:

  • Se busca la carpeta descargada de fcmd4j, se le da clic derecho y se escoge la opción “Abrir con Visual Studio Code”.
  • Dentro de Visual Studio Code, se busca y se abre el archivo de facebook4j.properties ubicado en: …/fbcmd4j/src/main/resources/facebook4j.properties
  • Editar el valor de la variable ouath.appId con tu Id de la aplicación generada por Facebook developer (esto se obtiene con documentación que está ubicada hasta la parte inferior de esta página).
  • Editar el valor de la variable ouath.appSecret con tu clave secreta generada por Facebook developer (esto se obtiene con documentación que está ubicada hasta la parte inferior de esta página).
  • Editar el valor de la variable ouath.accessToken con el token de acceso generada por el programa Postman (esto se obtiene con documentación que está ubicada hasta la parte inferior de esta página).
  • Editar el valor de la variable ouath.permissions con los permisos que le quieres dar al programa. Los permisos de este programa son: public_profile,email,user_age_range,user_birthday,user_friends,user_gender,user_hometown, user_likes,user_link, user_location,user_photos, user_status, user_tagged_places, user_videos
  • Después, se busca y se abre el archivo log4j2.properties con el Visual Studio Code, dicho archivo se puede encontrar con parte de la siguiente ruta: …/fbcmd4j/src/main/resources/log4j2.properties
  • Una vez que esté abierto el archivo de log4j2.properties este se modificará con línea de “property.filename” ya que allí se pondrá la ruta de acceso del archivo “out.log” el cual se ubica en el proyecto dentro de la carpeta logs, dicha ruta deberá terminar con la siguiente sintaxis: … /fbcmd4j/src/main/logs/out.log .Un ejemplo de esto es: C:/Users/Admin/Documentos/Proyecto/fbcmd4j/src/main/logs/out.log
  • Se guarda el programa y la configuración del Código está terminada.

Una vez teniendo en cuenta los comandos del programa Git Bash, para ejecutar y compilar el programa desde el código fuente se siguen los siguientes pasos:

  • Se abre Git Bash y se ingresa a la carpeta fcmd4j, dependiendo la ubicación podría ser “cd Documents, cd Desktop, cd Downloads, cd Images, etc. “cd prueba” y “cd fcmd4j” y también depende el idioma de la computadora.
  • Una vez ingresado a la carpeta fcmd4j, se ingresa primero el comando: “ gradle build ” para compilarlo y luego se ingresa el comando: “ gradle run “ para ejecutar el proyecto.

Obtención de ouath.appId

  • Se ingresa a la siguiente liga y se crea una cuenta: https://developers.facebook.com/
  • Una vez creada la cuenta, se le da clic en el botón: “My Apps” y se le da clic en “Crear una App” para crea una aplicación.
  • Una vez creada una aplicación, se ingresa a la aplicación y se busca el APP ID.

Obtención de ouath.appSecret

El appSecret se obtiene dentro del sitio web de Facebook Developers, este se ubica adentro de settings > basic, para poder ver la app secret se deberá de hacer clic en “show” y ese se copiará en el archivo facebook4j.properties

Obtención ouath.accessToken

  • Antes de obtener el accessToken, primero se deberá conseguir el “Client Token” el cual está ubicado dentro del sitio web de Facebook Developers, se puede buscar de forma manual o se puede encontrar mediante la siguiente liga: https://developers.facebook.com/apps/**ID_DE_LA_APP**/settings/advanced/
  • Se abre la aplicación de Postman, al iniciarla aparecerá un archivo llamado launchpad, este se cerrará al darle la tacha y se creará uno nuevo en el símbolo de (+).
  • Al tener un archivo nuevo, se cambia GET por POST (para todos los archivos de esta aplicación siempre deberán estar en POST).
  • Se escribe en el apartado de “Enter an URL” y se escribe la siguiente liga: **https://graph.facebook.com/v2.6/device/login? **
  • En los parámetros query o query params en Key se deberá escribir “access_token” y en Value se deberá poner el “AppId” y el “Client Token” de la siguiente manera APP ID|CLIENT TOKEN.
  • Como segundo Key se deberá escribir “scope” y en Value se deberá escribir lo siguiente: “public_profile,email,user_age_range,user_birthday,user_friends,user_gender,user_hometown, user_likes,user_link, user_location,user_photos, user_status, user_tagged_places, user_videos”
  • Se le da clic al botón “Send”, en caso de aparecer un error favor de checar detalladamente que el link esté escrito de la forma correcta, de lo contrario, se deberá corregir su sintaxis buscándola en internet.
  • Después de darle al botón “Send”, se ingresará a la página de: https://www.facebook.com/device
  • Se iniciará sesión con Facebook con el mismo perfil (cuenta) de Facebook Developers y en la página de https://www.facebook.com/device se ingresará el “user_code” el cual fue otorgado en la aplicación de Postman, después se dará aceptar dentro del Facebook para permitir el acceso de los permisos.
  • Después en la aplicación de Postman se copiará el “code” proporcionado.
  • Después, se creará otro archivo (+) en la aplicación de Postman y se pondrá POST en lugar de GET.
  • Posteriormente, la liga del URL que se ingresará cambió respecto a la anterior y esta será la siguiente: https://graph.facebook.com/v2.6/device/login_status?
  • Nuevamente en el primer Key se ingresará el “access_token” y en Value se ingresará la “App.Id” y “Client Token” con la sintaxis de APP ID|CLIENT TOKEN.
  • Ahora, en la segunda Key se ingresará la palabra: “code” y en Value se pegará el valor de: code del archivo anterior y se le dará clic en Send.
  • Finalmente, se copia el “access_token” y este se pegará dentro del archivo facebook4j.properties, cabe recalcar que este valor es único y debe ser condifencial para evitar accesos al facebook de otras personas.