Setting Up an API Project

Esta página explica como configurar o Eclipse ou o IntelliJ para executar amostras de aplicativos para a API do Player do YouTube para Android.

Nos dois conjuntos de instruções será necessário inserir uma chave de desenvolvedor que está associada a seu uso da API. Para conseguir uma chave de desenvolvedor, registre sua inscrição e encontre sua chave de API do Android no Console de APIs do Google.

Importante: ao registrar sua inscrição, certifique-se de que o serviço da API de Dados do YouTube v3 esteja adicionado a seu projeto. A API do player do YouTube para depende da API de dados para recuperar o conteúdo do YouTube.

Além disso, o documento amostras de aplicativos descreve brevemente os aplicativos em que consta uma biblioteca de API. Já o Guia de desenvolvedor do Android explica como depurar aplicativos em um dispositivo Android conectado.

Eclipse

As etapas a seguir explicam como configurar seu ambiente Eclipse para criar e executar as amostras de projetos distribuídas com a API. As instruções explicam as etapas de como usar o Eclipse SDK versão 3.8.0.

1. Instale o plug-in ADT para o Eclipse IDE. Você precisa instalar a versão 20 ou superior do plug-in.

2. Faça o download da versão mais recente da API do Player do YouTube para Android e descompacte o arquivo.

3. No Eclipse, crie um novo projeto para as amostras de aplicativos distribuídas com o código da API do player do YouTube para Android.

   1. No menu File, selecione New e no submenu, escolha Project.
   2. No painel Select a wizard, escolha Android -> Android Project from Existing Code.
   3. Para importar o projeto, selecione o diretório raiz navegando até o diretório em que você descompactou o arquivo baixado da API do player do YouTube para Android.
   4. O Eclipse deve procurar o diretório selecionado e localizar o projeto YouTubeAPIDemoActivity. Selecione o projeto e clique em Finish para concluir a importação.

   Ao criar um novo projeto, será necessário importar o arquivo YouTubeAndroidPlayerApi.jar da biblioteca do cliente para seu diretório <project_root>/libs, de modo que a biblioteca seja incluída em seu caminho de criação. Você também pode adicionar manualmente o arquivo .jar para seu caminho de criação.

4. Abra o arquivo DeveloperKey.java no pacote YouTubeAndroidAPIDemo (YouTubeAndroidAPIDemo/src/com/examples/youtubeapidemo/DeveloperKey.java) e substitua null por uma chave de desenvolvedor do YouTube válida na seguinte linha:

   public static final String DEVELOPER_KEY = null;

   Se você não tiver definido a chave de desenvolvedor, as amostras exibirão um java.lang.NullPointerException e fecharão ao tentar executá-las.

5. Execute as amostras em um dispositivo Android conectado. É possível que o emulador não execute a versão necessária do aplicativo do YouTube, fazendo com que as amostras deixem de funcionar.

   1. Conecte um dispositivo Android executando a versão 4.2.16 ou posterior do aplicativo YouTube.
   2. No menu Run, selecione Run Configurations.
   3. No painel Target, certifique-se de que suas configurações iniciarão as amostras de aplicativos em seu dispositivo Android conectado.
   4. Clique em Run para executar as amostras em seu dispositivo conectado.

IntelliJ

As etapas a seguir explicam como configurar seu ambiente de IntelliJ para criar e executar as amostras de projetos distribuídas com a API. As instruções explicam como usar o IntelliJ IDEA 12.0 Community Edition.

1. Faça o download do SDK do Android.

2. Configure o SDK Android ao nível global (IDE) no IntelliJ.

3. Faça o download da versão mais recente da API do Player do YouTube para Android e descompacte o arquivo no local em que o IntelliJ poderá acessá-lo.

4. Abra o IntelliJ.

   1. No menu File, selecione Import Project. Quando solicitado a selecionar o arquivo ou diretório para importar, navegue até o diretório sample nos conteúdos do arquivo descompactado.
   2. Escolha a opção de criar o projeto a partir de fontes existentes.
   3. Defina o nome e o local do projeto (o local do projeto deve especificar o diretório sample).
   4. Escolha a opção de adicionar às raízes do projeto todos os arquivos de origem localizados para o projeto.
   5. Revise as bibliotecas encontradas para o projeto e vá para a próxima etapa.
   6. Revise a estrutura do módulo encontrada para o projeto e vá para a próxima etapa.
   7. Escolha o SDK da plataforma Android 4.2 (ou posterior) como SDK do projeto.
   8. Revise as estruturas detectadas para o projeto e termine a importação do projeto.

5. Abra o arquivo DeveloperKey.java no pacote com.examples.youtubeapidemo (sample/src/com/examples/youtubeapidemo/DeveloperKey.java) e substitua null por uma chave de desenvolvedor do YouTube válida na seguinte linha:

   public static final String DEVELOPER_KEY = null;

   Se você não tiver definido a chave de desenvolvedor, as amostras exibirão um java.lang.NullPointerException e fecharão ao tentar executá-las.

6. No menu Build, selecione Make project para criar o projeto.

7. Execute as amostras em um dispositivo Android conectado. É possível que o emulador não execute a versão necessária do aplicativo do YouTube, fazendo com que as amostras deixem de funcionar.

   1. Conecte um dispositivo Android executando a versão 4.2.16 ou posterior do aplicativo do YouTube.
   2. No menu Run, selecione Run.
   3. Edite as configurações para executar as amostras de aplicativos.
   4. Na guia General, na seção Target Device, selecione USB device.
   5. Clique em Run para executar as amostras em seu dispositivo conectado.