Wprowadzenie do platformy Apache Cordova

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Mimo że możesz nadal używać programu Visual Studio App Center do momentu jej pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

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

Uwaga

Wsparcie dla aplikacji Cordova zakończyło się w kwietniu 2022 r. Więcej informacji można znaleźć w blogu Centrum aplikacji.

Zestaw SDK centrum aplikacji korzysta z architektury modułowej, dzięki czemu można łatwo używać jednej, kilku lub wszystkich usług Centrum aplikacji w aplikacji Apache Cordova.

W tym artykule dowiesz się, jak dodać zestaw SDK centrum aplikacji do aplikacji Apache Cordova, a następnie skonfigurować funkcje analizy i awarii centrum aplikacji w aplikacji.

1. Wymagania wstępne

Przed rozpoczęciem upewnij się, że projekt aplikacji Apache Cordova spełnia następujące minimalne wymagania:

• Interfejs wiersza polecenia cordova w wersji 6.4.0 lub nowszej
• cordova-android silnik 5.0.0 lub nowszy
• cordova-ios silnik 4.3.0 lub nowszy

Aby określić wersję interfejsu wiersza polecenia cordova, otwórz okno terminalu lub wiersz polecenia systemu Windows i wykonaj następujące polecenie:

cordova -v

Aby określić wersje cordova-android i cordova-ios , otwórz plik config.xml projektu, znajdziesz aparaty platformy zdefiniowane w engine poniższych elementach:

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

Musisz również mieć zainstalowaną aplikację CocoaPods . W tym celu uruchom polecenie sudo gem install cocoapodspod setup

2. Pobieranie wpisu tajnego aplikacji Centrum aplikacji

Aby zestaw SDK centrum aplikacji łączył się z projektem aplikacji w centrum aplikacji, zestaw SDK wymaga wpisu tajnego aplikacji w projekcie Centrum aplikacji. Później dowiesz się, jak skonfigurować zestaw SDK platformy Apache Cordova w centrum aplikacji przy użyciu tej wartości, ale na razie zobaczysz, gdzie go znaleźć.

Jeśli masz istniejący projekt aplikacji Centrum aplikacji, uzyskaj dostęp do pulpitu nawigacyjnego centrum aplikacji i otwórz projekt. Wpis tajny aplikacji można również uzyskać na stronie Ustawienia projektu aplikacji. Uzyskaj dostęp do menu w prawym górnym rogu strony, a następnie wybierz pozycję Kopiuj wpis tajny aplikacji , aby skopiować wpis tajny aplikacji do schowka.

Jeśli nie masz aplikacji utworzonej na pulpicie nawigacyjnym centrum aplikacji, wykonaj następujące kroki.

1. Zarejestruj się na koncie centrum aplikacji lub zaloguj się do istniejącego konta centrum aplikacji pod adresem https://appcenter.ms.
2. Na pulpicie nawigacyjnym centrum aplikacji kliknij listę rozwijaną Dodaj nową w prawym górnym rogu strony. Wybierz pozycję Dodaj nową aplikację z menu.
3. Wprowadź nazwę projektu aplikacji, dodając opcjonalny opis zgodnie z potrzebami.
4. Wybierz odpowiedni system operacyjny dla projektu aplikacji (tylko system Android lub iOS), a następnie wybierz opcję platformy Cordova .
5. Kliknij przycisk Dodaj nową aplikację w prawym dolnym rogu strony.
6. Znajdź wpis tajny aplikacji na stronie Ustawienia projektu aplikacji. Uzyskaj dostęp do menu w prawym górnym rogu strony, a następnie wybierz element Kopiuj wpis tajny aplikacji , aby skopiować wpis tajny aplikacji do schowka.

3. Dodawanie zestawu SDK centrum aplikacji do projektu

Instalowanie zestawu SDK

W przypadku projektów Apache Cordova zestaw SDK jest dystrybuowany za pośrednictwem standardowych wtyczek apache Cordova. Dodaj zestaw SDK centrum aplikacji do projektu Cordova, korzystając z instrukcji podanych w tej sekcji. Rozpocznij od otwarcia okna terminalu lub wiersza polecenia systemu Windows, a następnie przejdź do folderu głównego projektu Cordova.

Aby dodać obsługę usługi App Center Analytics do projektu, wykonaj następujące polecenie:

cordova plugin add cordova-plugin-appcenter-analytics

Aby dodać obsługę awarii usługi App Center do projektu, wykonaj następujące polecenie:

cordova plugin add cordova-plugin-appcenter-crashes

Aby dodać wtyczki dla wszystkich funkcji usługi App Center do projektu za pomocą jednego polecenia, wykonaj następujące polecenie:

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

Uwaga

Należy dodać aplikację cordova-plugin-appcenter-analytics i cordova-plugin-appcenter-crash większość aplikacji korzystających z usługi App Center; zapewniają one przydatne informacje dla deweloperów bez konieczności dodatkowej konfiguracji ani kodowania.

