Veröffentlichen einer Android-App für die Google Play-Verteilung

• Veröffentlichen für Ad-hoc-Verteilung
• Mit der Befehlszeile veröffentlichen

Der am häufigsten verwendete Ansatz für die Verteilung von Android-Apps an Benutzer erfolgt über google Play. Wenn eine App zum ersten Mal an Google Play übermittelt wird, muss sie über die Google Play-Konsole übermittelt werden. Nachfolgende Versionen der App können über Visual Studio übermittelt werden. In beiden Fällen ist ein Google Play Developer-Konto erforderlich. An Google Play übermittelte Apps erfordern eine Genehmigung von Google.

Um eine .NET Multi-Platform App UI (.NET MAUI) Android-App zu verteilen, müssen Sie sie vor dem Hochladen in Google Play mit einem Schlüssel aus Ihrem Keystore signieren. Keystores sind Binärdateien, die als Repositorys von Zertifikaten und privaten Schlüsseln dienen.

Google Play erfordert, dass Sie Ihre App als Android App Bundle (AAB) übermitteln. Google Play verwendet Ihr App-Bündel zum Generieren und Bedienen optimierter Android-Pakete (APK) für jede Gerätekonfiguration, sodass nur der code und die Ressourcen, die für ein bestimmtes Gerät benötigt werden, heruntergeladen werden, um Ihre App auszuführen. Weitere Informationen zu Android-App-Bundles finden Sie auf der Seite Über Android-App-Bundles auf developer.android.com.

Der Prozess für die Verteilung einer .NET MAUI Android-App über Google Play lautet wie folgt:

1. Erstellen Sie ein Google Play-Entwicklerkonto. Weitere Informationen finden Sie unter Erstellen eines Google Play-Entwicklerkontos.
2. Erstellen Sie Ihre App in der Google Play-Konsole. Weitere Informationen finden Sie unter Erstellen Ihrer App in der Google Play Console.
3. Richten Sie Ihre App in der Google Play-Konsole ein. Weitere Informationen finden Sie unter Einrichten Ihrer App in der Google Play Console.
4. Stellen Sie sicher, dass Ihre App das richtige Paketformat verwendet. Weitere Informationen finden Sie unter Sicherstellen des richtigen Paketformats.
5. Erstellen Und signieren Sie Ihre App in Visual Studio, und verteilen Sie sie dann über die Google Play-Konsole. Weitere Informationen finden Sie unter Verteilen Sie Ihre App über die Google Play Console.

Anschließend können nachfolgende Versionen Ihrer App über Visual Studio veröffentlicht werden. Weitere Informationen finden Sie unter Verteilung Ihrer App über Visual Studio.

Erstellen eines Google Play-Entwicklerkontos

Um Android-Apps auf Google Play zu veröffentlichen, müssen Sie ein Google Play-Entwicklerkonto erstellen:

1. Melden Sie sich mit Ihrem Google-Konto für ein Google Play Developer-Kontoan.
2. Geben Sie Informationen zu Ihrer Entwickleridentität ein.
3. Während des Anmeldevorgangs müssen Sie den Google Play Developer Distribution Agreementüberprüfen und akzeptieren.
4. Zahlen Sie die einmalige Registrierungsgebühr von $25.
5. Überprüfen Sie Ihre Identität, indem Sie die Anweisungen in Ihrer Überprüfungs-E-Mail befolgen.

Wichtig

Die Identitätsüberprüfung muss abgeschlossen sein, bevor Sie Apps über Google Play veröffentlichen können. Darüber hinaus müssen neue Inhaber von persönlichen Konten überprüfen, ob sie Zugriff auf ein echtes Android-Gerät haben. Weitere Informationen finden Sie unter Geräteüberprüfungsanforderungen für neue Entwicklerkonten für support.google.com.

Nachdem Ihr Google Play-Entwicklerkonto erstellt wurde, können Sie mit dem Vorgang beginnen, eine App in Google Play zu veröffentlichen.

