Como executar, testar e implantar o back-end

Você pode executar e testar seu back-end localmente e implantá-lo com o Android Studio.

Executar e testar o back-end localmente

Depois de adicionar o modelo de back-end dos pontos de extremidade, você precisa testá-lo para garantir que seu ambiente funciona corretamente. Para executar o modelo de back-end localmente:

  1. Clique em Executar > Editar configurações para abrir o formulário Executar/Depurar configurações:

    Executar configuração de back-end

    Observe que, quando você adiciona o modelo do módulo de back-end ao seu projeto, uma nova configuração de execução é criada para o back-end. Ela tem o nome de módulo que você atribuiu durante a criação do back-end.

  2. No painel esquerdo, em App Engine DevAppServer, localize o módulo de back-end que você acabou de adicionar, selecione-o e clique em OK.

  3. clique em Versão > Recriar projeto e aguarde até o fim da compilação;

  4. Selecione Executar .> Executar <your-backend-module-name> para iniciar o back-end no servidor de desenvolvimento local do App Engine no Android Studio:

    Executar configuração de back-end

  5. aguarde a inicialização do back-end no servidor de desenvolvimento. Quando ele terminar de carregar, uma mensagem como a seguinte será mostrada no console:

        Jun 18, 2014 4:07:30 PM com.google.appengine.tools.development.AbstractModule startup
        INFO: The admin console is running at http://localhost:8080/_ah/admin
        Jun 18, 2014 4:07:30 PM com.google.appengine.tools.development.DevAppServerImpl doStart
        INFO: Dev App Server is now running
    
  6. navegue para http://localhost:8080 na máquina que executa seu projeto do Android Studio. Se tudo correu bem, você verá a seguinte página:

    Back-end "HelloWorld" em execução local

    A página mostrada é para o back-end dos pontos de extremidade. A página de outros tipos de back-end serão ligeiramente diferentes.

    Observe os links na parte superior da página, especialmente o que leva você ao console do Google Cloud, onde é possível criar ou configurar um projeto. Você precisará de um projeto para implantar seu back-end depois que as tarefas de desenvolvimento e teste estiverem concluídas.

Nesse momento, o back-end padrão do modelo está em execução com sucesso. No entanto, seu aplicativo para Android ainda não está conectado a ele. Para acessar o back-end, você precisa adicionar código ao seu aplicativo para Android conforme descrito no arquivo README apropriado:

Você também precisará adicionar qualquer comportamento personalizado que queira para seu back-end.

Testar o back-end dos pontos de extremidade com o API Explorer

Para back-ends que têm pontos de extremidade, você pode testar o funcionamento da API diretamente com o Google API Explorer integrado:

  1. Inicie e execute seu back-end localmente conforme descrito anteriormente.

  2. navegue para http://localhost:8080/_ah/api/explorer na máquina que executa seu projeto do Android Studio. Se tudo tiver corrido bem, você verá uma página como esta:

    Explorador de APIs do Cloud Endpoints

  3. Clique no nome da API, como myApi API, para mostrar os métodos disponíveis para ela.

  4. Clique em um método, como myApi.sayHi, para mostrar o formulário do Explorer para esse método:

    Formulário SayHi

  5. Digite um valor para o campo de entrada se houver um. Para usar o back-end padrão como exemplo, digite seu nome no campo name. Clique em Executar e verifique a resposta esperada.

Implantar back-ends

Caso seu back-end funcione bem localmente, você pode implantá-lo no Google App Engine.

Antes de implantar seu back-end, é preciso criar um projeto do Cloud e adicionar o código do projeto a ele, conforme descrito no README do seu modelo de back-end, Módulo do Servlet/Módulo de pontos de extremidade/Back-end com Google Cloud Messaging. Para implantar seu back-end no App Engine a partir do Android Studio:

  1. selecione Executar > Interromper para parar o back-end se ele estiver em execução localmente;

  2. execute Versão > Implantar módulo no App Engine.

    • Se esta for a primeira vez que você executa essa tarefa, será preciso fazer login com sua Conta do Google. Escolha uma conta e faça login.
  3. na caixa de diálogo Implantar no App Engine, selecione seu módulo. Na lista suspensa Implantar em:, escolha um projeto do Console do Google Cloud (neste exemplo, backend-example-352).

    Implantar App Engine

    Role até o final da lista suspensa se você precisar criar um novo projeto ou fazer login com uma conta diferente:

    • Para criar um projeto, role até o final da lista suspensa e clique em Clique aqui. Isso leva você ao console do Google Cloud para criar o projeto. De volta na caixa de diálogo no Android Studio, clique no botão "Atualizar" para incluir seu novo projeto na lista suspensa. Selecione o novo projeto.
    • Se você quiser criar uma nova conta ou especificar uma conta existente diferente, role até o final da lista suspensa e clique em Adicionar conta.

    Adicionar conta

  4. de volta à caixa de diálogo Implantar no App Engine, clique em Implantar. Monitore o status da sua implantação no console do Android Studio.