Apache Cordova ile Çalışmaya Başlama

Önemli

Visual Studio App Center 31 Mart 2025'te kullanımdan kaldırılıyor. Tamamen kullanımdan kaldırılana kadar Visual Studio App Center'ı kullanmaya devam edebilirsiniz ancak geçiş yapmayı düşünebileceğiniz birkaç önerilen alternatif vardır.

Destek zaman çizelgeleri ve alternatifleri hakkında daha fazla bilgi edinin.

• Android
• iOS
• iOS Uzantıları
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• macOS Uzantıları
• tvOS
• Cordova

Not

Cordova Uygulamaları desteği Nisan 2022'de sona erdi. App Center blogunda daha fazla bilgi bulabilirsiniz.

App Center SDK'sı modüler bir mimari kullanarak Apache Cordova uygulamanızdaki App Center hizmetlerinden birini, birkaçını veya tümünü kolayca kullanabilirsiniz.

Bu makalede, App Center SDK'sını Apache Cordova uygulamalarınıza eklemeyi ve ardından bir uygulamada App Center Analytics ve App Center Kilitlenmeleri özelliklerini yapılandırmayı öğreneceksiniz.

1. Önkoşullar

Başlamadan önce Apache Cordova uygulama projenizin aşağıdaki minimum gereksinimleri karşıladığından emin olun:

• Cordova CLI 6.4.0 veya üzeri
• cordova-android altyapı 5.0.0 veya üzeri
• cordova-ios motor 4.3.0 veya üzeri

Cordova CLI sürümünüzü belirlemek için bir terminal penceresi veya Windows komut istemi açın ve aşağıdaki komutu çalıştırın:

cordova -v

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

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

CocoaPods da yüklü olmalıdır. Bunun için komutunu çalıştırın sudo gem install cocoapodspod setup

2. App Center Uygulama Gizli Dizisini Alma

App Center SDK'sının App Center'daki uygulama projenize bağlanabilmesi için, SDK'nın App Center projenizin Uygulama Gizli Dizisine ihtiyacı vardır. Daha sonra App Center Apache Cordova SDK'sını bu değerle yapılandırmayı öğreneceksiniz, ancak şimdilik nerede bulacağınızı görelim.

Mevcut bir App Center uygulama projeniz varsa App Center Panosu'na erişin ve projenizi açın. Uygulama gizli dizisini uygulama projesinin Ayarlar sayfasından da yapabilirsiniz. Sayfanın sağ üst köşesindeki menüye erişin ve uygulama gizli dizisini panoya kopyalamak için Uygulama gizli dizisini kopyala'yı seçin.

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

1. App Center hesabına kaydolun veya adresinde https://appcenter.msmevcut bir App Center hesabında oturum açın.
2. App Center Panosu'nda, sayfanın sağ üst köşesindeki Yeni ekle açılan menüsüne tıklayın. Menüden Yeni uygulama ekle'yi seçin.
3. Gerektiğinde isteğe bağlı bir açıklama ekleyerek uygulama projeniz için bir ad girin.
4. Uygulama projeniz için uygun işletim sistemini seçin (yalnızca Android veya iOS), 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 Ayarlar sayfasında uygulama gizli dizisini bulun. Sayfanın sağ üst köşesindeki menüye erişin ve uygulama gizli dizisini panoya kopyalamak için Uygulama gizli dizisini kopyala öğesini seçin.

3. App Center SDK'sını projeye ekleme

SDK'yi yükleme

Apache Cordova projeleri için SDK, standart Apache Cordova eklentileri aracılığıyla dağıtılır. Bu bölümde sağlanan yönergeleri kullanarak App Center SDK'sını Cordova projenize ekleyin. Bir Terminal penceresi veya Windows komut istemi açarak başlayın, ardından Cordova projenizin kök klasörüne gidin.

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

cordova plugin add cordova-plugin-appcenter-analytics

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

cordova plugin add cordova-plugin-appcenter-crashes

Tek bir komutla projenize tüm App Center özelliklerine eklentiler eklemek için aşağıdaki komutu yürütebilirsiniz:

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

Not

