Introduzione ad Apache Cordova

Importante

Visual Studio App Center è previsto per il ritiro il 31 marzo 2025. Anche se è possibile continuare a usare Visual Studio App Center fino a quando non viene completamente ritirato, esistono diverse alternative consigliate che è possibile considerare la migrazione a.

Altre informazioni sulle sequenze temporali di supporto e sulle alternative.

• Android
• iOS
• Estensioni iOS
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• Estensioni macOS
• tvOS
• Cordova

Nota

Il supporto per le app Cordova è terminato nell'aprile 2022. Per altre informazioni, vedere il blog di App Center.

App Center SDK usa un'architettura modulare in modo da poter usare facilmente uno, diversi o tutti i servizi di App Center nell'applicazione Apache Cordova.

In questo articolo si apprenderà come aggiungere App Center SDK alle applicazioni Apache Cordova, quindi configurare le funzionalità di App Center Analytics e App Center Arresti anomali in un'applicazione.

1. Prerequisiti

Prima di iniziare, assicurarsi che il progetto dell'applicazione Apache Cordova soddisfi i requisiti minimi seguenti:

• Interfaccia della riga di comando di Cordova 6.4.0 o versione successiva
• cordova-android motore 5.0.0 o versione successiva
• cordova-ios motore 4.3.0 o versione successiva

Per determinare la versione dell'interfaccia della riga di comando di Cordova, aprire una finestra del terminale o un prompt dei comandi di Windows ed eseguire il comando seguente:

cordova -v

Per determinare le cordova-android versioni e cordova-ios , aprire il file diconfig.xml del progetto, i motori della piattaforma definiti negli engine elementi indicati di seguito:

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

È anche necessario che CocoaPods sia installato. Per questa operazione, eseguire sudo gem install cocoapodspod setup

2. Ottenere il segreto dell'app di App Center

Per consentire all'SDK di App Center di connettersi al progetto dell'applicazione in App Center, l'SDK necessita del segreto app del progetto App Center. Si apprenderà più avanti come configurare App Center Apache Cordova SDK con questo valore, ma per il momento, consente di vedere dove trovarlo.

Se si dispone di un progetto di applicazione App Center esistente, accedere al dashboard di App Center e aprire il progetto. È anche possibile usare il segreto dell'app nella pagina Impostazioni del progetto applicazione. Accedere al menu nell'angolo superiore destro della pagina, quindi selezionare Copia segreto dell'app per copiare il segreto dell'app negli Appunti.

Se non si dispone di un'applicazione creata nel dashboard di App Center, completare la procedura seguente.

1. Registrare un account App Center o accedere a un account app Center esistente in https://appcenter.ms.
2. Nel dashboard di App Center fare clic sull'elenco a discesa Aggiungi nuovo nell'angolo in alto a destra della pagina. Selezionare Aggiungi nuova app dal menu.
3. Immettere un nome per il progetto dell'applicazione, aggiungendo una descrizione facoltativa in base alle esigenze.
4. Selezionare il sistema operativo appropriato per il progetto dell'applicazione (solo Android o iOS), quindi selezionare l'opzione Della piattaforma Cordova .
5. Fare clic sul pulsante Aggiungi nuova app nell'angolo in basso a destra della pagina.
6. Individuare il segreto dell'app nella pagina Impostazioni del progetto applicazione. Accedere al menu nell'angolo superiore destro della pagina, quindi selezionare l'elemento Copia segreto dell'app per copiare il segreto dell'app negli Appunti.

3. Aggiungere App Center SDK al progetto

Installazione dell'SDK

Per i progetti Apache Cordova, l'SDK viene distribuito tramite plug-in Apache Cordova standard. Aggiungere App Center SDK al progetto Cordova usando le istruzioni fornite in questa sezione. Iniziare aprendo una finestra del terminale o un prompt dei comandi di Windows, quindi passare alla cartella radice del progetto Cordova.

Per aggiungere il supporto per App Center Analytics al progetto, eseguire il comando seguente:

cordova plugin add cordova-plugin-appcenter-analytics

Per aggiungere il supporto per Gli arresti anomali di App Center al progetto, eseguire il comando seguente:

cordova plugin add cordova-plugin-appcenter-crashes

Per aggiungere plug-in per tutte le funzionalità di App Center al progetto con un comando, eseguire il comando seguente:

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

Nota

