Erste Schritte mit Apache Cordova

  • 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 eine Migration in Betracht ziehen können.

Erfahren Sie mehr über Supportzeitpläne und Alternativen.

Hinweis

Der Support für Cordova-Apps wurde im April 2022 eingestellt. Weitere Informationen finden Sie im App Center-Blog.

Das App Center SDK verwendet eine modulare Architektur, sodass Sie auf einfache Weise einen, mehrere oder alle App Center-Dienste in Ihrer Apache Cordova-Anwendung verwenden können.

In diesem Artikel erfahren Sie, wie Sie Das App Center SDK Zu Ihren Apache Cordova-Anwendungen hinzufügen und dann app Center Analytics- und App Center-Absturzfunktionen in einer Anwendung konfigurieren.

1. Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Ihr Apache Cordova-Anwendungsprojekt die folgenden Mindestanforderungen erfüllt:

  • Cordova CLI 6.4.0 oder höher
  • cordova-android Engine 5.0.0 oder höher
  • cordova-ios Engine 4.3.0 oder höher

Um Ihre Cordova CLI-Version zu ermitteln, öffnen Sie ein Terminalfenster oder eine Windows-Eingabeaufforderung, und führen Sie den folgenden Befehl aus:

cordova -v

Um die cordova-android Versionen und cordova-ios zu ermitteln, öffnen Sie die config.xml-Datei des Projekts. Sie finden die Plattform-Engines, die in den engine unten gezeigten Elementen definiert sind:

<engine name="android" spec="~6.2.3" />
<engine name="ios" spec="~4.4.0" />

Außerdem müssen CocoaPods installiert sein. Führen Sie dazu aus. sudo gem install cocoapodspod setup

2. Abrufen des App Center-App-Geheimnisses

Damit das App Center SDK eine Verbindung mit Ihrem Anwendungsprojekt in App Center herstellen kann, benötigt das SDK das App-Geheimnis Ihres App Center-Projekts. Sie erfahren später, wie Sie das App Center Apache Cordova SDK mit diesem Wert konfigurieren, aber vorerst sehen wir uns an, wo sie zu finden sind.

Wenn Sie über ein vorhandenes App Center-Anwendungsprojekt verfügen, greifen Sie auf das App Center-Dashboard zu, und öffnen Sie Ihr Projekt. Sie können das App-Geheimnis auch auf der Seite Einstellungen des Anwendungsprojekts verwenden . Greifen Sie auf das Menü in der oberen rechten Ecke der Seite zu, und wählen Sie dann App-Geheimnis kopieren aus, um das App-Geheimnis in die Zwischenablage zu kopieren.

Wenn Sie keine Anwendung im App Center-Dashboard erstellt haben, führen Sie die folgenden Schritte aus.

  1. Registrieren Sie sich für ein App Center-Konto, oder melden Sie sich bei einem vorhandenen App Center-Konto unter an https://appcenter.ms.
  2. Klicken Sie im App Center-Dashboard in der oberen rechten Ecke der Seite auf die Dropdownliste Neu hinzufügen . Wählen Sie im Menü Die Option Neue App hinzufügen aus.
  3. Geben Sie einen Namen für Ihr Anwendungsprojekt ein, und fügen Sie bei Bedarf eine optionale Beschreibung hinzu.
  4. Wählen Sie das geeignete Betriebssystem für Ihr Anwendungsprojekt aus (nur Android oder iOS), und wählen Sie dann die Option Cordova-Plattform aus.
  5. Klicken Sie in der unteren rechten Ecke der Seite auf die Schaltfläche Neue App hinzufügen .
  6. Suchen Sie das App-Geheimnis auf der Seite Einstellungen des Anwendungsprojekts. Greifen Sie auf das Menü in der oberen rechten Ecke der Seite zu, und wählen Sie dann das Element App-Geheimnis kopieren aus, um das App-Geheimnis in die Zwischenablage zu kopieren.

3. Hinzufügen des App Center SDK zum Projekt

Installieren des SDK

Für Apache Cordova-Projekte wird das SDK über Apache Cordova-Standard-Plug-Ins verteilt. Fügen Sie das App Center SDK ihrem Cordova-Projekt mithilfe der Anweisungen in diesem Abschnitt hinzu. Öffnen Sie zunächst ein Terminalfenster oder eine Windows-Eingabeaufforderung, und navigieren Sie dann zum Stammordner Ihres Cordova-Projekts.

Um Ihrem Projekt Unterstützung für App Center Analytics hinzuzufügen, führen Sie den folgenden Befehl aus:

cordova plugin add cordova-plugin-appcenter-analytics

Führen Sie den folgenden Befehl aus, um Ihrem Projekt Unterstützung für App Center-Abstürze hinzuzufügen:

cordova plugin add cordova-plugin-appcenter-crashes

Führen Sie den folgenden Befehl aus, um Ihrem Projekt Plug-Ins für alle App Center-Funktionen mit einem Befehl hinzuzufügen:

cordova plugin add cordova-plugin-appcenter-analytics cordova-plugin-appcenter-crashes

Hinweis

Sie sollten cordova-plugin-appcenter-analytics und cordova-plugin-appcenter-crashes die meisten Apps hinzufügen, die App Center verwenden. sie bieten nützliche Informationen für Entwickler ohne zusätzliche Einrichtung oder Codierung.

Konfigurieren der Plug-Ins

App-Geheimnis

Sie müssen das Projekt mit Ihrem App Center-Projekt-App-Geheimnis konfigurieren, bevor Sie das App Center SDK in Ihrem Apache Cordova-Projekt verwenden können.

Öffnen Sie die dateiconfig.xml des Apache Cordova-Projekts. Fügen Sie für jedes Zielelement platform Ihres Apache Cordova-Projekts (derzeit nur Android und iOS) ein untergeordnetes preference Element im folgenden Format hinzu:

