Android'i kullanmaya başlama

2025-05-05

Önemli

Visual Studio App Center, 30 Haziran 2026'ya kadar desteklenmeye devam edecek Analiz ve Tanılama özellikleri dışında 31 Mart 2025'te kullanımdan kaldırılmıştır. Daha fazla bilgi edinin.

App Center SDK'sı modüler bir mimari kullanır, böylece hizmetlerin herhangi birini veya tümünü kullanabilirsiniz.

App Center SDK'ları tarafından Toplanan Veriler, Genel Veri Koruma Yönetmeliği ve SSS sayfalarında App Center tarafından toplanan veriler hakkında bilgi bulabilirsiniz.

Uygulamanızda App Center Analytics ve App Center Çöküşlerini kullanmak için App Center Android SDK'sını kurarak başlayalım. Uygulamanıza App Center Distribute eklemek için App Center Distribute belgelerine göz atın.

1. Önkoşullar

Başlamadan önce aşağıdaki önkoşulların karşılandığından emin olun:

Android projeniz Android Studio'da ayarlanır.
Android Sürüm 5.0 (API düzeyi 21) veya üzerini çalıştıran cihazları hedefliıyorsunuz.

2. Uygulama Sırrını almak için Uygulamanızı App Center Portalı'nda oluşturmak için

Uygulamanızı App Center portalında zaten oluşturduysanız bu adımı atlayabilirsiniz.

appcenter.ms gidin.
Kaydolun veya oturum açın, sayfanın sağ üst köşesindeki Yeni ekle düğmesine tıklayın ve açılan menüden Yeni uygulama ekle'yi seçin.
Uygulamanız için bir ad ve isteğe bağlı bir açıklama girin.
İşletim sistemi olarak Android'i ve platform olarak Java'yi seçin.
Yeni uygulama ekle düğmesine tıklayın.

Uygulama oluşturduktan sonra, Uygulama Sırrını Başlarken sayfasında 2. SDK'yi Başlatın başlığı altında edinebilirsiniz. İsterseniz Ayarlar'a tıklayabilir ve sağ üst köşedeki üç dikey noktaya tıklayıp Uygulama Gizli Dizinizi almak için Uygulama gizli dizisini kopyala'yı seçebilirsiniz.

3. App Center SDK modüllerini ekleme

Projenin uygulama düzeyi build.gradle dosyasını (app/build.gradle) açın ve sonra apply pluginaşağıdaki satırları ekleyin. Projenize istediğiniz bağımlılıkları ekleyin. Her SDK modülünün bu bölümde ayrı bir bağımlılık olarak eklenmesi gerekir. App Center Analytics ve Çökme Durumlarını kullanmak istiyorsanız aşağıdaki satırları ekleyin:

dependencies {
    def appCenterSdkVersion = '5.0.6'
    implementation "com.microsoft.appcenter:appcenter-analytics:${appCenterSdkVersion}"
    implementation "com.microsoft.appcenter:appcenter-crashes:${appCenterSdkVersion}"
}

Uyarı

Android Gradle eklentinizin sürümü 3.0.0'dan düşükse, implementation sözcüğünü compile ile değiştirmeniz gerekir.

Uyarı

jCenter desteğinin sona ermesi nedeniyle tüm derlemelerimiz Maven Central deposuna taşındı. Lütfen jCenter'den Maven Central'a geçişle ilgili bu kılavuzu izleyin. Maven Central'ın kullanım dışı bırakılmış modüller içermediğini lütfen unutmayın. Projenizde kullanım dışı bırakılmış App Center SDK modüllerinin bağımlılıkları olmadığından emin olun.

Android Studio'da Gradle eşitlemesini tetiklediğinizden emin olun.

SDK'yı uygulamanıza tümleştirdiğinize göre artık SDK'yı başlatmanın ve App Center'ı kullanmanın zamanı geldi.

4. SDK'yi başlatın

4.1 start() yöntemini ekleme

App Center'ı kullanmak için kullanmak istediğiniz modülleri kabul etmeniz gerekir. Varsayılan olarak hiçbir modül başlatılmaz ve SDK'yı başlatırken bunların her birini açıkça çağırmanız gerekir.
onCreate ve App Center Crashes özelliklerini kullanmak için uygulamanızın ana etkinlik sınıfında geri çağırma içerisine aşağıdaki satırı ekleyin:

AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class);

AppCenter.start(application, "{Your App Secret}", Analytics::class.java, Crashes::class.java)

Uyarı

Uygulama Sırrınızı kaynak koduna yerleştirmek önerilmez.

App Center hizmetlerini ayrı olarak başlatmanız gerekiyorsa şunları yapmanız gerekir:

Uygulama Gizli Anahtarı ile yapılandırın veya başlatın.
Kod birden çok kez çağrılabiliyorsa App Center'ın zaten yapılandırılmış olup olmadığını denetleyin.
Uygulama Gizli Anahtarı olmadan gerekli hizmetleri başlatın.

AppCenter.configure(application, "{Your App Secret}");
if (AppCenter.isConfigured()) {
    AppCenter.start(Analytics.class);
    AppCenter.start(Crashes.class);
}

