İçin XAML önizleyicisi Xamarin.Forms

  • Makale
  • Okumak için 3 dakika

Siz yazarken oluşturulan düzenlerinizi görün

Uyarı

xaml önizleyici Visual Studio 2019 sürüm 16,8 ve Mac için Visual Studio sürüm 8,8 ' de kullanımdan kaldırılmıştır ve Visual Studio 2019 sürüm 16,9 ve Mac için Visual Studio sürüm 8,9 ' deki XAML dinamik yeniden yükleme özelliği ile değiştirilmiştir. Belgelerdexaml Hot Reload yükleme hakkında daha fazla bilgi edinin.

Genel Bakış

XAML önizleyici, Xamarin.Forms xaml sayfanızın iOS ve Android 'de nasıl görüneceğini gösterir. XAML 'de değişiklikler yaptığınızda, bu, kodunuzun hemen yanında önizlemesi görüntülenir. XAML önizleyici Visual Studio ve Mac için Visual Studio kullanılabilir.

Başlarken

Visual Studio 2019

Bölünmüş Görünüm bölmesindeki oklara tıklayarak XAML Önizleyiciyi açabilirsiniz. Varsayılan bölünmüş görünüm davranışını değiştirmek istiyorsanız, Araçlar Seçenekler > Xamarin >Xamarin.Forms xaml önizleyicisi iletişim kutusunu kullanın. Bu iletişim kutusunda varsayılan belge görünümünü ve bölünmüş yönü seçebilirsiniz.

<Span sınıfı =<span class= Visual Studio "data-linktype =" göreli-yol "/>Visual Studio" title = "önizleyici seçeneklerinde Xamarin. Forms önizleyicisi seçenekleri

Bir XAML dosyası açtığınızda, düzenleyici Araçlar Seçenekler > Xamarin >Xamarin.Forms xaml önizleyicisi iletişim kutusunda seçilen ayarlara bağlı olarak tam boyutlu veya önizleyici 'nin yanında açılır. Ancak bölme, düzenleyici penceresindeki her bir dosya için değiştirilebilir.

XAML önizleme denetimleri

Bölünmüş görünüm bölmesinde bu düğmeleri seçerek kodunuzu, XAML önizleyicisi veya her ikisini de görmek isteyip istemediğinizi seçin. Ortadaki düğme, önizleyicinin ve kodunuzun ne tarafında olduğunu değiştirir:

<Span sınıfı =<span class= Visual Studio "data-linktype =" göreli-yol "/>içindeki tasarım, kaynak ve bölünmüş görünüm arasında geçiş yapmak için Visual Studio" title = "önizleyici denetimlerinde tasarım, kaynak ve bölünmüş görünüm arasında geçiş yapmak için Xamarin. Forms önizleyicisi denetimleri

Ekranın dikey veya yatay olarak bölünmeyeceğini değiştirebilir veya bir bölmeyi tamamen daraltabilirsiniz:

<Span sınıfı =<span class= Visual Studio "data-linktype =" göreli yol "/>Visual Studio" title = "önizleyici bölmesi yönlendirme denetimlerinde Xamarin. Forms önizleyicisi bölmesi yönlendirme denetimleri

XAML Önizleyiciyi etkinleştirme veya devre dışı bırakma

Varsayılan >olarak > seçerek xaml Önizleyiciyi araç seçenekleri > Xamarin >Xamarin.Forms xaml önizleyicisi iletişim kutusunda kapatabilirsiniz. Bu, belge anahattını, özellik panelini ve XAML Araç kutusunu da kapatır. XAML önizleyicisi ve bu araçları yeniden etkinleştirmek için varsayılan xaml düzenleyicinizi önizleyiciolarak değiştirin.

Mac için Visual Studio

Bir XAML sayfası açtığınızda, düzenleyicide Önizleme düğmesi görüntülenir. Herhangi bir XAML belge penceresinin sol alt kısmındaki Önizleme veya bölme düğmelerine basarak Önizleyiciyi gösterin veya gizleyin:

<Span sınıfı =<span class= Preview veya Split Button "Data-LinkType =" göreli yol "/>ile Xamarin. Forms önizleyicisi etkin

Not

Mac için Visual Studio eski sürümlerinde, önizleme düğmesi pencerenin sağ üst kısmında yer alır.

XAML Önizleyiciyi etkinleştirme veya devre dışı bırakma

varsayılan >olarak > seçerek Visual Studio tercihleri > metin düzenleyicisi > xaml iletişim kutusunda xaml önizleyiciyi devre dışı bırakabilirsiniz. Bu, belge anahattını, özellik panelini ve XAML Araç kutusunu da kapatır. XAML önizleyicisi ve bu araçları yeniden etkinleştirmek için varsayılan xaml düzenleyicinizi önizleyiciolarak değiştirin.

XAML önizleyicisi seçenekleri

Önizleme bölmesinin üst kısmında bulunan seçenekler şunlardır:

Tasarım modunu Algıla

Statik Xamarin_Forms _DesignMode_IsDesignModeEnabled "Data-LinkType =" Absolute-path ">DesignMode.IsDesignModeEnabled özelliği uygulamanın önizleyicide çalışıp çalışmadığını söyler. Bu işlemi kullanarak, yalnızca uygulama önizleyicide çalıştırıldığında veya çalışmadığı zaman yürütülecek kodu belirtebilirsiniz:

if (DesignMode.IsDesignModeEnabled)
{
  // Previewer only code  
}

if (!DesignMode.IsDesignModeEnabled)
{
  // Don't run in the Previewer  
}

Sayfa oluşturucuda tasarım zamanında çalışamaan bir kitaplık başlattığınızda bu özellik faydalıdır.

Sorun giderme

Önizleyicinin çalışmaması durumunda aşağıdaki sorunları ve Xamarin forumlarınıkontrol edin.

XAML önizleyicisi bir hata göstermez veya gösterilmiyor

  • Önizleyicinin başlatılması biraz zaman alabilir-"oluşturma başlatılıyor" a kadar bir süre sonra görürsünüz.
  • XAML dosyasını kapatıp yeniden açmayı deneyin.
  • AppSınıfınız parametresiz bir oluşturucuya sahip olduğundan emin olun.
  • Sürümünüzü kontrol edin; Xamarin.Forms en az Xamarin.Forms 3,6 olmalıdır. NuGet aracılığıyla en son sürüme güncelleştirebilirsiniz Xamarin.Forms .
  • JDK yüklemenizi denetleyin-Android önizlemesi için en az JDK 8gerekir.
  • Sayfada bulunan C# kodundaki tüm başlatılmış sınıfları sarmalama deneyin if (!DesignMode.IsDesignModeEnabled) .

Özel denetimler işlenmiyor

Projenizi oluşturmayı deneyin. Önizleyici, denetimi işleyemediğinde denetimin temel sınıfını gösterir veya denetimin Oluşturucusu tasarım süresi oluşturmayı kabul ettiğinde gösterir. Daha fazla bilgi için bkz. xaml önizleyicide özel denetimleri işleme.