È necessario aggiungere cordova-plug-plugin-appcenter-analytics e cordova-plug-plugin-appcenter-crashes la maggior parte di tutte le app che usano App Center; forniscono informazioni utili per gli sviluppatori senza alcuna configurazione o codifica aggiuntiva.

Configurazione dei plug-in

Chiave privata app

È necessario configurare il progetto con il segreto dell'app del progetto app Center prima di poter usare App Center SDK nel progetto Apache Cordova.

Aprire il file di config.xml del progetto Apache Cordova; per ogni elemento di destinazione platform del progetto Apache Cordova (solo Android e iOS oggi), aggiungere un elemento figlio preference nel formato seguente:

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

In questo esempio si aggiunge un elemento con un name attributo con un valore di APP_SECRETe un value attributo con il valore visualizzato nell'esempio. In questo caso, l'esempio 0000-0000-0000-0000-000000000000 è una rappresentazione arbitraria di un segreto dell'app di progetto di App Center. Sostituire il segreto dell'app visualizzato nell'esempio con il segreto dell'app effettivo per il progetto app Center.

Come esempio completo, per un progetto Apache Cordova che supporta sia le destinazioni Android che iOS, si avranno definizioni di progetto di app separate in App Center e così, valori dei segreti dell'app diversi per ogni piattaforma di destinazione. La sezione pertinente del file diconfig.xml del progetto avrà un aspetto simile al seguente:

<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>

Nota

L'esempio non mostra i valori effettivi dei segreti dell'app; questi sono semplicemente fittizi, sarà necessario afferrare i segreti dell'app del progetto app di App Center e usarli qui. I segreti dell'app sono diversi perché si avranno segreti univoci per i progetti dell'applicazione Android e iOS in App Center.

Preferenze di analisi

Se si usa App Center Analytics nell'app, è necessario eseguire alcuni passaggi di configurazione aggiuntivi. Aprire il file diconfig.xml del progetto Apache Cordova in un editor e aggiungere uno o più degli elementi seguenti preferences al file:

• APPCENTER_ANALYTICS_ENABLE_IN_JS - (facoltativo, il valore predefinito è false) Controlla se Analytics è abilitato automaticamente. Quando false, Analytics è abilitato per impostazione predefinita. Quando true, l'applicazione deve chiamare AppCenter.Analytics.setEnabled(true) (nel codice JavaScript) per abilitare Analytics prima di inviare dati a App Center. Questa preferenza è utile quando si vuole chiedere agli utenti se vogliono condividere le informazioni di analisi prima di abilitarlo all'interno dell'applicazione. Altre informazioni sull'invio di eventi utente manualmente.

  Esempio:

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

• APPCENTER_CRASHES_ALWAYS_SEND - (facoltativo, il valore predefinito è true) Specifica se i report di arresto anomalo vengono inviati automaticamente a App Center quando l'app si arresta in modo anomalo. Quando si inviano automaticamente report di arresto anomalo, ogni arresto anomalo viene segnalato, potenzialmente travolgente il team di progettazione e supporto. Quando si inviano report di arresto anomalo manualmente (impostazione APPCENTER_CRASHES_ALWAYS_SEND su false), il codice all'interno dell'applicazione può valutare gli arresti anomali e decidere quando vengono inviati report di arresto anomalo a App Center, i dati inclusi nei report e così via. Ciò significa più lavoro per lo sviluppatore, ma offre anche un maggiore controllo sulla privacy degli utenti e consente di collegare un messaggio con report di arresto anomalo. Altre informazioni sull'elaborazione sui report di arresto anomalo in JS.

  Esempio:

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

  Se si usa il backup automatico per evitare di ottenere informazioni non corrette sui dispositivi, seguire i passaggi successivi:

Nota

Le app destinate ad Android 6.0 (livello API 23) o successive hanno automaticamente abilitato Il backup automatico. 

Nota

Se si dispone già di un file personalizzato con regola di backup, passare al terzo passaggio.

a. Creare appcenter_backup_rule.xml file nella cartella res/xml .

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

b. android:fullBackupContent Per aggiungere l'attributo all'elemento all'interno del fileAndroidManifest.xml, aggiungere le righe seguenti al <application> file diconfig.xml dell'app:

<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. Dove andare avanti?

Ottimo, è tutto impostato per visualizzare i dati analitici e arresti anomali raccolti automaticamente dall'SDK nel portale. Non è necessaria alcuna configurazione aggiuntiva. Esaminare le sezioni Analisi e arresti anomali per le API e le procedure dettagliate per informazioni sulle operazioni che possono essere eseguite da App Center.