Android’i Kullanmaya 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

App Center SDK'sı modüler bir mimari kullanarak 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 Kilitlenmelerini kullanmak için App Center Android SDK'sını ayarlamaya 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ı hedefliyorsunuz.

2. Uygulama Gizli Dizisini almak için uygulamanızı App Center Portalı'nda oluşturun

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

1. appcenter.ms'a gidin.
2. 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.
3. Uygulamanız için bir ad ve isteğe bağlı bir açıklama girin.
4. İşletim sistemi olarak Android'i ve platform olarak Java'yi seçin.
5. Yeni uygulama ekle düğmesine tıklayın.

Bir uygulama oluşturduktan sonra, Uygulama Gizli Dizisini Başlarkensayfasından 2'nin altında edinebilirsiniz. SDK'yi başlatın. İ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

1. Projenin uygulama düzeyi build.gradle dosyasını (app/build.gradle) açın ve sonra aşağıdaki satırları apply pluginekleyin. 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 Kilitlenmeleri kullanmak istiyorsanız aşağıdaki satırları ekleyin:

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

Not

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

Not

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

2. 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.
App Center Analytics ve App Center Kilitlenmelerini kullanmak için uygulamanızın ana etkinlik sınıfının onCreate-callback içine 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 Gizli Dizinizi kaynak koduna eklemeniz önerilmez.

App Center hizmetlerini ayrı olarak başlatmanız gerekiyorsa şunları yapmalısınız:

1. Uygulama Gizli Dizisi'ni yapılandırın veya başlatın.
2. Kod birden çok kez çağrılabiliyorsa App Center'ın zaten yapılandırılmış olup olmadığını denetleyin.
3. 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ıza birden fazla giriş noktanız varsa (örneğin, derin bağlantı etkinliği, hizmet veya yayın alıcısı), uygulama özel sınıfında veya her giriş noktasında çağrısı start yapın. İkinci durumda App Center'ın çağrıdan önce start 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 Dizinizle değiştirin

Metni uygulamanızın gerçek değeriyle değiştirdiğinden {Your App Secret} emin olun. Uygulama Gizli Dizisi, App Center portalındaki Başlarken sayfasında veya Ayarlar sayfasında bulunabilir.

Başlarken sayfasında uygulama gizli dizinizin bulunduğu yukarıdaki kod örneği bulunur. Örneğin tamamını kopyalayıp yapıştırabilirsiniz.

Yukarıdaki örnekte yönteminin start() nasıl kullanılacağı ve hem App Center Analytics hem de App Center Kilitlenmeleri'nin nasıl dahil olduğu gösterilmektedir.

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

Her modülü başlangıç yönteminde 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 eklemek istiyorsanız, API çağrısını start() aşağıdaki gibi 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, aşağıdaki satırları etkinlik sınıfınızdaki içeri aktarma deyimlerine 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 Kilitlenmeleri 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)

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.

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.

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

2. 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"

3. aşağıdaki yedekleme kurallarını appcenter_backup_rule.xml dosyasına 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.

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

2. 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"

3. aşağıdaki yedekleme kurallarını appcenter_backup_rule.xml dosyasına 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>