Skip to main content

Testando seu aplicativo

O GitHub recomenda testar seu aplicativo com APIs e webhooks antes de enviar sua listagem para o GitHub Marketplace, para que você possa oferecer uma experiência ideal para os clientes. Antes que um especialista em integração aprove seu aplicativo, ele deverá tratar adequadamente os fluxos de cobrança.

Observação: este artigo se aplica somente à publicação de aplicativos do GitHub Marketplace. Para obter mais informações mais sobre como publicar o GitHub Actions no GitHub Marketplace, confira "Publicar ações no GitHub Marketplace".

Testar aplicativos

Você pode usar um rascunho de anúncio de GitHub Marketplace para simular cada um dos fluxos de cobrança. Uma listagem com status de rascunho significa que não foi enviada à aprovação. Todas as compras que você fizer usando uma listagem de rascunho do GitHub Marketplace não criarão transações reais e o GitHub não cobrará seu cartão de crédito. Observe que você só pode simular compras para planos publicados no rascunho do anúncio e não para rascunho de planos. Para obter mais informações, confira "Elaborar uma listagem para o seu aplicativo" e "Usar a API do GitHub Marketplace no seu aplicativo."

Usar um aplicativo de desenvolvimento com uma listagem de rascunho para testar alterações

Uma listagem do GitHub Marketplace só pode ser associada a um único registro do aplicativo, e cada aplicativo só pode acessar sua própria listagem do GitHub Marketplace. Por esses motivos, recomendamos configurar um aplicativo de desenvolvimento separado, com a mesma configuração do aplicativo de produção e criar uma listagem de rascunho do GitHub Marketplace que você poderá usar para teste. A listagem de rascunho do GitHub Marketplace permite que você teste alterações sem afetar os usuários ativos do seu aplicativo de produção. Você nunca precisará enviar a sua lista de desenvolvimento do GitHub Marketplace, uma vez que irá usá-la apenas para testes.

Como você pode criar apenas listagens de rascunho do GitHub Marketplace para aplicativos públicos, você deve tornar público o seu aplicativo de desenvolvimento. Os aplicativos públicos não são detectáveis fora das listagens publicadas do GitHub Marketplace, desde que que você não compartilhe a URL do aplicativo. Uma listagem do Marketplace com o status de rascunho é visível apenas para o proprietário do aplicativo.

Assim que você tiver um aplicativo de desenvolvimento com uma listagem de rascunho, você poderá usá-lo para testar as alterações feitas no seu aplicativo enquanto os integra à API e aos webhooks do GitHub Marketplace.

Não faça compras de teste com um app que está ativo em GitHub Marketplace.

Simular eventos de compra do Marketplace

Seus cenários de teste podem exigir a definição de planos de listagem que oferecem testes grátis e alternância de assinaturas grátis e pagas. Como os downgrades e os cancelamentos só entrarão em vigor no próximo período de cobrança, o GitHub fornece um recurso somente para desenvolvedores para "Aplicar a Alteração Pendente" a fim de forçar as ações de plano changed e cancelled a entrarem em vigor imediatamente. Acesse Aplicar Alteração Pendente para aplicativos com listagens de rascunho do Marketplace em https://github.com/settings/billing#pending-cycle:

Testar APIs

Para a maioria dos pontos de extremidade da API de do GitHub Marketplace, nós também fornecemos pontos de extremidade de teste da API, que retornam dados falsos de código que você pode usar para testes. Para receber dados com stub, você precisa especificar URLs com stub, que incluem /stubbed na rota (por exemplo, /user/marketplace_purchases/stubbed). Para ver uma lista de pontos de extremidade que dão suporte a essa abordagem de dados com stub, confira Pontos de extremidade do GitHub Marketplace.

Testar webhooks

O GitHub fornece ferramentas para testar as suas cargas implantadas. Para obter mais informações, confira "Testar webhooks".