Weitere Informationen finden Sie unter Registrieren für ein Google Play Developer-Konto auf support.google.com.

Erstellen Ihrer App in der Google Play-Konsole

Nachdem Sie Ihr Google Play-Entwicklerkonto erstellt haben, müssen Sie eine App in der Google Play-Konsole erstellen:

1. Melden Sie sich bei Ihrem Google Play Developer-Kontoan.

2. Wählen Sie in Google Play Consoleauf der Registerkarte Alle Apps die Schaltfläche App erstellen aus:

   

3. Geben Sie auf der Seite App- erstellen Ihre App-Details ein, und wählen Sie die Schaltfläche App- erstellen aus:

   

Weitere Informationen zum Erstellen einer App in der Google Play-Konsole finden Sie unter Erstellen und Einrichten Ihrer App- auf support.google.com.

Einrichten Ihrer App in der Google Play-Konsole

Nachdem Sie Ihre App erstellt haben, sollten Sie sie einrichten. Das Dashboard Ihrer App führt Sie durch alle wichtigsten Schritte.

Um die Einrichtung Ihrer App zu starten, wählen Sie im linken Menü Dashboard- aus. Unter den Details Ihrer App am oberen Rand der Seite finden Sie unterschiedliche Kategorien und Aufgaben im Zusammenhang mit der App-Einrichtung und -Freigabe. Sie müssen die obligatorischen Aufgaben ausführen, bevor Sie Ihre App auf Google Play starten können. Wenn Sie eine Aufgabe abschließen, sehen Sie einen grünen Haken und durchgestrichenen Text. Die Statusleiste oben im Abschnitt wird ebenfalls aktualisiert. Weitere Informationen finden Sie unter Einrichten Ihrer App im App-Dashboard auf support.google.com.

Sicherstellen des richtigen Paketformats

Um eine .NET MAUI Android-App für die Google Play-Verteilung zu veröffentlichen, muss das App-Paketformat AAB sein, das das Standardpaketformat für Releasebuilds ist. So überprüfen Sie, ob das Paketformat Ihrer App korrekt festgelegt ist:

1. Klicken Sie im Projektmappen-Explorer von Visual Studio mit der rechten Maustaste auf Ihr .NET MAUI-App-Projekt, und wählen Sie Eigenschaftenaus. Navigieren Sie dann zur Registerkarte Android > Optionen, und stellen Sie sicher, dass der Wert des Felds Release auf Bundle-festgelegt ist:

   Veröffentlichen

Verteilen Ihrer App über die Google Play-Konsole

Wenn ein AAB zum ersten Mal an Google Play übermittelt wird, muss es manuell über die Google Play-Konsole hochgeladen werden. Auf diese Weise kann Google Play die Signatur des Schlüssels auf allen zukünftigen Bündeln mit dem ursprünglichen Schlüssel abgleichen, der für die erste Version der App verwendet wird. Um die App über die Google Play-Konsole hochzuladen, muss sie zuerst erstellt und in Visual Studio angemeldet sein.

So erstellen und signieren Sie Ihre App in Visual Studio:

1. Verwenden Sie in der Visual Studio-Symbolleiste die Dropdownliste Debug-Ziel, um Android-Emulatoren auszuwählen und dann Ihren gewünschten Emulator:

   

2. Verwenden Sie in der Visual Studio-Symbolleiste die Dropdownliste Lösungskonfiguration, um von der Debugkonfiguration zur Releasekonfiguration zu wechseln:

   

3. Klicken Sie im Projektmappen-Explorermit der rechten Maustaste auf Ihr .NET MAUI-App-Projekt, und wählen Sie Veröffentlichen...aus:

   

   Der Archiv-Manager wird geöffnet, und Visual Studio beginnt mit der Archivierung Ihres App-Bündels:

   