<preference name="APP_SECRET" value="0000-0000-0000-0000-000000000000" />

In diesem Beispiel fügen Sie ein Element mit einem name Attribut mit dem Wert und APP_SECRETein Attribut mit dem im Beispiel gezeigten Wert hinzu value . Hier ist die 0000-0000-0000-0000-000000000000 im Beispiel gezeigte eine beliebige Darstellung eines App Center-Projekt-App-Geheimnisses. Ersetzen Sie das im Beispiel gezeigte App-Geheimnis durch das tatsächliche App-Geheimnis für Ihr App Center-Projekt.

Als vollständiges Beispiel für ein Apache Cordova-Projekt, das sowohl Android- als auch iOS-Ziele unterstützt, verfügen Sie über separate App-Projektdefinitionen in App Center und damit unterschiedliche App-Geheimniswerte für jede Zielplattform. Der relevante Abschnitt der config.xml-Datei des Projekts sieht wie folgt aus:

<platform name="android">
   <preference name="APP_SECRET" value="0000-0000-0000-0000-000000000001" />
</platform>
<platform name="ios">
   <preference name="APP_SECRET" value="0000-0000-0000-0000-000000000002" />
</platform>

Hinweis

Im Beispiel werden keine tatsächlichen App-Geheimniswerte angezeigt. Hierbei handelt es sich lediglich um Simulierte. Sie müssen die App-Geheimnisse Ihres App Center-Projekts abrufen und hier verwenden. Die App-Geheimnisse unterscheiden sich, da Sie in App Center über einzigartige Geheimnisse für Ihre Android- und iOS-Anwendungsprojekte verfügen.

Analyseeinstellungen

Wenn Sie App Center Analytics in Ihrer App verwenden, müssen einige zusätzliche Konfigurationsschritte ausgeführt werden. Öffnen Sie die config.xml-Datei des Apache Cordova-Projekts in einem Editor, und fügen Sie der Datei eines oder mehrere der folgenden preferences Elemente hinzu:

  • APPCENTER_ANALYTICS_ENABLE_IN_JS - (optional, Standardwert ist false) Steuert, ob Analytics automatisch aktiviert wird. Wenn false, ist Analytics standardmäßig aktiviert. Wenn true, muss die Anwendung (in ihrem JavaScript-Code) aufrufen AppCenter.Analytics.setEnabled(true) , um Analytics zu aktivieren, bevor Daten an App Center gesendet werden. Diese Einstellung ist nützlich, wenn Sie Benutzer fragen möchten, ob sie Analyseinformationen freigeben möchten, bevor Sie sie in der Anwendung aktivieren. Erfahren Sie mehr über das manuelle Senden von Benutzerereignissen.

    Beispiel:

    <preference name="APPCENTER_ANALYTICS_ENABLE_IN_JS" value="true" />

  • APPCENTER_CRASHES_ALWAYS_SEND - (optional, Standardwert ist true) Gibt an, ob Absturzberichte automatisch an App Center gesendet werden, wenn die App abstürzt. Beim automatischen Senden von Absturzberichten wird jeder Absturz gemeldet, was die Engineering- und Supportteams potenziell überfordert. Beim manuellen Senden von Absturzberichten (Einstellung APPCENTER_CRASHES_ALWAYS_SEND auf false) kann Code in Ihrer Anwendung Abstürze selektieren und entscheiden, wann Absturzberichte an App Center gesendet werden, welche Daten in den Berichten enthalten sind usw. Dies bedeutet mehr Arbeit für den Entwickler, bietet aber auch eine bessere Kontrolle über den Datenschutz der Benutzer und ermöglicht es Ihnen, eine Nachricht mit einem Absturzbericht anzufügen. Erfahren Sie mehr über die Verarbeitung von Absturzberichten in JS.

    Beispiel:

    <preference name="APPCENTER_CRASHES_ALWAYS_SEND" value="false" />

    Wenn Sie die automatische Sicherung verwenden, um falsche Geräteinformationen zu vermeiden, führen Sie die nächsten Schritte aus:

Hinweis

Für Apps mit Android 6.0 (API-Ebene 23) oder höher ist die automatische Sicherung automatisch aktiviert. 

Hinweis

Wenn Sie bereits über eine benutzerdefinierte Datei mit Sicherungsregel verfügen, wechseln Sie zum dritten Schritt.

a. Erstellen Sie appcenter_backup_rule.xml Datei im Ordner res/xml .

<resource-file src="appcenter_backup_rule.xml" target="res/xml/appcenter_backup_rule.xml" />

b. Damit android:fullBackupContent dem <application> -Element in AndroidManifest.xml Datei attribut hinzugefügt wird, fügen Sie der config.xml-Datei der App die folgenden Zeilen hinzu:

<edit-config file="app/src/main/AndroidManifest.xml" mode="merge" target="/manifest/application">
     <application android:fullBackupContent="@xml/appcenter_backup_rule" />
</edit-config>
 ```

c. Add the following backup rules to the **appcenter_backup_rule.xml** file:

```xml
<full-backup-content xmlns:tools="http://schemas.android.com/tools">
   <exclude domain="sharedpref" path="AppCenter.xml"/>
   <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
   <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
   <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
   <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
</full-backup-content>

4. Wohin gehen Sie als Nächstes?

Großartig, Sie können alle Die Analyse- und Absturzdaten visualisieren, die automatisch vom SDK im Portal gesammelt werden. Es ist kein zusätzliches Setup erforderlich. In den Abschnitten Analyse und Abstürze finden Sie APIs-Leitfäden und exemplarische Vorgehensweisen, um zu erfahren, was App Center tun kann.