CodePush

  • Artikel

Wichtig

Visual Studio App Center wird am 31. März 2025 eingestellt. Sie können Visual Studio App Center zwar weiterhin verwenden, bis es vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie möglicherweise eine Migration in Erwägung ziehen.

Erfahren Sie mehr über Supportzeitpläne und Alternativen.

CodePush ist ein App Center-Clouddienst, mit dem React Native Entwickler mobile App-Updates direkt auf den Geräten ihrer Benutzer bereitstellen können. Es funktioniert als zentrales Repository, in dem Entwickler bestimmte Updates veröffentlichen können (z. B. JS-, HTML-, CSS- und Imageänderungen), und Apps können updates von (mit den bereitgestellten Client-SDKs) abfragen. Dadurch können Sie ein deterministischeres und direkteres Interaktionsmodell mit Ihren Endbenutzern haben, während Sie Fehler beheben, kleine Features hinzufügen, die keine Neuerstellung einer Binärdatei erfordern, oder die Verteilung über öffentliche App-Stores. Alle React Native Apps, die im App Center erstellt werden, sind standardmäßig CodePush aktiviert. Um codePush zu verwenden, benötigen Sie die folgenden Schritte:

Hinweis

Für Android-Geräte funktioniert CodePush nur auf TLS 1.2-kompatiblen Geräten.

Hinweis

Die CodePush-API-Nutzung hat eine Ratenbegrenzung von 8 Anforderungen pro 5 Minuten. Diese werden pro Kombination aus den folgenden Zählern gezählt: Angeforderter Endpunkt, IP-Anforderung stammt von, Bereitstellungsschlüssel und eindeutige Client-ID. Wenn der Grenzwert erreicht ist, wird die Antwort mit dem status Code 429 zurückgegeben:

{
   "statusCode": 429,
   "message": "Rate limit is exceeded. Try again in X seconds."
}

1. Installieren der App Center CLI

Sie verwalten die meisten Funktionen von CodePush mithilfe der App Center CLI. Um die CLI zu installieren, öffnen Sie ein Terminalfenster oder eine Eingabeaufforderung, und führen Sie den folgenden Befehl aus:

npm install -g appcenter-cli

Hinweis

Wenn Sie einen EACCES Fehler bei der Ausführung dieses Befehls feststellen, müssen Sie möglicherweise npm-Berechtigungen auf Ihrem System korrigieren. Viele Websites empfehlen die Verwendung des sudo Befehls, um diesen Fehler zu umgehen, aber Sie sollten npm-Module niemals mit sudoinstallieren.

Führen Sie nach der erfolgreichen Installation der App Center-CLI den appcenter login Befehl aus, um die CLI für Ihre App Center-Kontodetails zu konfigurieren.

2. CodePush-ify Ihre App

Fügen Sie Ihrer App das CodePush-Client-SDK hinzu, und konfigurieren Sie es so, dass App-Updates aus einer Ihrer Bereitstellungen im App Center abgerufen werden. Die folgenden Abschnitte enthalten Details dazu, wie dies für die unterstützten App-Plattformen zu tun ist:

3. Freigeben eines App-Updates

Nachdem Sie Änderungen am Code oder den Ressourcen Ihrer App vorgenommen haben, veröffentlichen Sie das Update in App Center mithilfe der App Center-CLI, wie in den folgenden Abschnitten beschrieben.

React Native

Führen Sie den App Center CLI-Befehl release-react aus, um die Code- und Assetdateien Ihrer App zu bündeln, und veröffentlichen Sie sie dann als neues Release auf dem App Center-Server. Beispiel:

appcenter codepush release-react -a <ownerName>/MyApp

Cordova

Führen Sie den App Center CLI-Befehl release-cordova aus, um die Code- und Assetdateien Ihrer App zu bündeln, und veröffentlichen Sie sie dann als neues Release auf dem App Center-Server. Beispiel:

appcenter codepush release-cordova -a <ownerName>/MyApp

Tipp

Ein wichtiges Feature in der App Center CLI ist die Möglichkeit, eine App mit appcenter apps set-current <ownerName>/<appName>als aktuelle App festzulegen. Wenn Sie eine App als aktuelle App festlegen, müssen Sie das -a Flag nicht verwenden. Der Befehl appcenter codepush deployment list -a <ownerName>/<appName> kann beispielsweise so eingegeben werden, als appcenter codepush deployment list ob die aktuelle App festgelegt ist. Mithilfe von können Sie überprüfen, welche App als aktuelle App appcenter apps get-currentIhres Kontos festgelegt ist. Wenn Sie diesen Befehl verwenden, verkürzen Sie die meisten CLI-Befehle.

4. Ausführen Ihrer App

Sobald diese Schritte abgeschlossen sind, erhalten alle Benutzer, die Ihre App ausführen, das Update mithilfe der Benutzeroberfläche, die Sie in Schritt 2 konfiguriert haben. Weitere Informationen finden Sie in der Dokumentation zum CLI- und Client-SDK (Apache Cordova, React Native).