# App im Dashboard bereitstellen Erfahren Sie, wie Sie Ihre Android-App auf Ihren Geräten im Dashboard bereitstellen. Nachdem Stripe Ihre App geprüft und für die Bereitstellung genehmigt wurde, [benachrichtigen wir Sie](https://docs.stripe.com/terminal/features/apps-on-devices/submit.md#monitor-status) per E-Mail im Dashboard. Sie können dann die folgenden Anweisungen befolgen, um Ihre App bereitzustellen. Während der Bereitstellung wird Ihre App sofort an Ihr Gerät gesendet und heruntergeladen, und das Gerät wird neu gestartet, um sie zu installieren. Geräte werden alle 24 Stunden neu gestartet und übernehmen alle Aktualisierungen automatisch. Um nach Aktualisierungen zu suchen und diese sofort anzuwenden, können Sie Ihr Gerät manuell neu starten. Sie können neue und aktualisierte Apps für Terminal-Geräte im Dashboard bereitstellen. ## Bereitstellungsgruppe hinzufügen oder bearbeiten Bevor Sie eine Bereitstellungsgruppe hinzufügen oder bearbeiten können, müssen Sie einen Terminal-[Standort](https://docs.stripe.com/terminal/fleet/locations-and-zones.md) erstellen und diesem Standort [Lesegeräte](https://docs.stripe.com/api/terminal/readers/object.md) hinzufügen. Sie können dann einer Bereitstellungsgruppe Standorte zuweisen, sodass alle Lesegeräte am Standort Aktualisierungen von dieser Bereitstellungsgruppe erhalten. Nachdem Sie eine Bereitstellungsgruppe erstellt haben, können Sie sie jederzeit bearbeiten, indem Sie sie auswählen. ### Bereitstellungsgruppe hinzufügen 1. Klicken Sie auf der Registerkarte [Software](https://dashboard.stripe.com/terminal/software) auf **Bereitstellungsgruppen verwalten**. 1. Klicken Sie auf **Bereitstellungsgruppe hinzufügen**. 1. Führen Sie die folgenden Schritte im Drawer **Bereitstellungsgruppe hinzufügen** aus: - Geben Sie einen Gruppennamen ein. - Wählen Sie Ihren Terminal-Gerätetyp aus. - Aktivieren Sie bei Bedarf das Kontrollkästchen **Standardbereitstellungsgruppe**, um eine Standardbereitstellungsgruppe zu erstellen. Eine Standardbereitstellungsgruppe enthält automatisch alle Standorte, die nicht explizit einer anderen Bereitstellungsgruppe zugewiesen sind. Sie können eine Standardbereitstellungsgruppe pro Gerätetyp erstellen. - Klicken Sie auf **Fertig**. ### Bereitstellungsgruppen verwalten 1. Klicken Sie auf der Registerkarte [Software](https://dashboard.stripe.com/terminal/software) auf **Bereitstellungsgruppen verwalten**. 1. Wählen Sie die Bereitstellungsgruppe aus der Liste aus. 1. Klicken Sie auf **Standorte hinzufügen**. 1. Wählen Sie die hinzuzufügenden Standorte aus. 1. Klicken Sie auf **Fertig**. ### Bereitstellungsgruppen mit Direct Charges verwalten Plattformen können Standorte, die sich im Besitz verbundener Konten befinden, zu den Bereitstellungsgruppen der Plattform hinzufügen. 1. Klicken Sie auf der Registerkarte [Software](https://dashboard.stripe.com/terminal/software) auf **Bereitstellungsgruppen verwalten**. 1. Wählen Sie die Bereitstellungsgruppe aus der Liste aus. 1. Klicken Sie auf **Standorte hinzufügen**. 1. Wählen Sie in der Konto-Dropdown-Liste das Konto aus, von dem Sie Standorte hinzufügen möchten. Sie müssen ein Konto auswählen, bevor Sie Standorte hinzufügen können. 1. Wählen Sie die hinzuzufügenden Standorte aus. 1. Klicken Sie auf **Fertig**. ## App-Version bereitstellen Sie können Ihre App bereitstellen, nachdem sie von [einem/einer Stripe-Prüfer/in genehmigt wurde](https://docs.stripe.com/terminal/features/apps-on-devices/app-review.md). Im Dashboard können Sie Apps auf eine von drei Arten bereitstellen: - Von der Bereitstellungsgruppe - Auf der Registerkarte „Software“ - Über die App selbst ### Auf der Detailseite der Bereitstellungsgruppe 1. Klicken Sie auf der Registerkarte [Software](https://dashboard.stripe.com/terminal/software) auf **Bereitstellungsgruppen verwalten**. 1. Klicken Sie auf der Detailseite der Bereitstellungsgruppe auf **Bereitstellen** und **Neue Bereitstellung**. 1. Wählen Sie für jede genehmigte App, die Sie bereitstellen möchten, eine Version aus und klicken Sie dann auf **Weiter**. Sie können keine frühere Version einer App bereitstellen – die App-Version muss neuer sein als die aktuell bereitgestellte App. 1. Wählen Sie einen Einführungsplan aus und klicken Sie dann auf **Weiter**. 1. Wählen Sie Ihre bevorzugte Kiosk-App aus und klicken Sie dann auf **Weiter**. Dies ist die Standard-App, die beim Einschalten des Stripe Lesegeräts gestartet wird. 1. Bestätigen Sie die Bereitstellungsdetails und klicken Sie dann auf **Bereitstellen**. Die App wird sofort bereitgestellt. ### Auf der Registerkarte „Software“ 1. Wählen Sie auf der Registerkarte [Software](https://dashboard.stripe.com/terminal/software) die App aus, die Sie bereitstellen möchten. 1. Klicken Sie auf **Bereitstellen**. 1. Wählen Sie eine Version für jede App aus und klicken Sie dann auf **Weiter**. Sie können keine frühere Version einer App bereitstellen – die App-Version muss neuer sein als die aktuell bereitgestellte App. 1. Wählen Sie die Bereitstellungsgruppe aus und klicken Sie dann auf **Weiter**. 1. Wählen Sie einen Einführungsplan aus und klicken Sie dann auf **Weiter**. 1. Wählen Sie Ihre bevorzugte Kiosk-App aus und klicken Sie dann auf **Weiter**. Dies ist die Standard-App, die beim Einschalten des Stripe Lesegeräts gestartet wird. Wenn Sie nur eine App bereitstellen müssen, wählen Sie stattdessen diese aus. 1. Bestätigen Sie die Bereitstellungsdetails und klicken Sie dann auf **Bereitstellen**. Die App wird sofort bereitgestellt. ### Auf der Seite mit App-Details 1. Klicken Sie auf der Registerkarte [Software](https://dashboard.stripe.com/terminal/software) auf die App, die Sie bereitstellen möchten. 1. Klicken Sie auf der Seite mit App-Details auf **Version bereitstellen**. 1. Wählen Sie eine Version der genehmigten App und jede zusätzliche App, die Sie bereitstellen möchten, aus und klicken Sie dann auf **Weiter**. Sie können keine frühere Version einer App bereitstellen – die App-Version muss neuer sein als die aktuell bereitgestellte App. 1. Wählen Sie die Bereitstellungsgruppe aus und klicken Sie dann auf **Weiter**. 1. Wählen Sie einen Einführungsplan aus und klicken Sie dann auf **Weiter**. 1. Wählen Sie Ihre bevorzugte Kiosk-App aus und klicken Sie dann auf **Weiter**. Dies ist die Standard-App, die beim Einschalten des Stripe Lesegeräts gestartet wird. Wenn Sie nur eine App bereitstellen müssen, wählen Sie stattdessen diese aus. 1. Bestätigen Sie die Bereitstellungsdetails und klicken Sie dann auf **Bereitstellen**. Die App wird sofort bereitgestellt. > Wenn es Nutzer/innen in drei Versuchen nicht gelingt, ein Update auf einem Gerät zu installieren, können sie das Update verschieben, um weiter Zahlungen abzuwickeln. So wird dafür gesorgt, dass Nutzer/innen Zahlungsfunktionen bei technischen Problemen, die sich von ihnen nicht beheben lassen, aufrechterhalten können. ## Apps für mehrere Konten freigeben [Vertriebsmitarbeiter/in kontaktieren](https://stripe.com/contact/sales) um die Kompatibilität mit Ihrem Konto zu beurteilen und Zugriff auf diese Funktion zu erhalten. Verwenden Sie diese Funktion, wenn Sie mehrere Stripe-Konten haben und dieselbe App kontenübergreifend bereitstellen möchten. Durch die gemeinsame Nutzung einer App für mehrere Konten werden Einschränkungen durch die Eindeutigkeit des Paketnamens und doppelte App-Überprüfungen vermieden. Legen Sie ein Konto zum Erstellen und Verwalten der App fest. Nur das Konto, dem die App gehört, kann neue App-Versionen hochladen, aber andere Konten können die App anzeigen und bereitstellen, indem sie nach der App-ID suchen. 1. Klicken Sie auf der Registerkarte [Software](https://dashboard.stripe.com/terminal/software) auf das Überlaufmenü (⋯ Überlaufmenü). 1. Klicken Sie auf **Nach App suchen**. 1. Geben Sie die App-ID ein und klicken Sie auf **App-Details anzeigen**. 1. Klicken Sie auf **Bereitstellungsversion** und geben Sie die Bereitstellungsdetails ein. ## Best Practices für die Bereitstellungsgruppe Sie können die Geräte in verschiedene Bereitstellungsgruppen einteilen, um die Software unabhängig voneinander bereitzustellen und Fehler zu isolieren, falls Probleme auftreten. Je nach Tools, Risikotoleranz und spezifischen Geschäftsanforderungen können Sie weniger oder mehr Bereitstellungsgruppen einrichten. Wir empfehlen die folgende Einrichtung der Bereitstellungsgruppe: - **Alpha**: Enthält Speicherorte, die Ihren internen DevKits oder internen Produktionsgeräten entsprechen. - **Beta**: Enthält eine geringe Anzahl tatsächlicher Nutzerstandorte. Sie können diese Standorte nach dem Zufallsprinzip auswählen, sie anhand sinnvoller Kriterien auswählen (z. B. weniger riskante Standorte) oder Nutzer/innen basierend auf ihrer Risikobereitschaft in die `Beta`-Bereitstellungsgruppe aufnehmen lassen. - **Allgemein**: Enthält alle verbleibenden tatsächlichen Nutzerstandorte, mit Ausnahme derjenigen in den Gruppen `Alpha` oder `Beta`. Sie können eine Standard-Bereitstellungsgruppe verwenden, um zu vermeiden, dass jeder verbleibende Standort manuell zugewiesen werden muss. Wenn Ihre App bereit für die Bereitstellung ist, stufen Sie die Bereitstellungsgruppen von denjenigen mit dem geringsten Risiko zu denjenigen mit dem höchsten Risiko hoch: | | | | | - | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 1 | Alpha | Stellen Sie zunächst die App in der `Alpha`-Bereitstellungsgruppe bereit, um das Risiko für die Nutzer/innen so zu testen, dass das Risiko minimiert wird. Wenn ein Fehler oder ein unerwünschtes Verhalten in dieser Phase entdeckt wird, betrifft nur eine kleine Anzahl interner Geräte und nicht tatsächliche Nutzer/innen und echte Zahlungen. | | 2 | Beta | Führen Sie als nächstes die Bereitstellung für die Bereitstellungsgruppe `Beta` durch. Dies gleicht aus, dass Ihre App realen Nutzerinnen und Nutzern zur Verfügung gestellt wird und nicht alle Nutzer/innen potenziellen Problemen ausgesetzt werden. | | 3 | Allgemein | Stellen Sie abschließend die Bereitstellung in der `General`-Bereitstellungsgruppe durch, nachdem Sie alle Probleme behoben oder bestätigt haben, dass keine Probleme für die Bereitstellungsgruppe `Beta` vorhanden sind. | ## App in mehreren Schritten für eine Bereitstellungsgruppe bereitstellen Nachdem Sie Ihre Bereitstellungsgruppen eingerichtet haben, können Sie Ihre Anwendung mithilfe progressiver Bereitstellungen schrittweise für Lesegeräte innerhalb einer Bereitstellungsgruppe bereitstellen. Jede Stufe entspricht einem Prozentsatz der Lesegeräte der Bereitstellungsgruppe, der größer ist als der Prozentsatz der vorherigen Stufe, wobei die letzte Stufe immer bei 100 % liegt. Sie können einen unserer vordefinierten Pläne verwenden oder Ihren eigenen nutzerdefinierten Plan erstellen. ### Bereitstellung in mehreren Schritten planen So richten Sie eine stufenweise Bereitstellung ein: 1. Navigieren Sie zur gewünschten App-Detailseite, klicken Sie auf **Version bereitstellen**, wählen Sie dann die beabsichtigte App-Version aus und stellen Sie die Gruppe bereit. 1. Wählen Sie unter **Stufenweise Bereitstellungen** einen nutzerdefinierten oder vordefinierten Plan aus. - Nach dem Erstellen des Bereitstellungsplans können Sie den mit jeder Phase verknüpften Prozentsatz nicht mehr bearbeiten. 1. Bestätigen Sie Ihren Bereitstellungsplan und klicken Sie dann auf **Bereitstellen**. 1. Die Bereitstellung beginnt gemäß dem für die Anfangsphase angegebenen Prozentsatz. - Wenn Sie einen vordefinierten Plan ausgewählt haben, beginnt die Bereitstellung bei 0 %. Sie müssen manuell zur nächsten Stufe übergehen, damit alle Lesegeräte die neue Version der Terminal-App erhalten. 1. Um eine Bereitstellung voranzutreiben, klicken Sie auf der Detailseite der App unter **Bereitgestellte Gruppe** auf **Aktualisieren** oder auf der Detailseite der Bereitstellungsgruppe auf **Bereitstellung bearbeiten**. Bestätigen Sie den nächsten Schritt, um den Plan voranzubringen. 1. Um eine Bereitstellung zu unterbrechen, klicken Sie auf **Aktualisieren** (oder **Bereitstellung bearbeiten**, wenn Sie sich auf der Seite „Bereitstellungsgruppe“ befinden), um eine Schublade zu öffnen, und klicken Sie dann auf **Unterbrechen**. Dadurch wird die Einführung Ihrer Anwendung auf weitere Lesegeräte gestoppt. - Das Unterbrechen der Einführung betrifft keine Geräte, die die App bereits erhalten haben. Für Geräte, die gerade die neue App-Version herunterladen oder installieren, wird der Vorgang fortgesetzt. Bei Verwendung progressiver Bereitstellungen ist Folgendes zu beachten: - Bereitstellungen werden nicht automatisch erweitert. Wenn Sie den Bereitstellungsplan nie manuell weiterentwickeln, bleibt die Bereitstellung bei dem aktuellen Prozentsatz. - Die Lesegeräte werden innerhalb einer Bereitstellungsgruppe nach dem Zufallsprinzip ausgewählt und in eine Phase des stufenweisen Bereitstellungsplans einbezogen. Wenn beispielsweise Version 2.0 einer App derzeit für 40 % der Bereitstellungsgruppe A bereitgestellt wird, verfügen 40 % der Lesegeräte in der Bereitstellungsgruppe A über Version 2.0 der App und 60 % über die Version vor 2.0. - Mit fortschreitender Bereitstellung umfasst die Gruppe der Lesegeräte, die die neue Version erhalten, alle Lesegeräte, die diese in der vorherigen Phase erhalten haben. - Sie müssen jedes Mal, wenn Sie einen neuen Bereitstellungsplan erstellen, den gewünschten stufenweisen Bereitstellungsplan auswählen. Die Einführungsphasen bleiben zwischen alten und neuen Bereitstellungsplänen nicht erhalten. ## Nächster Schritt - [Ihre Bereitstellung überwachen](https://docs.stripe.com/terminal/features/apps-on-devices/monitor.md)