4. Stellen Sie im Archiv-Managersicher, dass das Archiv ausgewählt ist, und wählen Sie dann die Schaltfläche Verteilen aus, um mit dem Verteilen Ihrer App zu beginnen.

   

   Das Dialogfeld Verteilen – Kanal auswählen wird angezeigt.

5. Im Dialogfeld "Verteilen - Kanal auswählen" wählen Sie die Schaltfläche "Ad Hoc" aus:

   

6. Wählen Sie im Dialogfeld Verteilen – Signaturidentität die Schaltfläche + aus, um eine neue Signaturidentität zu erstellen:

   

   Das Dialogfeld Android Keystore erstellen wird angezeigt.

   Anmerkung

   Alternativ kann eine vorhandene Signaturidentität verwendet werden, indem Sie die Schaltfläche Importieren auswählen.

7. Geben Sie im Dialogfeld Android Keystore- die erforderlichen Informationen ein, um eine neue Signaturidentität zu erstellen, die als keystore-bezeichnet wird, und wählen Sie dann die Schaltfläche Erstellen aus:

   • Alias. Geben Sie einen identifizierenden Namen für Ihren Schlüssel ein.
   • Passwort. Erstellen und bestätigen Sie ein sicheres Kennwort für Ihren Schlüssel.
   • Gültigkeit. Legen Sie die Dauer in Jahren fest, die Ihr Schlüssel gültig ist.
   • Vollständiger Name, Organisationseinheit, Organisation, Stadt oder Ort, Bundesland oder Provinz und Ländercode. Diese Informationen werden nicht in Ihrer App angezeigt, sondern in Ihrem Zertifikat enthalten.

   

   Ein neuer Keystore, der ein neues Zertifikat enthält, wird in C:\Users{Username}\AppData\Local\Xamarin\Mono für Android\Keystore{Alias}{Alias}.keystoregespeichert.

   Wichtig

   Der Schlüsselspeicher und das Kennwort werden nicht in Ihrer Visual Studio-Lösung gespeichert. Stellen Sie daher sicher, dass Sie diese Daten sichern. Wenn Sie sie verlieren, können Sie Ihre App nicht mit derselben Signaturidentität signieren.

8. Wählen Sie im Dialogfeld Verteilen – Signaturidentität Ihre neu erstellte Signaturidentität aus, und wählen Sie die Schaltfläche Speichern unter aus:

   

   Der Archiv-Manager zeigt den Veröffentlichungsprozess an.

9. Bestätigen Sie im Dialogfeld "Speichern unter", ob der Speicherort und der Dateiname für Ihr Paket korrekt sind, und wählen Sie die Schaltfläche Speichern aus.

10. Geben Sie im Dialogfeld Signaturkennwort Ihr Signaturidentitätskennwort ein, und wählen Sie die Schaltfläche OK aus:

    

11. Wählen Sie im Archiv-Managerdie Schaltfläche Öffnen der Verteilung aus, sobald der Veröffentlichungsprozess abgeschlossen ist.

    

    Visual Studio öffnet den Ordner mit der veröffentlichten App.

Die veröffentlichte App kann dann über die Google Play-Konsole im Google Play Store bereitgestellt werden. Dazu müssen Sie zuerst eine Version in der Google Play-Konsole erstellen. Eine Version ist eine Kombination aus einer oder mehreren App-Versionen, die Sie vorbereiten, um eine App zu starten oder ein Update einzuführen. Sie können eine Version in den folgenden Tracks veröffentlichen:

• Internes Testen. Interne Testversionen sind für bis zu 100 Tester verfügbar, die Sie auswählen können.
• Geschlossene Tests. Geschlossene Testversionen sind für eine begrenzte Anzahl von Testern verfügbar, die Sie auswählen, wer eine Vorabversion Ihrer App testen und Feedback übermitteln kann.
• Offene Tests. Offene Testversionen sind für Tester auf Google Play verfügbar. Benutzer können über Ihren Store-Eintrag an Tests teilnehmen.
• Produktion. Produktionsversionen sind für alle Google Play-Benutzer in Ihren ausgewählten Ländern verfügbar.

