Diğer Android API'leri

Günlük düzeyini ayarlama

Günlük iletilerinin miktarını LogCat'te App Center günlük iletilerinin miktarını kontrol altına alabilirsiniz. Hata ayıklama AppCenter.setLogLevel() sırasında ek günlüğe kaydetmeyi etkinleştirmek için API'yi kullanın. Günlük düzeyleri içinde tanımlananlara karşılık android.util.Log gelenler. Varsayılan olarak, hata ayıklanabilir olmayan ASSERT uygulamalar ve hata ayıklanabilir uygulamalar için olarak WARN ayarlanır. Günlük düzeyini istediğiniz zaman ayarlayabilirsiniz.

Mümkün olduğunca çok günlük mesajına sahip olmak için Log.Verbose kullanın.

AppCenter.setLogLevel(Log.VERBOSE);

AppCenter.setLogLevel(Log.VERBOSE)

Yüklemeleri tanımlama

Uygulama App Center SDK'sı, uygulama yüklendikten sonra her cihaz için bir UUID oluşturur. Bu tanımlayıcı, uygulama güncelleştirildiğinde ve yalnızca uygulama yeniden yüklenirken veya kullanıcı tüm uygulama verilerini el ile sildiğinde yeni bir tane güncelleştirilirken cihaz için aynı kalır. Aşağıdaki API, hata ayıklama amacıyla yararlıdır.

AppCenter.getInstallId();

AppCenter.getInstallId()

Bu API zaman uyumsuz bir işlemdir, bu konuda daha fazla bilgi için App Center API'ler kılavuzumuza bakabilirsiniz.

Kullanıcıları tanımlama

App Center SDK'sı, kilitlenme raporlarını artırmak için kullanılan bir kullanıcı kimliği ayarlamayı destekler. Bu özelliği kullanmak için:

1. App Center App Center SDK'sı Başlarken AppCenter.start(...) kılavuzunda açıklandığı gibi çağırarak App Center SDK'sı yapılandırma.
2. Aşağıdaki kodu userID kullanarak SDK'da bir ayarlayın:

AppCenter.setUserId("your-user-id");

AppCenter.setUserId("your-user-id")

Bir kullanıcı kimliği ayardikten sonra, App Center için belirli kilitlenme raporlarını aramak üzere kullanıcının arama özelliğini kullanabilirsiniz. Daha fazla bilgi App Center'nin arama belgelerinde bulabilirsiniz.

Çalışma zamanında tüm hizmetleri devre dışı bırakma

Tüm hizmet hizmetlerini aynı App Center devre dışı bırakmak için setEnabled() API'yi kullanın. Devre dışı bırakılmıştır, SDK herhangi bir bilgiyi App Center.

AppCenter.setEnabled(false);

AppCenter.setEnabled(false)

Tüm hizmetleri aynı anda etkinleştirmek için aynı API'yi kullanın ancak parametre true olarak geçişin.

AppCenter.setEnabled(true);

AppCenter.setEnabled(true)

Durum, uygulama başlatan tüm cihaz depolamalarında kalıcıdır.

Bu API zaman uyumsuz bir işlemdir, bu konuda daha fazla bilgi için App Center API'ler kılavuzumuza bakabilirsiniz.

Ağ isteklerinin izinlerini geri ala

App Center SDK'da ağ isteklerine varsayılan olarak izin verilir. App Center SDK'sı tarafından kullanıcı endişesi tarafından toplayan verileri göndermek için otomatik veri göndermeye izin vermezsiniz.

AppCenter.setNetworkRequestsAllowed(false);

AppCenter.setNetworkRequestsAllowed(false)

Bu durumda, App Center SDK'sı veri toplamaya devam eder ancak yalnızca ağ isteklerine izin verilmiyorsa gönderilir.

AppCenter.setNetworkRequestsAllowed(true);

AppCenter.setNetworkRequestsAllowed(true)

Herhangi bir zamanda, sdk'sına veri göndermeye izin veri App Center izin verisi veri gönderip gönderememeyebilirsiniz.

AppCenter.isNetworkRequestsAllowed();

AppCenter.isNetworkRequestsAllowed()

Çalışma zamanında hizmetin durumunu değiştirme

Çalışma zamanında aşağıdaki kodla hizmetleri etkinleştirin veya devre dışı bırakma:

Analytics.setEnabled(false);

Analytics.setEnabled(false)

Etkin olup App Center denetleme

Ayrıca, etkin olup App Center olmadığını da kontrol edin.

AppCenter.isEnabled();

AppCenter.isEnabled()

Bu API zaman uyumsuz bir işlemdir, bu konuda daha fazla bilgi için App Center API'ler kılavuzumuza bakabilirsiniz.

Çalışma App Center SDK sürümünü denetleme

Şu anda kullanmakta App Center SDK sürümünü edinebilirsiniz.

AppCenter.getSdkVersion();

AppCenter.getSdkVersion()

API'yi çağırarak özel özellikleri setCustomProperties() ayarlayın. Özel özellik için geçerli bir anahtar normal ifade deseniyle ^[a-zA-Z][a-zA-Z0-9]*$ eşleşmeli. Özel bir özelliğin değeri şu Java türlerinden biri olabilir: String , Number ve boolean Date .

CustomProperties properties = new CustomProperties();
properties.set("color", "blue").set("score", 10);
AppCenter.setCustomProperties(properties);

val properties = CustomProperties()
properties.set("color", "blue").set("score", 10)
AppCenter.setCustomProperties(properties)

API'yi çağırarak herhangi bir özel özelliği clear() kaldırabilirsiniz. Bu, yalnızca bir cihazın özelliğinin değerini kaldırır. Özellik adını portaldan kaldırmaz App Center.

CustomProperties properties = new CustomProperties();
properties.clear("score");
AppCenter.setCustomProperties(properties);

val properties = CustomProperties()
properties.clear("score")
AppCenter.setCustomProperties(properties)

Depolama boyutu

App Center SDK'sı kullanırken günlükler cihazda yerel olarak depolanır. Büyük günlüklerde çok fazla alan olabilir, bu nedenle yerel veritabanının boyutunu sınırlamayı seçebilirsiniz. Ayrıca ve API'leri ile birlikte pause resume de yararlıdır. Uzun süre duraklatılmış olmasını bekliyorsanız, daha fazla olay depolamak için daha büyük bir veritabanı boyutu kullanabilirsiniz.

Yerel veritabanı boyutunu setMaxStorageSize ayarlamak için API'yi kullanabilirsiniz. API zaman uyumsuz bir işlemdir ve hizmetleri yeniden başlatmadan önce App Center çağrılır. Bu nedenle setMaxStorageSize çağrısının öncesinde çağrılmaları AppCenter.start(...) gerekir. API'yi yalnızca bir kez çağırabilirsiniz.

// Use 20 MB for storage.
AppCenter.setMaxStorageSize(20 * 1024 * 1024L).thenAccept(new AppCenterConsumer<Boolean>() {

    @Override
    public void accept(Boolean success) {
        // The success parameter is false when the size can't be honored.
    }
});
AppCenter.start("{Your App Secret}", Analytics.class);

// Use 20 MB for storage.
AppCenter.setMaxStorageSize(20 * 1024 * 1024).thenAccept {
    // The success parameter (it) is false when the size can't be honored.
}

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

En büyük depolama boyutunu ayarlayamasanız, SDK varsayılan en fazla 10 MB boyutu kullanır. Ayarlamasına izin verilen en küçük boyut 20 KB'tır.

Dağıtım depoları ekleme

Varsayılan olarak uygulama içinde güncelleştirmeler, tanımlı mağaza listesinden yüklenmiş uygulamalar için çalışır. Uygulamalarınızı önceden tanımlanmış mağaza listesinde yer alan mağazalar aracılığıyla dağıtmak için, uygulamayı başlatmadan önce aşağıdaki API'yi kullanarak gerekli App Center ekleyebilirsiniz:

    Set<String> stores = new HashSet<String>();
    stores.add("com.store1.packageinstaller");
    stores.add("com.store2.packageinstaller");
    Distribute.addStores(stores);

Başarısız API çağrıları

Geri çağırmanın başarısız olması için birçok neden vardır.

• Belirtilen boyut geçersiz bir değerdir (20 KB'den küçük veya 140 TB'den büyük).
• Geçerli veritabanı boyutu belirtilen en büyük boyuttan büyüktür.
• API zaten çağrılmış. İşlem başına yalnızca bir kez yapılandırmış oluruz.
• API'den sonra AppCenter.start(...) çağrıldı.

Yapılandırma sorunlarını gidermek için günlük etiketini kullanarak AppCenter konsolunda uyarıları ve hataları kontrol edin.

Uygulamanın zaman uyumsuz API'leri Android SDK

[! INCLUDE [Android Async API'leri]