Observação: o Java 8 chegou ao fim do suporte em 31 de janeiro de 2024. Os aplicativos Java 8 atuais continuarão a ser executados e recebendo tráfego. No entanto, o App Engine pode bloquear a reimplantação de aplicativos que usam ambientes de execução após o término da data de suporte. Recomendamos que você migre para a versão compatível mais recente do Java.

Configuração do teste do serviço de capacidades

O recurso de teste de capacidade foi projetado para ser executado tendo como referência o servidor da Web de desenvolvimento do App Engine para fins de teste. Ele permite que você altere o status dos serviços, como armazenamento de dados, blobstore etc., para determinar se o aplicativo se comporta adequadamente quando encontra os vários status possíveis do serviço. Por exemplo, alterando o status do serviço de armazenamento de dados para desativado, você pode testar se o aplicativo gerencia a indisponibilidade do armazenamento de dados da maneira adequada.

Há várias maneiras de usar o recurso de teste de capacidades:

Alterar status das capacidades usando o console

Para alterar as capacidades no console:

Execute o aplicativo no servidor de desenvolvimento e acesse o console pelo URL /_ah/admin no seu servidor, por exemplo: http://localhost:8888/_ah/admin.
No console, clique em Status das capacidades na parte inferior esquerda.
Na página Configuração do status das capacidades, localize os serviços que são utilizados pelo aplicativo com o status você quer mudar. Clique no menu suspenso ao lado do nome do serviço e selecione o status que quer testar nesse serviço:

Agora, os serviços irão refletir as configurações que você escolheu na próxima vez que seu aplicativo acessá-los. Execute seu aplicativo e observe o comportamento dele.

Alterar status das capacidades usando a linha de comando

Se você usa o Eclipse, pode configurar um ou mais recursos usando as opções de depuração da linha de comando.

Para alterar as configurações de capacidade usando os argumentos da linha de comando da VM no Eclipse:

Com o Eclipse aberto, selecione seu projeto, clique com o botão direito do mouse e selecione Debug As > Debug Configurations.
Vá para a guia Arguments e insira a opção desejada na caixa de texto VM arguments. O formato da opção é:
-Dcapability.status.capabilityname.*=statusname
, em que capabilityname é substituído pelo nome do serviço (consulte Nomes de capacidades (serviços)) e statusname é substituído pelo status da capacidade que você pretende usar (consulte Valores de status das capacidades).

Observação: Para a capacidade de gravação do armazenamento de dados, substitua capabilityname por datastore_v3 e o asterisco (*) por write, como este: Dcapability.status.datastore_v3.write. Para as outras capacidades, deixe o asterisco como mostrado.

Na captura de tela abaixo, mostramos duas capacidades, armazenamento de dados e imagens, que estão sendo desativadas a partir da linha de comando:
Clique em Apply para salvar as alterações.
Clique em Debug para executar seu aplicativo com essas configurações.

Nomes de capacidades (serviços)

Nome da capacidade na API	Nome da capacidade exibido no console	Descrição
`blobstore`	BLOBSTORE	O serviço blobstore
`datastore_v3`	DATASTORE	O serviço de armazenamento de dados para consultas
`datastore_v3,write`	DATASTORE_WRITE	O serviço de armazenamento de dados para solicitações de gravação
`images`	IMAGES	O serviço de imagens
`mail`	MAIL	O serviço de correio
`memcache`	MEMCACHE	O serviço memcache
`taskqueue`	TASKQUEUE	O serviço taskqueue
`urlfetch`	URLFETCH	O serviço urlfetch

Valores de status de capacidades

Valores de status para todas as capacidades	Descrição
`DISABLED`	A capacidade está desativada.
`ENABLED`	A capacidade está disponível e atualmente não há manutenção planejada.
`SCHEDULED_MAINTENANCE`	A capacidade está disponível, mas há manutenção agendada.
`UNKNOWN`	O status deste serviço é desconhecido.

Alterar o status das capacidades usando a Capabilities API

Para usar o recurso de teste de capacidades do serviço local na API, use a classe LocalCapabilitiesServiceTestConfig. Para mais informações e um exemplo de código, consulte Como gravar testes de capacidades do serviço local.