Weitere Informationen zum Erstellen einer Version in der Google Play Console finden Sie unter Vorbereiten und Bereitstellen einer Version auf support.google.com.

Wichtig

Die an Google Play übermittelte App wird in der Regel einem Überprüfungsprozess unterzogen. Weitere Informationen finden Sie unter Vorbereiten der App für die Überprüfung und Veröffentlichen Der App- auf support.google.com.

Verteilen Ihrer App über Visual Studio

Ein AAB muss bereits an Google Play übermittelt und überprüft worden sein, bevor Sie es aus Visual Studio verteilen können. Wenn Sie versuchen, ein AAB aus Visual Studio zu verteilen, das nicht zuerst aus der Wiedergabekonsole hochgeladen wurde, wird die folgende Fehlermeldung angezeigt:

Google Play erfordert, dass Sie Ihr erstes Paket (APK/AAB) für diese App manuell hochladen. Hierfür können Sie ein Ad-hoc-Paket verwenden.

Wenn dieser Fehler auftritt, laden Sie ein AAB manuell über die Google Play-Konsole hoch. Nachfolgende Versionen der App können dann über Visual Studio veröffentlicht werden. Sie müssen jedoch den Versionscode der App für jeden Upload ändern, andernfalls tritt der folgende Fehler auf:

Ein AAB mit Versionscode (1) wurde bereits hochgeladen.

Um diesen Fehler zu beheben, erstellen Sie die App mit einer anderen Versionsnummer neu, und übermitteln Sie sie dann über Visual Studio erneut an Google Play.

Anmerkung

Die Versionsnummer der App kann aktualisiert werden, indem der Wert der ApplicationVersion ganzzahligen Eigenschaft in der Projektdatei der App erhöht wird.

Wenn Sie Ihre App von Visual Studio auf Google Play hochladen, müssen Sie zuerst den API-Zugriff in der Google Play-Konsole einrichten.

Aktivieren des Google-API-Zugriffs

Mit der Google Play Developer Publishing-API kann Visual Studio neue Versionen einer App auf Google Play hochladen. Bevor Visual Studio MIT API-Aufrufen beginnen kann, müssen Sie den API-Zugriff in Ihrem Google Play-Entwicklerkonto einrichten. Dies umfasst das Verknüpfen Ihres Google Play Developer-Kontos mit einem Google Cloud-Projekt und das Konfigurieren des Zugriffs auf die Google Play Developer Publishing-API mit einem OAuth-Client.

So aktivieren Sie den Google-API-Zugriff:

1. Melden Sie sich bei Ihrem Google Play Developer-Kontoan.

2. Erweitern Sie in Google Play Consoledas Setup Element, und wählen Sie API-Zugriffaus. Wählen Sie dann auf der Seite API-Zugriff die Schaltfläche Projekt zum Verknüpfen auswählen.

   

   Um Google Play-Entwickler-APIs zu verwenden, benötigen Sie ein Google Cloud-Projekt, das mit Ihrem Google Play Developer-Konto verknüpft sein muss.

   Anmerkung

   Ein Google Play Developer-Konto kann nur mit einem einzelnen Google Cloud-Projekt verknüpft werden. Wenn Sie also mehrere Apps aus einem Google Play-Entwicklerkonto veröffentlichen, müssen sie alle dasselbe Google Cloud-Projekt nutzen.

3. Wählen Sie auf der Seite API-Zugriff das Optionsfeld Neues Google Cloud-Projekt erstellen aus, und klicken Sie anschließend auf die Schaltfläche Speichern.

   

   Ein neues Google Cloud-Projekt wird erstellt und mit Ihrem Google Play Developer-Konto verknüpft.

4. Wählen Sie auf der Seite API-Zugriff im Abschnitt OAuth-Clients die Option OAuth-Zustimmungsbildschirm konfigurierenaus.

   

