Başlarken ile Apache Cordova

App Center SDK'sı modüler bir mimari kullandığı için, Apache Cordova uygulamanıza yönelik hizmetlerden birini, birkaçını veya App Center kolayca kullanabilirsiniz.

Bu makalede, App Center SDK'sını Apache Cordova uygulamalarınıza ekleme, App Center Analytics ve App Center Kilitlenme özellikleri yapılandırma hakkında bilgi edinebilirsiniz.

1. Önkoşullar

Başlamadan önce, Apache Cordova uygulama projenizin aşağıdaki en düşük gereksinimleri karşılayana kadar olduğundan emin olun:

• Cordova CLI 6.4.0 veya sonraki bir
• cordova-android engine 5.0.0 veya sonraki bir
• cordova-ios engine 4.3.0 veya sonraki bir

Önceki sürüm Cordova CLI belirlemek için bir terminal penceresi açın Windows komut istemini açın ve aşağıdaki komutu yürütün:

cordova -v

ve sürümlerini belirlemek için projeninconfig.xmldosyasını açın. Aşağıda gösterilen öğelerde cordova-android cordova-ios tanımlanan platform engine altyapılarını bulabilirsiniz:

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

CocoaPods'un da yüklü olması gerekir. Bunun için sudo gem install cocoapods pod setup

2. App Center Gizli App Center Alma

App Center SDK'sı için App Center projenizin App Secret App Center gerekir. Daha sonra App Center Apache Cordova SDK'sı'nın bu değerle nasıl yapılandırıldığından emin olacak, ancak şimdilik nerede bulunacağız?

Mevcut bir uygulama App Center varsa, App Center Panosu'na erişinve projenizi açın. Uygulama gizli Ayarlar. Sayfanın sağ üst köşesindeki menüye erişin ve uygulama gizli dosyasını kopyala'ya seçerek uygulama gizli dosyasını panoya kopyalayın.

App Center Panosu'nda oluşturulmuş bir uygulamanız yoksa aşağıdaki adımları tamamlayın.

1. Bir hesap App Center veya 'de mevcut bir App Center oturum https://appcenter.ms açın.
2. App Center Panosu'nda, sayfanın sağ üst köşesindeki Yeni ekle açılan sayfasına tıklayın. Menüden Yeni uygulama ekle'yi seçin.
3. Uygulama projeniz için isteğe bağlı bir açıklama ekleyerek bir ad girin.
4. Uygulama projeniz için uygun işletim sistemi seçin (yalnızca Android veya iOS) ve ardından Cordova platformu seçeneğini belirleyin.
5. Sayfanın sağ alt köşesindeki Yeni uygulama ekle düğmesine tıklayın.
6. Uygulama projesinin uygulama gizli Ayarlar bulun. Sayfanın sağ üst köşesindeki menüye erişin, ardından Uygulama gizli dosyasını kopyala öğesini seçerek uygulama gizli dosyasını panoya kopyalayın.

3. App Center SDK'sini projeye ekleme

SDK'yı yükleme

Daha Apache Cordova sdk, standart uygulama ve Apache Cordova dağıtılır. Bu bölümde App Center yönergeleri kullanarak App Center SDK'yı Cordova projenize ekleyin. Başlangıç olarak bir Terminal penceresi açın Windows komut istemini açın ve Cordova projenizin kök klasörüne gidin.

Projenize App Center Analytics desteği eklemek için aşağıdaki komutu yürütün:

cordova plugin add cordova-plugin-appcenter-analytics

Projenize App Center için destek eklemek için aşağıdaki komutu yürütün:

cordova plugin add cordova-plugin-appcenter-crashes

Tek komutla projenize tüm App Center eklentileri eklemek için aşağıdaki komutu yürütün:

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

Eklentileri yapılandırma

Uygulama Gizli Anahtarı

App Center SDK'sini App Center projenizin içinde kullanamadan önce projeyi Apache Cordova yapılandırmanız gerekir.

