Skip to main content

Testen der App

GitHub empfiehlt, deine App mit APIs und Webhooks zu testen, bevor du dein Angebot an GitHub Marketplace übermittelst. So kannst du dafür sorgen, dass bei deinen Kunden keine Probleme auftreten. Bevor eine Onboardingexpertin deine App genehmigt, muss dafür gesorgt sein, dass diese den Abrechnungsflow ordnungsgemäß ausführt.

Note

Dieser Artikel gilt nur für das Veröffentlichen von Apps im GitHub Marketplace. Weitere Informationen zum Veröffentlichen von GitHub Actions im GitHub Marketplace findest du unter Aktionen auf dem GitHub-Marktplatz veröffentlichen.

Testen von Apps

Du kannst Eintragsentwürfe für den GitHub Marketplace verwenden, um alle Abrechnungsflows zu simulieren. Ein Eintrag im Entwurfszustand bedeutet, dass er noch nicht für die Genehmigung übermittelt wurde. Alle Einkäufe, die du mit einem Eintragsentwurf für den GitHub Marketplace tätigst, führen nicht zu tatsächlichen Transaktionen, und GitHub belastet deine Kreditkarte nicht. Beachte, dass du nur Einkäufe für Pläne simulieren kannst, die im Entwurfseintrag veröffentlicht wurden, und nicht für Pläne im Entwurfsstadium. Weitere Informationen findest du unter Entwerfen eines Angebots für deine App und Verwenden der GitHub Marketplace-API in deiner App.

Verwenden einer Entwicklungs-App mit einem Entwurfseintrag zum Testen von Änderungen

Ein GitHub Marketplace-Eintrag kann nur einer einzelnen App-Registrierung zugeordnet werden, und jede App kann nur auf ihren eigenen GitHub Marketplace-Eintrag zugreifen. Aus diesen Gründen wird empfohlen, eine separate Entwicklungs-App mit derselben Konfiguration wie deine Produktions-App zu konfigurieren und einen Entwurf des GitHub Marketplace-Eintrags zu erstellen, den du zum Testen verwenden kannst. Der Angebotsentwurf für den GitHub Marketplace ermöglicht es dir, Änderungen zu testen, ohne dadurch aktive Benutzer*innen deiner Produktions-App zu beeinträchtigen. Du musst deinen Entwicklungseintrag für den GitHub Marketplace nie übermitteln, da du ihn nur zum Testen verwendest.

Da du nur Eintragsentwürfe für den GitHub Marketplace für öffentliche Apps erstellen kannst, musst du deine Produktions-App veröffentlichen. Öffentliche Apps können nicht außerhalb der veröffentlichten GitHub Marketplace-Einträge gefunden werden, solange du die App-URL nicht freigibst. Ein Marketplace-Eintrag im Entwurfszustand ist nur für die Besitzer*innen der App sichtbar.

Wenn du über eine Entwicklungs-App mit einem Eintragsentwurf verfügst, kannst du ihn verwenden, um Änderungen an deiner App zu testen, während du die Integration mit der GitHub Marketplace-API und den -Webhooks durchführst.

Warning

Tätige keine Testkäufe mit einer App, die auf dem GitHub Marketplace aktiv ist.

Simulieren von Marketplace-Kaufereignissen

Deine Testszenarios erfordern möglicherweise das Einrichten von Angebotsplänen, die kostenlose Testversionen und das Wechseln zwischen kostenlosen und kostenpflichtigen Abonnements beinhalten. Da Herabstufungen und Stornierungen erst mit dem nächsten Abrechnungszeitraum wirksam werden, stellt GitHub nur für Entwickler*innen das Feature „Ausstehende Änderung anwenden“ bereit, mit dem die Planaktionen changed und cancelled sofort angewandt werden können. Du kannst auf Ausstehende Änderung anwenden für Apps mit Entwürfen von Marketplace-Einträgen unter https://github.com/settings/billing#pending-cycle: zugreifen.

Testen von APIs

Für die meisten API-Endpunkte des GitHub Marketplace werden auch Stub-API-Endpunkte bereitgestellt, die hart codierte, falsche Daten zurückgeben, die du zum Testen verwenden kannst. Um Stub-Daten zu erhalten, musst du Stub-URLs angeben, die /stubbed in der Route enthalten, z. B. /user/marketplace_purchases/stubbed. Eine Liste der Endpunkte, die diesen Ansatz mit Stub-Daten unterstützen, findest du unter GitHub Marketplace-Endpunkte.

Testen von Webhooks

GitHub bietet Tools zum Testen deiner bereitgestellten Nutzdaten. Weitere Informationen finden Sie unter Testen von Webhooks.