Začínáme s Apache Cordovou

Článek
03/15/2024

Důležité

Visual Studio App Center je naplánované k vyřazení na 31. března 2025. I když můžete Visual Studio App Center dál používat, dokud ho úplně nevyřadíte, existuje několik doporučených alternativ, na které můžete migraci zvážit.

Přečtěte si další informace o časových osách a alternativách podpory.

Poznámka

Podpora aplikací Cordova skončila v dubnu 2022. Další informace najdete v blogu app center.

Sada App Center SDK používá modulární architekturu, takže v aplikaci Apache Cordova můžete snadno používat jednu, několik nebo všechny služby App Center.

V tomto článku se dozvíte, jak přidat sadu App Center SDK do aplikací Apache Cordova a jak v aplikaci nakonfigurovat funkce App Center Analytics a Chybové ukončení app center.

1. Požadavky

Než začnete, ujistěte se, že projekt aplikace Apache Cordova splňuje následující minimální požadavky:

Cordova CLI 6.4.0 nebo novější
cordova-android motor 5.0.0 nebo novější
cordova-ios motor 4.3.0 nebo novější

Pokud chcete zjistit verzi rozhraní příkazového řádku Cordovy, otevřete okno terminálu nebo příkazový řádek Windows a spusťte následující příkaz:

cordova -v

Pokud chcete zjistit cordova-android verze a cordova-ios , otevřete souborconfig.xml projektu. Najdete moduly platformy definované v engine níže uvedených prvčích:

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

Musíte mít také nainstalovaný CocoaPods . Za tímto způsobem spusťte příkaz sudo gem install cocoapodspod setup

2. Získání tajného kódu aplikace App Center

Aby se sada App Center SDK mohla připojit k projektu aplikace v App Center, potřebuje sada SDK tajný kód aplikace vašeho projektu App Center. Později se dozvíte, jak s touto hodnotou nakonfigurovat sadu Apache Cordova SDK pro App Center, ale prozatím se podívejme, kde ji najdete.

Pokud máte existující projekt aplikace App Center, přejděte na řídicí panel App Center a otevřete projekt. Tajný kód aplikace můžete také použít na stránce Nastavení projektu aplikace. Přejděte do nabídky v pravém horním rohu stránky a pak vyberte Kopírovat tajný kód aplikace a zkopírujte tajný kód aplikace do schránky.

Pokud nemáte aplikaci vytvořenou na řídicím panelu App Center, proveďte následující kroky.

Zaregistrujte si účet App Center nebo se přihlaste ke stávajícímu účtu App Center na adrese https://appcenter.ms.
Na řídicím panelu App Center klikněte na rozevírací seznam Přidat nový v pravém horním rohu stránky. V nabídce vyberte Přidat novou aplikaci .
Zadejte název projektu aplikace a podle potřeby přidejte volitelný popis.
Vyberte příslušný operační systém pro projekt aplikace (pouze Android nebo iOS) a pak vyberte možnost platformy Cordova .
Klikněte na tlačítko Přidat novou aplikaci v pravém dolním rohu stránky.
Na stránce Nastavení projektu aplikace vyhledejte tajný kód aplikace. Přejděte do nabídky v pravém horním rohu stránky a pak výběrem položky Kopírovat tajný kód aplikace zkopírujte tajný kód aplikace do schránky.

3. Přidání sady App Center SDK do projektu

Instalace sady SDK

V případě projektů Apache Cordova se sada SDK distribuuje prostřednictvím standardních modulů plug-in Apache Cordova. Přidejte sadu App Center SDK do projektu Cordova podle pokynů uvedených v této části. Začněte otevřením okna terminálu nebo příkazového řádku systému Windows a pak přejděte do kořenové složky projektu Cordova.

Pokud chcete do projektu přidat podporu pro App Center Analytics , spusťte následující příkaz:

cordova plugin add cordova-plugin-appcenter-analytics

Pokud chcete do projektu přidat podporu chyb app center , spusťte následující příkaz:

cordova plugin add cordova-plugin-appcenter-crashes

Pokud chcete do projektu jedním příkazem přidat moduly plug-in pro všechny funkce App Center, spusťte následující příkaz:

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

Poznámka

Měli byste přidat cordova-plugin-appcenter-analytics a cordova-plugin-appcenter-chybově ukončí většinu aplikací, které používají App Center. poskytují vývojářům užitečné informace bez dalšího nastavení nebo kódování.

Konfigurace modulů plug-in

Tajný klíč aplikace

Před použitím sady App Center SDK v projektu Apache Cordova musíte projekt nakonfigurovat pomocí tajného kódu aplikace projektu App Center.

