UWP/winuı ile Başlarken

  • Makale
  • Okumak için 2 dakika

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

Uygulamanızda App Center analizlerini ve App Center kilitlenmeleri kullanmak için App Center SDK 'Yı ayarlamaya başlaalım.

1. ön koşullar

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

UWP projesi için:

  • projeniz Visual Studio 2017 güncelleştirme 15,9 veya sonraki bir sürümde ayarlanır.
  • Windows 10 build 16299 veya üzeri bir sürümü çalıştıran cihazları hedefliyoruz.
  • projeniz Evrensel Windows Platformu 6.2.8 veya sonraki bir sürüme başvuruyor (bu pakete genellikle örtük olarak başvurulur).
  • NuGet 4,3 veya üzeri.

WinUI projesi için:

  • projeniz Visual Studio 2019 güncelleştirme 16,9 veya sonraki bir sürümde ayarlanır.
  • Windows 10 build 17763 veya üzeri bir sürümü çalıştıran cihazları hedefliyoruz.
  • Projeniz WinUI 3 0.8.0 veya sonraki bir sürüme başvuruyor.

Not

UWP için Xamarin. Forms kullanmak istiyorsanız, bunun yerine Xamarin kullanmaya başlama belgelerini izleyin.

2. uygulama gizli anahtarını 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. Kaydolun veya oturum açın ve açılan menüden Yeni uygulama Ekle ' yi seçerek portalın sağ üst köşesindeki mavi düğmesine basın.
  2. Uygulamanız için bir ad ve isteğe bağlı bir açıklama girin.
  3. Yukarıda açıklandığı gibi projenize bağlı olarak uygun işletim sistemini ve platformu seçin.
  4. Yeni uygulama Ekle ' ye sağ alt köşedeki düğmeye basın.

bir uygulama oluşturduktan sonra, App Center portalındaki Ayarlar sayfasında uygulama gizli anahtarını elde edebilirsiniz. Ayarlar sayfanın sağ üst köşesinde üçlü dikey noktalara tıklayın ve Copy app secret uygulama gizli dizisini almak için öğesini seçin.

3. App Center SDK modüllerini ekleyin

App Center SDK Visual Studio veya Paket Yöneticisi konsolu kullanılarak tümleştirilebilir.

Visual Studio

  • 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.
  • Araştır sekmesinde, App Center Için arama yapın ve Microsoft. AppCenter. Analytics ve Microsoft. AppCenter. Crash paketlerini yükler.

Paket Yöneticisi Konsolu

  • Visual Studio' de konsolunu açın. bunu yapmak için araçlar > NuGet Paket Yöneticisi > Paket Yöneticisi konsolunu seçin.
  • Aşağıdaki komutları 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.

Not

App Center SDK 'Yı taşınabilir bir projede ( Xamarin. Forms gibi) kullanıyorsanız, paketleri her bir projeye yüklemelisiniz: taşınabilir, Android ve iOS. bunu yapmak için, her bir alt projeyi açmanız ve Visual Studio bölümünde açıklanan ilgili adımları izlemeniz gerekir.

4. özelliği ekleyin Internet (Client)

Visual Studio çözüm gezgini ' nde, uygulamanız için Package. appxmanifest dosyasına çift tıklayın. Özellikler sekmesine tıklayın ve ardından Internet (istemci) özelliğini kontrol edin.

5. 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 bunların her birini açıkça çağırmanız gerekir.

5,1 Using yönergelerini ekleme

API 'lerimizi kullanmadan önce uygun ad alanlarını ekleyin.

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

5,2 yöntemi ekleme Start()

Aşağıdaki çağrıyı uygulamanızın oluşturucusuna ekleyin:

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

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

  1. Uygulama gizli anahtarı ile yapılandırın veya başlatın.
  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("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

5,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ında 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 örnek, yönteminin nasıl kullanılacağını gösterir Start() ve App Center analizi içerir.

Her hizmeti, başlangıç yönteminde açıkça parametre olarak 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ıda yer alan hizmetler kullanılabilir.

Harika, portalda SDK 'nın otomatik olarak topladığı analizler 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.