Aracılığıyla paylaş

Uygulamanızın kullandığı varsayılan kaynakları belirtin

Uygulamanızın bir müşteri cihazının belirli ayarlarıyla eşleşen kaynakları yoksa, uygulamanın varsayılan kaynakları kullanılır. Bu konuda, bu varsayılan kaynakların ne olduğunu belirtme adımları açıklanmaktadır.

Bir müşteri uygulamanızı Microsoft Store'dan yüklediğinde, müşterinin cihazındaki ayarlar uygulamanın kullanılabilir kaynaklarıyla eşleştirilir. Bu eşleştirme yapılır, böylece yalnızca ilgili kullanıcı için uygun kaynakların indirilmesi ve yüklenmesi gerekir. Örneğin, kullanıcının dil tercihleri için en uygun dizeler ve görüntüler ile cihazın çözünürlük ve DPI ayarları kullanılır. Örneğin, 200scaleiçin varsayılan değerdir, ancak isterseniz bu varsayılanı geçersiz kılabilirsiniz.

Kendi kaynak paketlerine (yüksek karşıtlık ayarları için uyarlanmış görüntüler gibi) girmeyen kaynaklar için bile, kullanıcının ayarlarıyla eşleşen bir kaynak bulunamazsa uygulamanın çalışma zamanında hangi varsayılan kaynakları kullanması gerektiğini belirtebilirsiniz. Örneğin, standardcontrastiçin varsayılan değerdir, ancak isterseniz bu varsayılanı geçersiz kılabilirsiniz.

Bu varsayılanlar, varsayılan kaynak niteleyici değerleri biçiminde belirtilir. Kaynak niteleyicilerinin ne olduğu, kullanımları ve amacı hakkında bir açıklama için bkz. Kaynaklarınızı dil, ölçek, yüksek karşıtlık ve diğer niteleyicileriçin uyarlama.

Bu varsayılanların ne olduğunu iki yoldan biriyle yapılandırabilirsiniz. Projenize bir yapılandırma dosyası ekleyebilir veya proje dosyanızı doğrudan düzenleyebilirsiniz. Bu seçeneklerden en rahatınız olan veya derleme sisteminizle en iyi şekilde çalışan seçenekleri kullanın.

Seçenek 1. Varsayılan niteleyici değerlerini belirtmek için priconfig.default.xml kullanma

  1. Visual Studio'da projenize yeni bir öğe ekleyin. XML Dosyası'nı seçin ve dosyayı priconfig.default.xmlolarak adlandırın.

  2. Çözüm Gezgini'nde priconfig.default.xml seçin ve Özellikler penceresini denetleyin. Dosyanın Derleme Eylemi 'Yok' olarak ayarlanmalıdır, Çıkış Dizinine Kopyala ise 'Kopyalama' olarak ayarlanmalıdır.

  3. Dosyanın içeriğini bu XML ile değiştirin.

    <default>
   <qualifier name="Language" value="LANGUAGE-TAG(S)" />
   <qualifier name="Contrast" value="standard" />
   <qualifier name="Scale" value="200" />
   <qualifier name="HomeRegion" value="001" />
   <qualifier name="TargetSize" value="256" />
   <qualifier name="LayoutDirection" value="LTR" />
   <qualifier name="DXFeatureLevel" value="DX9" />
   <qualifier name="Configuration" value="" />
   <qualifier name="AlternateForm" value="" />
</default>

    NotLANGUAGE-TAG(S) değerinin uygulamanızın varsayılan diliyle eşitlenmesi gerekir. Eğer bu, tek bir BCP-47 dil etiketiise, uygulamanızın varsayılan dili de aynı etiket olmalıdır. Bu, virgülle ayrılmış bir dil etiketleri listesiyse, uygulamanızın varsayılan dilinin listedeki ilk etiket olması gerekir. Uygulamanızın varsayılan dilini, uygulama paketi bildirim kaynak dosyanızın Uygulama sekmesindeki Varsayılan dil alanında ayarlarsınız ().

  4. Her <qualifier> öğesi, Visual Studio'ya her niteleyici adı için varsayılan olarak hangi değerin kullanılacağını söyler. Şu ana kadar sahip olduğunuz dosya içeriğiyle Visual Studio'nun davranışını gerçekten değiştirmediniz. Başka bir deyişle, Visual Studio , bu dosyanın bu içeriklerle zaten mevcut olduğunu varsayarak davrandı çünkü bunlar varsayılan ayarlardır. Bu nedenle, varsayılan değeri kendi varsayılan değerinizle geçersiz kılmak için dosyadaki bir değeri değiştirmeniz gerekir. İlk üç değeri düzenlediyseniz dosyanın nasıl görünebileceğine ilişkin bir örnek aşağıda verilmiştir.

    <default>
   <qualifier name="Language" value="de-DE" />
   <qualifier name="Contrast" value="black" />
   <qualifier name="Scale" value="400" />
   <qualifier name="HomeRegion" value="001" />
   <qualifier name="TargetSize" value="256" />
   <qualifier name="LayoutDirection" value="LTR" />
   <qualifier name="DXFeatureLevel" value="DX9" />
   <qualifier name="Configuration" value="" />
   <qualifier name="AlternateForm" value="" />
</default>

  5. Dosyayı kaydedip kapatın ve projenizi yeniden oluşturun.

Geçersiz kılınan varsayılanlarınızın dikkate alındığını onaylamak için dosya <ProjectFolder>\obj\<ReleaseConfiguration folder>\priconfig.xml arayın ve içeriğinin geçersiz kılmalarınızla eşleşip eşleşmediğini onaylayın. Varsa, uygulamanızın varsayılan olarak kullanacağı kaynakların niteleyici değerlerini başarıyla yapılandırmış olursunuz. Kullanıcının ayarlarıyla eşleşme bulunmazsa, klasör veya dosya adları burada ayarladığınız varsayılan niteleyici değerlerini içeren kaynaklar kullanılır.

Bu nasıl çalışır?

Arka planda Visual Studio, MakePri.exe adlı bir araç başlatarak, uygulamanızın tüm kaynaklarını açıklayan ve varsayılan kaynakların hangileri olduğunu belirten Paket Kaynak Dizini (PRI) olarak bilinen bir dosya oluşturur. Bu araç hakkında ayrıntılar için bkz. Kaynakları el ile derleme MakePri.exe. Visual Studio, MakePri.exe'a bir yapılandırma dosyası aktarır. priconfig.default.xml dosyanızın içeriği, varsayılan olarak kabul edilen niteleyici değerleri kümesini belirten bölüm olan yapılandırma dosyasının <default> öğesi olarak kullanılır. Bu nedenle, priconfig.default.xml eklemek ve düzenlemek, Visual Studio'nun uygulamanız için oluşturduğu ve uygulama paketine dahil ettiği Paket Kaynak Dizini dosyasının içeriğini etkiler.

Not<qualifier name="Language" ... /> öğesinin değerini her değiştirdiğinizde, bu değişikliği uygulamanızın varsayılan diliyle eşitlemeniz gerekir. Bu, uygulamanızın PRI dosyasında dizine alınan dil kaynaklarının uygulamanızın bildirim varsayılan diliyle eşleşmesini sağlar. <qualifier name="Language" ... /> öğesindeki değer, <ProjectFolder>\obj\<ReleaseConfiguration folder>\priconfig.xmliçeriği açısından bildirideki değerin yerine geçer, ancak bu dosya ve uygulamanızın bildirimi eşleşmelidir.

priconfig.default.xml yerine farklı bir dosya adı kullanın

Dosyanızı priconfig.default.xmladlandırdığınızda Visual Studio dosyayı tanır ve otomatik olarak kullanır. Farklı bir ad verirseniz Visual Studio'ya bildirmeniz gerekir. Proje dosyanızda, ilk <PropertyGroup> öğesinin açma ve kapatma etiketleri arasına bu XML'yi ekleyin.

<AppxPriConfigXmlDefaultSnippetPath>FILE-PATH-AND-NAME</AppxPriConfigXmlDefaultSnippetPath>

FILE-PATH-AND-NAME'ı dosyanızın yolu ve adıyla değiştirin.

Seçenek 2. Varsayılan niteleyici değerlerini belirtmek için proje dosyanızı kullanma

Bu, Seçenek 1'e bir alternatiftir. 1. Seçeneğin nasıl çalıştığını anladıktan sonra, geliştirme ve/veya derleme iş akışınıza daha uygunsa bunun yerine Seçenek 2'yi seçebilirsiniz.

Proje dosyanızda, ilk <PropertyGroup> öğesinin açma ve kapatma etiketleri arasına bu XML'yi ekleyin.

<AppxDefaultResourceQualifiers>Language=LANGUAGE-TAG(S)|Contrast=standard|Scale=200|HomeRegion=001|TargetSize=256|LayoutDirection=LTR|DXFeatureLevel=DX9|Configuration=|AlternateForm=</AppxDefaultResourceQualifiers>

İlk üç değeri düzenledikten sonra bunun nasıl görünebileceğini gösteren bir örnek aşağıda verilmiştir.

<AppxDefaultResourceQualifiers>Language=de-DE|Contrast=black|Scale=400|HomeRegion=001|TargetSize=256|LayoutDirection=LTR|DXFeatureLevel=DX9|Configuration=|AlternateForm=</AppxDefaultResourceQualifiers>

Projenizi kaydedip kapatın ve yeniden oluşturun.

NotLanguage= değerini her değiştirdiğinizde, bu değişikliği uygulamanızın bildirim tasarımcısındaki varsayılan diliyle eşitlemeniz gerekir (Package.appxmanifestaçarak).

  • Last updated on