Cordova-plugin-appcenter-analytics ve cordova-plugin-appcenter-crashes app Center kullanan çoğu uygulamayı eklemelisiniz; ek kurulum veya kodlama olmadan geliştiriciler için yararlı bilgiler sağlar.

Eklentileri yapılandırma

Uygulama Gizli Anahtarı

Apache Cordova projenizde App Center SDK'sını kullanabilmek için önce projeyi App Center proje uygulama gizli dizinizle yapılandırmanız gerekir.

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

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

Bu örnekte, değerine APP_SECRETsahip özniteliği olan bir name öğe ve örnekte gösterilen değere sahip bir value öznitelik ekliyorsunuz. Burada örnekte gösterilen, 0000-0000-0000-0000-000000000000 App Center proje uygulaması gizli dizisinin rastgele bir gösterimidir. Örnekte gösterilen uygulama gizli dizisini App Center projenizin gerçek uygulama gizli dizisiyle değiştirin.

Tam bir örnek olarak, hem Android hem de iOS hedeflerini destekleyen bir Apache Cordova projesi için App Center'da ayrı uygulama projesi tanımlarınız ve dolayısıyla her hedef platform için farklı uygulama gizli anahtarı değerleriniz olacaktır. Projenin config.xml dosyasının ilgili bölümü aşağıdaki gibi görünür:

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

Not

Örnekte gerçek uygulama gizli anahtarı değerleri gösterilmez; Bunlar yalnızca sahte öğelerdir, App Center projenizin uygulama gizli dizilerini alıp burada kullanmanız gerekir. App Center'da Android ve iOS uygulama projeleriniz için benzersiz gizli dizileriniz olduğundan uygulama gizli dizileri farklıdır.

Analiz Tercihleri

Uygulamanızda App Center Analytics 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 preferences öğelerden birini veya daha fazlasını ekleyin:

• APPCENTER_ANALYTICS_ENABLE_IN_JS - (isteğe bağlı, varsayılan değer false'tur) Analytics'in otomatik olarak etkinleştirilip etkinleştirilmediğini denetler. olduğunda falseAnaliz varsayılan olarak etkindir. olduğunda true, uygulamanın App Center'a veri göndermeden önce Analytics'i etkinleştirmek için çağrısı AppCenter.Analytics.setEnabled(true) yapması gerekir (JavaScript kodunda). 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 edinin.

  Örnek:

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

• APPCENTER_CRASHES_ALWAYS_SEND - (isteğe bağlı, varsayılan değer true) Uygulama kilitlendiğinde kilitlenme raporlarının App Center'a otomatik olarak gönderilip gönderilmeydiğini belirtir. Kilitlenme raporları otomatik olarak gönderilirken, her kilitlenme bildirilir ve mühendislik ve destek ekipleri bunaltıcı olabilir. Kilitlenme raporlarını el ile gönderirken (ayarı olarak), APPCENTER_CRASHES_ALWAYS_SENDfalseuygulamanızdaki kod kilitlenmeleri öncelikleştirebilir ve kilitlenme raporlarının App Center'a ne zaman gönderileceğine, raporlara hangi verilerin dahil olduğuna vb. karar verebilir. 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 raporu içeren bir ileti eklemenize olanak tanır. 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 almaktan kaçınmak için otomatik yedekleme kullanıyorsanız sonraki adımları izleyin:

Not

Android 6.0 (API düzeyi 23) veya üzerini hedefleyen uygulamalarda Otomatik Yedekleme otomatik olarak etkinleştirilir. 

Not

Yedekleme kuralı içeren özel bir dosyanız zaten varsa üçüncü adıma geçin.

a. res/xml klasöründe appcenter_backup_rule.xml dosyası oluşturun.

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

b. özniteliğinin AndroidManifest.xml dosyasının <application> içindeki öğesine eklenmesi için android:fullBackupContent uygulamanın config.xml dosyasına aşağıdaki satırları ekleyin:

<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 nereye gidilmektedir?

Harika, portalda SDK tarafından otomatik olarak toplanan Analytics ve Crashes verilerini görselleştirmeye hazırsınız. Ek kurulum gerekmez. App Center'ın neler yapabileceğini öğrenmek için API kılavuzları ve izlenecek yollar için Analiz ve Kilitlenmeler bölümlerine bakın.