Konfigurowanie wtyczek

Klucz tajny aplikacji

Przed użyciem zestawu SDK centrum aplikacji apache Cordova należy skonfigurować projekt za pomocą wpisu tajnego aplikacji centrum aplikacji.

Otwórz plik config.xml projektu Apache Cordova; dla każdego z elementów docelowych platform projektu Apache Cordova (obecnie tylko systemy Android i iOS) dodaj element podrzędny preference w następującym formacie:

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

W tym przykładzie dodasz element z atrybutem z name wartością APP_SECRET, a value atrybutem z wartością pokazaną w przykładzie. W tym miejscu pokazano 0000-0000-0000-0000-000000000000 w przykładzie dowolną reprezentację wpisu tajnego aplikacji projektu App Center. Zastąp wpis tajny aplikacji pokazany w przykładzie rzeczywistym wpisem tajnym aplikacji dla projektu centrum aplikacji.

Kompletny przykład w przypadku projektu Apache Cordova obsługującego zarówno cele systemu Android, jak i iOS, będziesz mieć oddzielne definicje projektu aplikacji w centrum App Center, a więc różne wartości wpisów tajnych aplikacji dla każdej platformy docelowej. Odpowiednia sekcja pliku config.xml projektu będzie wyglądać następująco:

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

Uwaga

W przykładzie nie są wyświetlane rzeczywiste wartości wpisów tajnych aplikacji; są to tylko makiety, musisz pobrać wpisy tajne aplikacji w programie App Center i użyć ich tutaj. Wpisy tajne aplikacji są różne, ponieważ będziesz mieć unikatowe wpisy tajne dla projektów aplikacji systemu Android i iOS w centrum aplikacji.

Preferencje analizy

Jeśli używasz usługi App Center Analytics w aplikacji, wykonaj kilka dodatkowych kroków konfiguracji. Otwórz plik config.xml projektu Apache Cordova w edytorze i dodaj do pliku co najmniej jeden z następujących preferences elementów:

• APPCENTER_ANALYTICS_ENABLE_IN_JS - (opcjonalnie, wartość domyślna to false) Określa, czy analiza jest włączona automatycznie. Gdy falseusługa Analytics jest domyślnie włączona. Gdy trueaplikacja musi wywołać AppCenter.Analytics.setEnabled(true) wywołanie (w kodzie JavaScript), aby włączyć analizę przed wysłaniem danych do centrum aplikacji. Ta preferencja jest przydatna, gdy chcesz zapytać użytkowników, czy chcą udostępniać informacje analityczne przed włączeniem ich w aplikacji. Dowiedz się więcej na temat ręcznego wysyłania zdarzeń użytkownika.

  Przykład:

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

• APPCENTER_CRASHES_ALWAYS_SEND - (opcjonalnie, wartość domyślna to true) Określa, czy raporty o awarii są automatycznie wysyłane do centrum aplikacji po awarii aplikacji. Podczas automatycznego wysyłania raportów o awarii każda awaria jest zgłaszana, potencjalnie przytłaczająca zespoły inżynieryjne i pomocy technicznej. Podczas ręcznego wysyłania raportów o awarii (ustawienie na ), APPCENTER_CRASHES_ALWAYS_SENDfalsekod w aplikacji może ulec awarii i zdecydować, kiedy raporty o awarii są wysyłane do Centrum aplikacji, jakie dane są uwzględniane w raportach itd. Oznacza to większą pracę dla dewelopera, ale zapewnia również większą kontrolę nad prywatnością użytkowników i umożliwia dołączenie komunikatu z raportem o awarii. Dowiedz się więcej o przetwarzaniu raportów awarii w języku JS.

  Przykład:

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

  Jeśli używasz automatycznej kopii zapasowej, aby uniknąć uzyskiwania nieprawidłowych informacji o urządzeniach, wykonaj następujące kroki:

Uwaga

Aplikacje przeznaczone dla systemu Android 6.0 (poziom 23 interfejsu API) lub nowsze mają automatycznie włączoną automatyczną kopię zapasową. 

Uwaga

Jeśli masz już plik niestandardowy z regułą tworzenia kopii zapasowej, przejdź do trzeciego kroku.

a. Utwórz plikappcenter_backup_rule.xml w folderze res/xml .

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

b. android:fullBackupContent Aby atrybut został dodany do <application> elementu wewnątrz plikuAndroidManifest.xml, dodaj następujące wiersze do pliku config.xml aplikacji:

<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. Gdzie przejść dalej?

Wszystko jest gotowe do wizualizacji danych analizy i awarii zebranych automatycznie przez zestaw SDK w portalu. Nie jest wymagana żadna dodatkowa konfiguracja. Zapoznaj się z sekcjami Analizy i awarii , aby zapoznać się z przewodnikami dotyczącymi interfejsów API i przewodnikami, aby dowiedzieć się, co centrum aplikacji może zrobić.