5. Wählen Sie auf der Seite OAuth-Zustimmungsbildschirm das Optionsfeld für den erforderlichen Benutzertyp aus und klicken Sie dann auf die Schaltfläche ERSTELLEN.

   

   Weitere Informationen zu den Benutzertypen finden Sie unter Benutzertyp für support.google.com.

6. Füllen Sie auf der Seite zur Bearbeitung der App-Registrierung die als erforderlich gekennzeichneten Felder aus und wählen Sie dann die Schaltfläche SPEICHERN UND FORTFAHREN aus.

   

7. Wählen Sie auf der Seite App-Registrierung bearbeiten die Schaltfläche BEREICH HINZUFÜGEN ODER ENTFERNEN aus:

   

8. Wählen Sie im Flyout 'Ausgewählte Bereiche aktualisieren' den Bereich ./auth/androidpublisher in der Tabelle aus und klicken Sie dann auf die Schaltfläche 'AKTUALISIEREN' .

   

   Anmerkung

   Die anderen Bereiche in der Tabelle können optional ausgewählt werden, da sie Standardbereiche sind.

9. Wählen Sie auf der Seite Bearbeiten der App-Registrierung die Registerkarte Anmeldeinformationen aus:

   

10. Wählen Sie auf der Seite Anmeldeinformationen die Schaltfläche + Anmeldeinformationen erstellen und dann das OAuth-Client-ID Element aus:

    

11. Wählen Sie auf der Seite "OAuth-Client-ID erstellen" im Dropdown-Menü Anwendungstyp die Option Desktop-App aus, geben Sie im Feld NameVisual Studio ein, und klicken Sie dann auf die Schaltfläche ERSTELLEN:

    

12. Wählen Sie im Dialogfeld , das für den OAuth-Client erstellt wurde, die Schaltfläche JSON-Daten herunterladen aus, um die Client-ID und das Client-Secret herunterzuladen. Dies wird später erforderlich sein. Klicken Sie dann auf die Schaltfläche OK, um das Dialogfeld zu schließen.

Weitere Informationen zum Aktivieren des Google-API-Zugriffs auf Ihr Google Play-Entwicklerkonto finden Sie unter Erste Schritte auf developers.google.com. Weitere Informationen zum Einrichten Ihres OAuth-Zustimmungsbildschirms finden Sie unter Einrichten ihres OAuth-Zustimmungsbildschirms auf support.google.com.

Hochladen Ihrer App über Visual Studio

So erstellen und signieren Sie Ihre App in Visual Studio:

1. Verwenden Sie in der Visual Studio-Symbolleiste die Dropdownliste Debug-Ziel, um Android-Emulatoren und dann den ausgewählten Emulator auszuwählen.

   

2. Verwenden Sie in der Visual Studio-Symbolleiste die Dropdownliste Lösungskonfiguration, um von der Debugkonfiguration zur Releasekonfiguration zu wechseln:

   

3. Klicken Sie im Projektmappen-Explorermit der rechten Maustaste auf Ihr .NET MAUI-App-Projekt, und wählen Sie Veröffentlichen...aus:

   

   Der Archiv-Manager wird geöffnet, und Visual Studio beginnt mit der Archivierung Ihres App-Bündels:

   

4. Sobald das Archivieren erfolgreich abgeschlossen ist, stellen Sie im Archiv-Managersicher, dass Ihr Archiv ausgewählt ist, und wählen Sie dann die Schaltfläche Verteilen ... aus, um mit dem Verteilen Ihrer App zu beginnen:

   

   Das Dialogfeld Verteilen – Kanal auswählen wird angezeigt.

5. Wählen Sie im Dialogfeld Verteilen – Kanal auswählen die Schaltfläche Google Play aus:

   

6. Wählen Sie im Dialogfeld Verteilen - Signierungsidentität die Signaturidentität aus, die Sie beim Erstellen der App für die Verteilung über die Google Play-Konsole erstellt haben, und wählen Sie dann die Schaltfläche Weiter aus:

   

Hinzufügen ihrer Google Play-Entwicklerkontodetails

So fügen Sie Ihr Google Play-Entwicklerkonto zu Visual Studio hinzu:

1. Wählen Sie im Dialogfeld Verteilen - Google Play-Konto die Schaltfläche + aus, um Die Details Ihres Google Play-Entwicklerkontos hinzuzufügen:

   

2. Geben Sie im Dialogfeld Registrieren von Google API Access eine Beschreibung und Ihre OAuth-Client-ID und ihren geheimen Clientschlüssel ein, und klicken Sie dann auf die Schaltfläche Registrieren:

   

   Anmerkung

   Die Kontobeschreibung ermöglicht es, mehr als ein Google Play Developer-Konto zu registrieren und Apps auf verschiedene Google Play Developer-Konten hochzuladen.

   Ein Webbrowser wird geöffnet.

3. Melden Sie sich im Webbrowser bei Ihrem Google Play-Entwicklerkonto an. Nachdem Sie sich angemeldet haben, wird möglicherweise eine Meldung angezeigt, die Besagt, dass Google die App nicht überprüft hat. Wenn dies geschieht, wählen Sie die Schaltfläche Weiter aus:

   

4. Wählen Sie im Webbrowser die Schaltfläche Weiter aus, um die App zu autorisieren:

   

   Der Webbrowser erhält einen Überprüfungscode.

   Wichtig

   Schließen Sie den Webbrowser nicht.

5. Wählen Sie in Visual Studio im Dialogfeld "Verteilen – Google Play-Konto" "Weiter" aus:

   

Wählen Sie einen Kanal aus, um Ihre App hochzuladen.

So wählen Sie den Google Play-Veröffentlichungspfad aus, um Ihre App hochzuladen:

1. Wählen Sie im Dialogfeld Verteilen – Google Play Track den Titel aus, in den Ihre App hochgeladen werden soll. Google Play bietet fünf Titel zum Hochladen Ihrer App:

   • Der interne Vertrieb sollte verwendet werden, um Ihre App schnell für interne Tests und Qualitätssicherung zu verteilen.
   • Alpha sollte zum Hochladen einer frühen Version Ihrer App in eine kleine Gruppe von Testern verwendet werden.
   • Beta sollte zum Hochladen einer frühen Version Ihrer App in eine größere Gruppe von Testern verwendet werden.
   • Die Produktion sollte für die vollständige Verteilung an den Google Play Store verwendet werden.
   • Benutzerdefiniert sollte zum Testen von Vorabversionen Ihrer App mit bestimmten Benutzern verwendet werden, indem sie eine Liste von Testern nach E-Mail-Adresse erstellen.

   Wichtig

   Wenn der benutzerdefinierte Titel nicht angezeigt wird, stellen Sie sicher, dass Sie in der Google Play-Konsole eine Version für diesen Titel erstellt haben. Weitere Informationen finden Sie unter Vorbereiten und Bereitstellen einer Version auf support.google.com.

   Wählen Sie den Track aus, in den Sie Ihre App hochladen möchten, und wählen Sie dann die Schaltfläche Hochladen aus:

   

   Weitere Informationen zu Google Play-Tests finden Sie unter Einrichten eines offenen, geschlossenen oder internen Test- auf support.google.com.

2. Visual Studio beginnt mit der Veröffentlichung Ihrer App in Google Play. Geben Sie im Dialogfeld Signaturkennwort Ihr Kennwort ein, das Sie für die Signaturidentität erstellt haben, und wählen Sie die Schaltfläche OK aus:

   

   Visual Studio signiert Ihr App-Bündel und lädt es in Google Play hoch.

   Wichtig

   Die an Google Play übermittelte App wird in der Regel einem Überprüfungsprozess unterzogen. Weitere Informationen finden Sie unter Vorbereiten der App für die Überprüfung und Veröffentlichen Der App- auf support.google.com.