Android’i Kullanmaya Başlama

App Center SDK'sı modüler bir mimari kullandığı için hizmetlerin herhangi birini veya hepsini kullanabilirsiniz.

App Center tarafından toplanan veriler hakkında App Center, Genel Veri Koruma Yönetmeliği ve SSSsayfalarında bulabilirsiniz.

App Center Analytics ve App Center Android SDK'leri kullanmak için uygulamanıza App Center başlamaya bakalım. Uygulamanıza App Center eklemek için, Dağıt'a ilişkin belgelere App Center bakın.

1. Önkoşullar

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

• Android projeniz Android Studio.
• Android Sürüm 5.0 (API düzeyi 21) veya sonraki bir sürümü çalıştıran cihazları hedefleyebilirsiniz.

2. Uygulama Gizli App Center almak için App Center portalında oluşturun

App Center portalında zaten App Center bu adımı atlayabilirsiniz.

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

Bir uygulama oluşturduktan sonra uygulama gizli Başlarken 2.'nin altında bulabilirsiniz. SDK'yı başlatma. Veya Ayarlar'a tıklayıp sağ üst köşedeki üç dikey noktaya tıklayıp Uygulama Gizli Bilginizi almak için Uygulama gizlisini kopyala'yı seçin.

3. App Center SDK modüllerini ekleme

1. Projenin uygulama düzeyi build.gradle dosyasını ( ) açın app/build.gradle ve sonra aşağıdaki satırları apply plugin ekleyin. Projenize istediğiniz bağımlılıkları dahil etmek. Her SDK modülünün bu bölümde ayrı bir bağımlılık olarak ekleniyor olması gerekir. App Center Analytics ve Kilitlenmeler'i kullanmak için aşağıdaki satırları ekleyin:

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

2. Bir Gradle eşitlemesi tetiklendiğinden emin Android Studio.

Artık SDK'yı uygulamanıza tümleştirebilirsiniz. Şimdi SDK'yı başlatmanın ve App Center.

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

b. ProjeninAndroidManifest.xml açın. özniteliğini android:fullBackupContent öğesine <application> ekleyin. Dosyanın kaynak dosyasına appcenter_backup_rule.xml gerekir.

android:fullBackupContent="@xml/appcenter_backup_rule"

c. Aşağıdaki yedekleme kurallarınıappcenter_backup_rule.xml 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>

4. SDK'yı başlatma

4.1 start() yöntemini ekleme

Bu App Center kullanmak için kullanmak istediğiniz modülleri kabul etmek gerekir. Varsayılan olarak hiçbir modül başlamaz ve SDK'yı başlatmanız için bunların her biri açıkça çağrılması gerekir.
App Center Analytics ve App Center Kilitlenmelerini kullanmak için uygulamanın ana etkinlik sınıfının onCreate -callback içine aşağıdaki App Center girin:

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

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

Hizmetleri ayrı olarak App Center gerekirse:

1. Uygulama Gizli Gizli'yi yapılandırarak veya başlatabilirsiniz.
2. Kod birden çok kez çağrılabilirse, uygulamanın App Center olup ola bir kontrol edin.
3. Gerekli hizmetleri App Secret olmadan başlatma.

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 (örneğin, bir derin bağlantı etkinliği, bir hizmet veya yayın alıcısı) varsa, uygulama özel sınıfında veya her giriş noktasında start çağrısı. İkinci durumda, çağrıdan önce App Center önceden yapılandırıldığından emin start olur:

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 tutucusunu App Secret'iniz ile değiştirin

Metni, {Your App Secret} uygulamanıza uygun gerçek değerle değiştir mutlaka kullanın. Uygulama Gizli Başlarken sayfasında veya Ayarlar portalında App Center bulunabilir.

Aşağıdaki Başlarken app secret kodunuz içeren yukarıdaki kod örneğini içerir. Örneğin tamamını kopyalayıp yapıştırabilirsiniz.

Yukarıdaki örnek, yönteminin nasıl kullanıla ve hem App Center Analytics'i hem de start() App Center içerir.

İ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 belirtmedikçe, bu modülü App Center kullanabilirsiniz. Ayrıca API, uygulama yaşam döngüsünde yalnızca bir kez kullanılabilir. Diğer tüm çağrılar konsola bir uyarı günlüğe kaydedilir ve yalnızca ilk çağrıya dahil edilen start() modüller kullanılabilir.

Örneğin- Yalnızca App Center Analytics'e App Center API çağrısını aşağıdaki start() gibi değiştirmeniz gerekir:

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

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

Android Studio ekleyemediklerinden otomatik olarak gerekli içeri aktarma deyimlerini önerir, ancak sınıf adlarının tanınmayıldığına ilişkin bir hata görüyorsanız etkinlik sınıfınıza aşağıdaki satırları içeri aktarma start() 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

Portalda SDK'nın otomatik olarak toplayan Analiz ve Kilitlenme verilerini görselleştirmek için hazırsınız.

Her iki hizmette de daha gelişmiş işlevleri özelleştirmeyi ve kullanmayı öğrenmek App Center Analytics ve App Center Kilitlenmeleri belgelerine bakın.

Uygulama güncelleştirmeleri ile çalışmaya başlamayı öğrenmek için Dağıt'ın App Center okuyun.