Otevřete soubor config.xml projektu Apache Cordova. Pro každý z cílových platform prvků projektu Apache Cordova (dnes jenom Android a iOS) přidejte podřízený preference prvek v následujícím formátu:

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

V tomto příkladu přidáte element s atributem name s hodnotou APP_SECRETa value atribut s hodnotou uvedenou v příkladu. Tady je znázorněno 0000-0000-0000-0000-000000000000 v příkladu libovolnou reprezentací tajného kódu aplikace projektu app center. Nahraďte tajný kód aplikace zobrazený v příkladu skutečným tajným kódem aplikace pro váš projekt App Center.

Jako úplný příklad pro projekt Apache Cordova, který podporuje cíle pro Android i iOS, budete mít v App Center samostatné definice projektu aplikace, a proto pro každou cílovou platformu různé hodnoty tajných kódů aplikace. Příslušná část souboruconfig.xml projektu bude vypadat takto:

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

Poznámka

V příkladu se nezobrazují skutečné hodnoty tajných kódů aplikací. jsou to jenom napodobení, budete muset vzít tajné kódy aplikací vašeho projektu App Center a použít je tady. Tajné kódy aplikací se liší, protože v App Center budete mít jedinečné tajné kódy pro projekty aplikací pro Android a iOS.

Předvolby analýzy

Pokud v aplikaci používáte App Center Analytics, je potřeba provést několik dalších kroků konfigurace. Otevřete souborconfig.xml projektu Apache Cordova v editoru a přidejte do souboru jeden nebo více následujících preferences prvků:

APPCENTER_ANALYTICS_ENABLE_IN_JS - (volitelné, výchozí hodnota je false) Určuje, jestli se analýza povolí automaticky. Když falseje analýza ve výchozím nastavení povolená. Když true, aplikace musí před odesláním dat do App Center zavolat AppCenter.Analytics.setEnabled(true) (ve svém javascriptovém kódu), aby povolila analýzu. Tato předvolba je užitečná, když se chcete uživatelů zeptat, jestli chtějí sdílet analytické informace, než je povolíte v aplikaci. Přečtěte si další informace o ručním odesílání událostí uživatelů.

Příklad:
```
<preference name="APPCENTER_ANALYTICS_ENABLE_IN_JS" value="true" />
```
APPCENTER_CRASHES_ALWAYS_SEND - (volitelné, výchozí hodnota je true) Určuje, jestli se při chybovém ukončení aplikace automaticky odesílají zprávy o chybách do App Center. Při automatickém odesílání zpráv o chybách se hlásí každé chybové ukončení, což může zahltit technické týmy a týmy podpory. Při ručním odesílání zpráv o chybách (nastavení APPCENTER_CRASHES_ALWAYS_SEND na false), může kód v rámci vaší aplikace určit posouzení chyb a rozhodnout, kdy se zprávy o chybách posílají do App Center, jaká data budou v sestavách obsažena atd. To znamená více práce pro vývojáře, ale zároveň poskytuje větší kontrolu nad ochranou osobních údajů uživatelů a umožňuje připojit zprávu se zprávou o chybách. Přečtěte si další informace o zpracování zpráv o chybách v JS.

Příklad:
```
<preference name="APPCENTER_CRASHES_ALWAYS_SEND" value="false" />
```
Pokud používáte automatické zálohování, abyste se vyhnuli získání nesprávných informací o zařízeních, postupujte podle následujících kroků:

Poznámka

Aplikace, které cílí na Android 6.0 (úroveň rozhraní API 23) nebo vyšší, mají automatické zálohování povolené automaticky.

Poznámka

Pokud už máte vlastní soubor s pravidlem zálohování, přepněte na třetí krok.

a. Ve složce res/xml vytvořte souborappcenter_backup_rule.xml.

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

b. Aby se android:fullBackupContent atribut přidal do elementu <application> uvnitř AndroidManifest.xml souboru, přidejte do souboruconfig.xmlaplikace následující řádky :

<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. Kam dál?

Je skvělé, že máte všechno připravené k vizualizaci dat Analýzy a Chybových ukončení, která sada SDK shromažďuje automaticky na portálu. Nevyžaduje se žádné další nastavení. V částech Analýza a Chybové ukončení najdete příručky a návody k rozhraním API, kde najdete informace o tom, co App Center dokáže.

Share via

Začínáme s Apache Cordovou

1. Požadavky

2. Získání tajného kódu aplikace App Center

3. Přidání sady App Center SDK do projektu

Instalace sady SDK

Konfigurace modulů plug-in

Tajný klíč aplikace

Předvolby analýzy

Pokud používáte automatické zálohování, abyste se vyhnuli získání nesprávných informací o zařízeních, postupujte podle následujících kroků:

4. Kam dál?

Další materiály