AppCenter.configure(application, "{Your App Secret}");
if (AppCenter.isConfigured()) {
    AppCenter.start(Analytics::class.java);
    AppCenter.start(Crashes::class.java);
}

Uygulamanızın birden fazla giriş noktası varsa (örneğin, derin bağlantı aktivitesi, bir hizmet veya yayın alıcısı gibi), uygulama özel sınıfında veya her giriş noktasında start çağırın. İkinci durumda, App Center'ın çağrıdan önce start zaten yapılandırılmış olup olmadığını denetleyin:

if (!AppCenter.isConfigured())) {
  AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class);
}

if (!AppCenter.isConfigured()) {
  AppCenter.start(application, "{Your App Secret}", Analytics::class.java, Crashes::class.java)
}

4.2 Yer tutucuyu Uygulama Gizli Anahtarınızla değiştirin

{Your App Secret} metnini uygulamanız için gerçek değerle değiştirdiğinizden emin olun. Uygulama Gizli Anahtarı, App Center portalında Başlarken veya Ayarlar sayfasında bulunabilir.

Başlangıç sayfasında, uygulama gizli anahtarınızı içeren yukarıdaki kod örneği bulunur. Kod örneğinin tamamını kopyalayıp yapıştırabilirsiniz.

Yukarıdaki örnek, hem App Center Analytics hem de App Center Crashes'ı içerecek şekilde start() yönteminin nasıl kullanılacağını göstermektedir.

İki hizmetten birini kullanmak istemiyorsanız yukarıdaki yöntem çağrısından ilgili parametreyi kaldırın.

Başlangıç yönteminde her modülü parametre olarak açıkça belirtmediğiniz sürece, bu App Center hizmetini kullanamazsınız. Buna ek olarak, API uygulamanızın start() yaşam döngüsünde yalnızca bir kez kullanılabilir; diğer tüm çağrılar konsola bir uyarı kaydeder ve yalnızca ilk çağrıda yer alan modüller kullanılabilir.

Örneğin - Yalnızca App Center Analytics'e katılmak istiyorsanız, API çağrısını start() şu şekilde değiştirmeniz gerekir:

AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class);

AppCenter.start(application, "{Your App Secret}", Analytics::class.java)

Android Studio, yöntemini ekledikten start() sonra gerekli içeri aktarma deyimlerini otomatik olarak önerir, ancak sınıf adlarının tanınmadığını belirten bir hata görürseniz, etkinlik sınıfınızdaki içeri aktarma deyimlerine aşağıdaki satırları ekleyin:

import com.microsoft.appcenter.AppCenter;
import com.microsoft.appcenter.analytics.Analytics;
import com.microsoft.appcenter.crashes.Crashes;

import com.microsoft.appcenter.AppCenter
import com.microsoft.appcenter.analytics.Analytics
import com.microsoft.appcenter.crashes.Crashes

SDK'nın otomatik olarak topladığı portalda Analytics ve Crashes verilerini görselleştirmeye hazırsınız.

Her iki hizmetin de daha gelişmiş işlevlerini özelleştirmeyi ve kullanmayı öğrenmek için App Center Analytics ve App Center Crashes belgelerine bakın.

Uygulama içi güncelleştirmeleri kullanmaya başlamayı öğrenmek için App Center Distribute belgelerini okuyun.

5. Yedekleme kuralları (yalnızca Android)

Uyarı

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

Uyarı

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

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

5.1. Android 11 (API düzeyi 30) veya daha düşük sürümler için.

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

Projenin AndroidManifest.xml dosyasını açın. özniteliğini android:fullBackupContent<application> öğesine ekleyin. appcenter_backup_rule.xml kaynak dosyasına işaret etmelidir.

android:fullBackupContent="@xml/appcenter_backup_rule"

appcenter_backup_rule.xml dosyasına aşağıdaki yedekleme kurallarını ekleyin:

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

5.2. Android 12 (API düzeyi 31) veya üzeri için.

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

Projenin AndroidManifest.xml dosyasını açın. özniteliğini android:dataExtractionRules<application> öğesine ekleyin. appcenter_backup_rule.xml kaynak dosyasına işaret etmelidir.

android:dataExtractionRules="@xml/appcenter_backup_rule"

appcenter_backup_rule.xml dosyasına aşağıdaki yedekleme kurallarını ekleyin:

<data-extraction-rules xmlns:tools="http://schemas.android.com/tools">
    <cloud-backup>
        <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"/>
    </cloud-backup>
    <device-transfer>
        <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"/>
    </device-transfer>
</data-extraction-rules>

Aracılığıyla paylaş

Android'i kullanmaya başlama

1. Önkoşullar

2. Uygulama Sırrını almak için Uygulamanızı App Center Portalı'nda oluşturmak için

3. App Center SDK modüllerini ekleme

4. SDK'yi başlatın

4.1 start() yöntemini ekleme

4.2 Yer tutucuyu Uygulama Gizli Anahtarınızla değiştirin

5. Yedekleme kuralları (yalnızca Android)

5.1. Android 11 (API düzeyi 30) veya daha düşük sürümler için.

5.2. Android 12 (API düzeyi 31) veya üzeri için.

Geri Bildirim

Ek kaynaklar