Android Öykünücüsü'nda hata ayıklama

Bu kılavuzda, uygulamanızda hata ayıklamak ve test etmek için Android Öykünücüsü'nde bir sanal cihaz başlatmayı öğreneceksiniz.

Android Öykünücüsü (.NET iş yüküyle mobil geliştirmenin bir parçası olarak yüklenir), farklı Android cihazlarının benzetimini yapmak için çeşitli yapılandırmalarda çalıştırılabilir. Bu yapılandırmaların her biri sanal cihaz olarak oluşturulur. Bu kılavuzda, öykünücüyü Visual Studio'dan başlatmayı ve uygulamanızı bir sanal cihazda çalıştırmayı öğreneceksiniz. Android Öykünücüsü'yü yapılandırma ve yeni sanal cihazlar oluşturma hakkında bilgi için bkz . Android Öykünücüsü Kurulumu.

Önceden Yapılandırılmış Sanal Cihaz Kullanma

Visual Studio, cihaz açılan menüsünde görünen önceden yapılandırılmış sanal cihazlar içerir. Örneğin, aşağıdaki Visual Studio 2017 ekran görüntüsünde, önceden yapılandırılmış birkaç sanal cihaz kullanılabilir:

  • VisualStudio_android-23_arm_phone

  • VisualStudio_android-23_arm_tablet

  • VisualStudio_android-23_x86_phone

  • VisualStudio_android-23_x86_tablet

Virtual devices

Genellikle, bir telefon uygulamasını test etmek ve hatalarını ayıklamak için VisualStudio_android 23_x86_phone sanal cihazını seçersiniz. Bu önceden yapılandırılmış sanal cihazlardan biri gereksinimlerinizi karşılıyorsa (örneğin, uygulamanızın hedef API düzeyiyle eşleşiyorsa), uygulamanızı öykünücüde çalıştırmaya başlamak için Öykünücüyü Başlatma bölümüne atlayın. (Android API düzeylerini henüz bilmiyorsanız bkz. Android API Düzeylerini Anlama.)

Xamarin.Android projeniz kullanılabilir sanal cihazlarla uyumsuz bir Hedef Çerçeve düzeyi kullanıyorsa, açılan menüde Desteklenmeyen Cihazlar altında kullanılamayan sanal cihazlar listelenir. Örneğin, aşağıdaki projede, bu örnekte listelenen Android 6.0 sanal cihazlarıyla uyumsuz olan Android 7.1 Nougat (API 25) olarak ayarlanmış bir Hedef Çerçeve vardır:

Incompatible virtual device

Projenin En Düşük Android Sürümünü, kullanılabilir sanal cihazların API düzeyiyle eşleşecek şekilde değiştirmek için En Düşük Android Hedefini Değiştir'e tıklayabilirsiniz. Alternatif olarak, Hedef API düzeyinizi destekleyen yeni sanal cihazlar oluşturmak için Android Aygıt Yöneticisi kullanabilirsiniz. Sanal cihazları yeni bir API düzeyi için yapılandırabilmeniz için önce ilgili API düzeyine karşılık gelen sistem görüntülerini yüklemeniz gerekir (bkz . Xamarin.Android için Android SDK'sını ayarlama).

Sanal Cihazları Düzenleme

Sanal cihazları değiştirmek (veya yenilerini oluşturmak için) Android Aygıt Yöneticisi kullanmanız gerekir.

Öykünücüyü Başlatma

Visual Studio'nun üst kısmında Hata Ayıkla veya Yayın modu'nu seçmek için kullanılabilecek bir açılan menü vardır. Hata Ayıkla'nın seçilmesi, hata ayıklayıcının uygulama başlatıldıktan sonra öykünücünün içinde çalışan uygulama işlemine eklenmesine neden olur. Yayın modu seçildiğinde hata ayıklayıcı devre dışı bırakılır (ancak yine de uygulamayı çalıştırabilir ve hata ayıklama için günlük deyimlerini kullanabilirsiniz). Cihaz açılan menüsünden bir sanal cihaz seçtikten sonra Hata Ayıkla veya Yayın modu'nu seçin ve ardından Yürüt düğmesine tıklayarak uygulamayı çalıştırın:

Öykünücü başlatıldıktan sonra Xamarin.Android, uygulamayı öykünücüye dağıtır. Öykünücü, uygulamayı yapılandırılmış sanal cihaz görüntüsüyle çalıştırır. Aşağıda Android Öykünücüsü'ne ilişkin örnek bir ekran görüntüsü görüntülenir. Bu örnekte öykünücü, MyApp adlı boş bir uygulama çalıştırıyor:

Emulator running a blank app

Öykünücü çalışır durumda bırakılabilir: Uygulama her başlatıldığında kapatmak ve yeniden başlatılmasını beklemek gerekmez. Öykünücüde ilk kez bir Xamarin.Android uygulaması çalıştırıldığında, hedeflenen API düzeyi için Xamarin.Android paylaşılan çalışma zamanı yüklenir ve ardından uygulama yüklenir. Çalışma zamanı yüklemesi birkaç dakika sürebilir, bu nedenle lütfen sabırlı olun. Çalışma zamanının yüklenmesi yalnızca ilk Xamarin.Android uygulaması öykünücüye dağıtıldığında gerçekleşir; sonraki dağıtımlar daha hızlıdır çünkü yalnızca uygulama öykünücüye kopyalanır.

Hızlı Önyükleme

Android Öykünücüsünün daha yeni sürümleri, öykünücüyü yalnızca birkaç saniye içinde başlatan Hızlı Önyükleme adlı bir özellik içerir. Öykünücüyü kapattığınızda, sanal cihaz durumunun anlık görüntüsünü alır, böylece yeniden başlatıldığında bu durumdan hızla geri yüklenebilir. Bu özelliğe erişmek için aşağıdakiler gerekir:

  • Android Öykünücüsü sürüm 27.0.2 veya üzeri
  • Android SDK Araçları sürüm 26.1.1 veya üzeri

Öykünücü ve SDK araçlarının yukarıda listelenen sürümleri yüklendiğinde, Hızlı Önyükleme özelliği varsayılan olarak etkinleştirilir.

Anlık görüntü henüz oluşturulmadığından sanal cihazın ilk soğuk önyüklemesi hız iyileştirmesi yapılmadan gerçekleştirilir:

Cold Boot screenshot

Öykünücüden çıktığınızda, Hızlı Önyükleme öykünücünün durumunu anlık görüntüye kaydeder:

Saving state on shutdown

Öykünücü, öykünücüyü kapattığınız durumu geri yüklediğinden sonraki sanal cihaz çok daha hızlı başlatılır.

Loading state on restart

Sorun giderme

Yaygın öykünücü sorunlarına yönelik ipuçları ve geçici çözümler için bkz . Android Öykünücüsü Sorunlarını Giderme.

Özet

Bu kılavuzda, Android Öykünücüsü'yü Xamarin.Android uygulamalarını çalıştıracak ve test edecek şekilde yapılandırma işlemi açıklanmıştır. Önceden yapılandırılmış sanal cihazları kullanarak öykünücüyü başlatma adımlarını açıklar ve Visual Studio'dan öykünücüye uygulama dağıtma adımlarını sağlar.

Android Öykünücüsü'yü kullanma hakkında daha fazla bilgi için aşağıdaki Android Geliştirici konularına bakın: