Xamarin'i Kullanmaya Başlama

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

App Center Analytics ve App Center kilitlenmeleri kullanmak için uygulamanızda Xamarin SDK App Center ayarlamaya başlaalım. Uygulamanıza App Center dağıtım eklemek için App Center dağıtım belgelerinegöz atın.

1. ön koşullar

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

• Projeniz Visual Studio 2017 veya Mac için Visual Studio ayarlanır.
• İOS 9,0 veya üzeri ya da Android 5,0 (API düzeyi 21) veya üzerini çalıştıran cihazları hedefliyorsanız.
• Kilitlenme raporlama işlevselliği sağlayan başka bir SDK kullanmıyoruz.

Xamarin için App Center SDK aşağıdaki platformları destekler:

• Xamarin.Android
• Xamarin.iOS
• Xamarin. Forms (iOS, Android, UWP ve Windows Masaüstü uygulamaları)

1,1 Xamarin. Android hakkında

Yalnızca Android platformunu hedefliyorsanız bu seçeneği belirleyin. Platform olarak Android ve Xamarin gibi App Center portalında bir uygulama oluşturmanız gerekir.

1,2 Xamarin. iOS hakkında

Yalnızca iOS platformunu hedefliyorsanız bu seçeneği belirleyin. İOS ile App Center portalında, platform olarak OS ve Xamarin olarak bir uygulama oluşturmanız gerekir.

1,3 Xamarin. Forms (iOS, Android, UWP ve Windows Masaüstü) hakkında

İOS, Android, UWP ve Windows Masaüstü cihazları için platformlar arası bir uygulama oluşturmak istiyorsanız bu seçeneği belirleyin. Her işletim sistemi için bir tane olmak App Center 4 uygulama oluşturmanız gerekir.

Android ve iOS uygulamaları için platform olarak Xamarin'i seçmeniz gerekir (UWP'nin Xamarin seçeneği yok).

Windows Masaüstü uygulamaları için projenizi Xamarin platformuyla uyumluluk için yapılandırmanız gerekir.

2. Uygulama Gizli App Center almak için App Center Portal'da oluşturun

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

1. appcenter.ms.
2. Kaydol veya oturum açın ve portalın sağ üst köşesindeki Yeni ekle'ye 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. Yukarıda açıklandığı gibi projenize bağlı olarak uygun işletim sistemi ve platformu seçin.
5. Sağ alttaki Add new app (Yeni uygulama ekle) düğmesine basın.

Bir uygulama oluşturduktan sonra, uygulama gizli App Center Portal'ın Ayarlar sayfasından edinebilirsiniz. Ayarlar sayfasının sağ üst köşesinde üç dikey noktaya tıklayın ve App Copy app secret Secret'inizi almak için öğesini seçin.

3. App Center SDK'sı çözümünüze ekleme

App Center SDK, Visual Studio veya Paket Yöneticisi Konsolu kullanılarak tümleştirebilirsiniz.

Mac için Visual Studio

• Yeni Mac için Visual Studio.
• Dosya > Aç'a tıklayın ve çözümlerinizi seçin.
• Çözüm gezgininde Paketler bölümüne sağ tıklayın ve NuGet paketleri ekle... öğesini seçin.
• için arama App Center Analytics'i App Center'i seçin ve App Center Kilitlenmeler'i seçin.
• Paket Ekle'ye tıklayın.

Windows için Visual Studio

• Windows için Visual Studio 'Yu açın.
• Dosya > Aç ' a tıklayın ve çözümünüzü seçin.
• Çözüm Gezgini ' nde, Başvurular ' a sağ tıklayın ve NuGet Paketlerini Yönet' i seçin.
• App Center arayın ve Microsoft. AppCenter. Analytics ve Microsoft. AppCenter. Crash paketlerini yükler.

Paket Yöneticisi Konsolu

• Konsolunu Visual Studio'da açın. Bunu yapmak için Araçlar > NuGet Paket Yöneticisi > Paket Yöneticisi konsolu' nu seçin.
• Mac için Visual Studio' de çalışıyorsanız NuGet paket yönetimi uzantıları'nı yüklediğinizden emin olun. Bunun için, Visual Studio > uzantıları' nı seçin, gerekirse NuGet ve install ' ı arayın.
• Konsola aşağıdaki komutu yazın:

Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Artık SDK 'yı uygulamanızda tümleştirmiş olduğunuza göre, SDK 'Yı başlatıp App Center hizmetlerinden yararlanabilirsiniz.

4. SDK 'Yı başlatın

App Center kullanmak için, kullanmak istediğiniz modüller (ler) i kabul etmeniz gerekir. Varsayılan olarak, hiçbir modül başlatılmaz ve SDK 'Yı başlatırken her birini açıkça çağırmanız gerekir.

4,1 Using deyimlerini ekleme

API 'lerimizi kullanmaya başlamadan önce uygun ad alanlarını ekleyin.

• Xamarin. iOS -projeyi açın AppDelegate.cs ve var olan deyimlerin altına aşağıdaki satırları ekleyin using
• Xamarin. Android -projeyi açın MainActivity.cs ve var olan deyimlerin altına aşağıdaki satırları ekleyin using
• Xamarin. Forms -projeyi açın App.xaml.cs ve var olan deyimlerin altına aşağıdaki satırları ekleyin using

using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;

4.2 Yöntemini Start() ekleme

4.2.1 Xamarin.Android

Projenin MainActivity.cs dosyasını açın ve Start() yönteminin içine OnCreate() çağrıyı ekleyin

AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));

4.2.2 Xamarin.iOS

Projenin dosyasını açın AppDelegate.cs ve yönteminin Start() içine çağrıyı FinishedLaunching() ekleyin

AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));

4.2.3 Xamarin.Forms

iOS, Android ve UWP platformlarını hedef alan bir Xamarin.Forms uygulaması kullanmak için App Center portalında her platform için bir tane olmak üzere üç uygulama oluşturmanız gerekir. Üç uygulama oluşturmak size üç Uygulama gizli dizisi (her biri için bir tane) sağlar. Projenin App.xaml.cs dosyasını (veya sınıfından devralan sınıfınızı) paylaşılan veya taşınabilir projenize açın ve aşağıdaki Xamarin.Forms.Application yöntemini yöntemine OnStart() ekleyin.

AppCenter.Start("ios={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}", typeof(Analytics), typeof(Crashes));

Hizmetleri ayrı olarak App Center gerekirse:

1. Uygulama Gizli Gizli'yi yapılandırarak veya başlatabilirsiniz.
2. Kod birden çok kez çağrılabilecek ise App Center zaten yapılandırılıp yapılandırılmadığını denetleyin.
3. Gerekli hizmet (ler) i uygulama gizli anahtarı olmadan başlatın.

AppCenter.Configure("ios={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics));
    AppCenter.Start(typeof(Crashes));
}

4.2.4 cihazlar hakkında yanlış bilgi almayı önlemek için otomatik yedekleme kullanıyorsanız, sonraki adımları izleyin:

1. Resources/XML klasöründe appcenter_backup_rule.xml dosya oluşturun.

2. Projenin AndroidManifest.xml dosyasını açın. android:fullBackupContentÖzniteliğini <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>

4,3 yer tutucusunu uygulamanızın gizli anahtarı ile değiştirin

{Your App Secret}Metninizi uygulamanızın gerçek değeri ile değiştirdiğinizden emin olun. Uygulama gizli anahtarı, App Center portalındaki Başlarken sayfası veya ayarları sayfasında bulunabilir.

Başlarken sayfası, uygulama gizli anahtarı ile birlikte yukarıdaki kod örneğini içerir. tüm örneği kopyalayabilir ve yapıştırabilirsiniz.

Yukarıdaki örnekte yönteminin nasıl kullanılacağı Start() ve App Center analizlerinin ve App Center kilitlenmelerin nasıl dahil olduğu gösterilmektedir.

İki hizmetten birini kullanmak istemiyorsanız, Yukarıdaki yöntem çağrısından karşılık gelen 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. Ayrıca, start() API uygulamanızın 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ıya dahil edilen modüller kullanılabilir olacaktır.

Örneğin, App Center Analytics 'e eklemek istiyorsanız, Start() çağrıyı aşağıdaki gibi değiştirmelisiniz:

4.3.1 Xamarin. Android ve Xamarin. iOS

AppCenter.Start("{Your App Secret}", typeof(Analytics));

4.3.2 Xamarin. Forms

AppCenter.Start("ios={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}", typeof(Analytics));

Harika, portalda SDK 'nın otomatik olarak topladığı analiz ve kilitlenme verilerini görselleştirmeye hazırsınız.

Her iki hizmetin de daha gelişmiş işlevlerini nasıl özelleştireceğinizi ve kullanabileceğinizi öğrenmek için App Center Analytics ve App Center kilitlenmelere yönelik belgelere bakın.

Uygulama içi güncelleştirmelerle çalışmaya başlama hakkında bilgi edinmek için App Center dağıtımbelgelerini okuyun.