Instrucciones de instalación

Esta página explica cómo configurar Eclipse o IntelliJ para ejecutar las aplicaciones de ejemplo de la API del reproductor de YouTube para Android.

Ambos conjuntos de instrucciones requieren introducir una clave de programador que está asociada con el uso de la API. Para tener una clave de programador, registra tu aplicación y obtén una clave de API de Android en la Consola de API de Google.

Importante: Al registrar tu solicitud, asegúrate de que se ha agregado el servicio de YouTube Data API v3 para tu proyecto. La API del reproductor de YouTube para Android depende de la API de datos para recuperar el contenido de YouTube.

Además, en el documento aplicaciones de ejemplo se describen brevemente las aplicaciones que se incluyen con la biblioteca de API, y la Guía de Android Dev explica cómo depurar aplicaciones en un dispositivo Android conectado.

Eclipse

Los siguientes pasos explican cómo configurar el entorno de Eclipse para compilar y ejecutar los proyectos de ejemplo distribuidos con la API. Ten en cuenta que las instrucciones explican los pasos a seguir para utilizar Eclipse SDK versión 3.8.0.

  1. Instala el plugin de ADT para el IDE de Eclipse. Debes instalar la versión 20 o superior del plugin.

  2. Descarga la versión más reciente de la API del reproductor de YouTube para Android y descomprime el archivo descargado.

  3. En Eclipse, crea un nuevo proyecto para las aplicaciones de ejemplo distribuidas con el código de la API del reproductor de YouTube para Android.

    1. En el menú File, selecciona New y en el submenú, elige Project.
    2. En el panel Select a wizard, elige Android -> Android Project from Existing Code.
    3. Para importar el proyecto, selecciona el directorio raíz. Ve al directorio en el que descomprimiste el archivo API del reproductor de YouTube para Android que descargaste y selecciónalo.
    4. Eclipse debe buscar el directorio seleccionado y ubicar el proyecto YouTubeAPIDemoActivity. Selecciona el proyecto y haz clic en Finish para completar la importación.

    Al crear un nuevo proyecto, es necesario importar el archivo de la biblioteca de cliente YouTubeAndroidPlayerApi.jar a tu directorio <project_root>/libs para que la biblioteca se incluya en tu ruta de compilación. También puedes agregar manualmente el archivo .jar a tu ruta de compilación.

  4. Abre el archivo DeveloperKey.java en el paquete YouTubeAndroidAPIDemo (YouTubeAndroidAPIDemo/src/com/examples/youtubeapidemo/DeveloperKey.java) y reemplaza null con una clave válida de programador de YouTube en la siguiente línea:

    public static final String DEVELOPER_KEY = null;

    Si no configuras la clave de programador, los ejemplos lanzarán una java.lang.NullPointerException y se cerrarán cuando intentes ejecutarlos.

  5. Ejecuta los ejemplos en un dispositivo Android conectado. Ten en cuenta que el emulador puede no ejecutar la versión requerida de la aplicación de YouTube, lo que causaría que los ejemplos no se ejecuten.

    1. Conecta un dispositivo Android que tenga la versión 4.2.16 o posterior de la aplicación de YouTube.
    2. Desde el menú Run, selecciona Run Configurations.
    3. En el panel Target, asegúrate de que la configuración iniciará las aplicaciones de ejemplo en el dispositivo Android conectado.
    4. Haz clic en Run para ejecutar los ejemplos en el dispositivo conectado.

IntelliJ

Los siguientes pasos explican cómo configurar el entorno de IntelliJ para compilar y ejecutar los proyectos de ejemplo distribuidos con la API. Ten en cuenta que las instrucciones explican los pasos para utilizar IntelliJ IDEA 12.0 communitty edition.

  1. Descarga el SDK de Android.

  2. Configura el SDK de Android a nivel global (IDE) en IntelliJ.

  3. Descarga la versión más reciente de la API del reproductor de YouTube para Android y descomprime el archivo descargado en la ubicación a la que IntelliJ tendrá acceso.

  4. Abre IntelliJ.

    1. En el menú File, selecciona Import Project. Cuando se te pida seleccionar el archivo o directorio para importar, ve al directorio sample en los contenidos del archivo sin comprimir.
    2. Elige crear el proyecto desde fuentes existentes.
    3. Establece el nombre y la ubicación del proyecto. La ubicación del proyecto deberá especificar el directorio sample.
    4. Elige agregar todos los archivos de origen ubicados para el proyecto en las raíces del proyecto.
    5. Revisa las bibliotecas encontradas para el proyecto y continúa con el siguiente paso.
    6. Revisa la estructura del módulo encontrada para el proyecto y continúa con el siguiente paso.
    7. Elige la plataforma SDK de Android 4.2 (o posterior) como el SDK del proyecto.
    8. Revisa los marcos detectados para el proyecto y termina de importar el proyecto.

  5. Abre el archivo DeveloperKey.java en el paquete com.examples.youtubeapidemo (sample/src/com/examples/youtubeapidemo/DeveloperKey.java) y reemplaza null con una clave válida de programador de YouTube en la siguiente línea:

    public static final String DEVELOPER_KEY = null;

    Si no configuras la clave de programador, los ejemplos lanzarán una java.lang.NullPointerException y se cerrarán cuando intentes ejecutarlos.

  6. Desde el menú Build, selecciona Make project para compilar el proyecto.

  7. Ejecuta los ejemplos en un dispositivo Android conectado. Ten en cuenta que el emulador puede no ejecutar la versión requerida de la aplicación de YouTube, lo que causaría que los ejemplos no se ejecuten.

    1. Conecta un dispositivo Android que tenga la versión 4.2.16 o posterior de la aplicación de YouTube.
    2. Desde el menú Run, selecciona Run.
    3. Edita las configuraciones para ejecutar las aplicaciones de ejemplo.
    4. En la pestaña General, bajo la sección Target Device, selecciona USB device.
    5. Haz clic en Run para ejecutar los ejemplos en el dispositivo conectado.