Apache Cordova projesinin config.xml açın; Projenizin her Apache Cordova (yalnızca Android ve iOS bugün) için aşağıdaki biçimde platform preference bir alt öğe ekleyin:

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

Bu örnekte, değerine sahip özniteliğine ve örnekte gösterilen değere sahip name APP_SECRET bir value özniteliğine sahip bir öğe ekliyoruz. Burada, 0000-0000-0000-0000-000000000000 örnekte gösterilen, bir proje uygulama gizli App Center rastgele temsilidir. Örnekte gösterilen uygulama gizli App Center değiştirin.

Tam bir örnek olarak, hem Android hem de iOS hedeflerini destekleyen bir Apache Cordova projesi için App Center'de ayrı uygulama projesi tanımları ve dolayısıyla her hedef platform için farklı uygulama gizli değerlerine sahip oluruz. Projeninconfig.xml bölümü aşağıdaki gibi olacak:

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

Analiz Tercihleri

App Center Analytics'i uygulamanıza kullanıyorsanız gerçekleştirmeniz gereken bazı ek yapılandırma adımları vardır. Apache Cordova projesinin config.xml dosyasını bir düzenleyicide açın ve dosyaya aşağıdaki öğelerden preferences birini veya daha fazlasını ekleyin:

• APPCENTER_ANALYTICS_ENABLE_IN_JS - (isteğe bağlı, varsayılan değer false) Analytics'in otomatik olarak etkin olup olmadığını kontrol eder. olduğunda, false Analiz varsayılan olarak etkindir. olduğunda, uygulamanın verileri App Center'a göndermeden önce Analytics'i etkinleştirmek için çağrısı true AppCenter.Analytics.setEnabled(true) App Center. Bu tercih, kullanıcılara uygulama içinde etkinleştirmeden önce analiz bilgilerini paylaşmak isteyip istemediklerini sormak istediğinizde kullanışlıdır. Kullanıcı olaylarını el ile gönderme hakkında daha fazla bilgi.

  Örnek:

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

• APPCENTER_CRASHES_ALWAYS_SEND - (isteğe bağlı, varsayılan değer true) Uygulama kilitlenirken kilitlenme raporlarının otomatik App Center gönderip gönderilmey olmadığını belirtir. Kilitlenme raporlarını otomatik olarak gönderirken her kilitlenme rapor edilir ve mühendislik ve destek ekipleri bunaltıcı olabilir. Kilitlenme raporlarını el ile gönderirken (ayarı olarak), uygulama içindeki kod kilitlenmeleri triyazabilir ve kilitlenme raporlarının App Center, raporlara hangi verilerin dahil olduğuna ve bu gibi verilere APPCENTER_CRASHES_ALWAYS_SEND karar ve ardından karar false verir. Bu, geliştirici için daha fazla çalışma anlamına gelir, ancak aynı zamanda kullanıcı gizliliği üzerinde daha fazla denetim sağlar ve kilitlenme raporuyla bir ileti eklemenizi sağlar. JS'de kilitlenme raporlarını işleme hakkında daha fazla bilgi edinin.

  Örnek:

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

  Cihazlar hakkında yanlış bilgi almamak için otomatik yedekleme kullanıyorsanız, sonraki adımları izleyin:

a. res/xml appcenter_backup_rule.xml bir dosya oluşturun.

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

b. özniteliğininAndroidManifest.xmldosyasının içindeki öğesine android:fullBackupContent <application> eklensin diye uygulamanın config.xmlekleyin:

<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. Sırada ne var?

Harika, portalda SDK tarafından otomatik olarak toplanan Analiz ve Kilitlenme verilerini görselleştirmek için hazırsınız. Ek kurulum gerekli değildir. Api kılavuzları ve izlenecek yollar için Analiz ve Kilitlenmeler bölümlerine bakarak neler App Center öğrenin.