Freigeben über


Windows 8.1 Store-Apps: Angeben von Standardressourcen, die auf einem Gerät installiert werden

 

Gilt für Windows und Windows Phone

Wenn ein Benutzer eine App installiert, versucht das Betriebssystem des Geräts, die verschiedenen Ressourcen in der App zu identifizieren und zu installieren, beispielsweise UI-Zeichenfolgen und auflösungsspezifische Bilder, die für das Gerät geeignet sind, auf dem die App installiert wird. Beispielsweise könnte eine App Zeichenfolgen auf Spanisch enthalten, die auf Geräten installiert werden kann, die auf ein entsprechendes Gebietsschema festgelegt sind. Allerdings verfügt Ihre App unter Umständen nicht über geeignete Ressourcen für jedes Gerät und Gebietsschema Ihrer Benutzer. In diesen Fällen werden vom Betriebssystem des Benutzergeräts standardmäßig Ressourcen installiert, die für Ihren Entwicklungscomputer, dessen Gebietsschema und andere Einstellungen geeignet sind. Wenn Sie verschiedene Ressourcen auf dem Gerät installieren möchten, können Sie diese festlegen, indem Sie eine Konfigurationsdatei hinzufügen. Wenn Sie Ihre Projektdatei direkt bearbeiten möchten, können Sie dies auch auf diese Weise tun.

Option 1: Hinzufügen einer Konfigurationsdatei zur Projektmappe

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt der App, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Neues Element.

  2. Klicken Sie im Dialogfeld Neues Element hinzufügen auf XML-Datei, geben Sie der Datei den Namen priconfig.default.xml, und klicken Sie dann auf Hinzufügen.

  3. Ersetzen Sie den Inhalt der Datei durch folgendes XML.

    <default>
      <qualifier name="Language" value=Value />
      <qualifier name="Contrast" value=Value />
      <qualifier name="Scale" value=Value />
      <qualifier name="HomeRegion" value=Value />
      <qualifier name="TargetSize" value=Value />
      <qualifier name="LayoutDirection" value=Value />
      <qualifier name="DXFeatureLevel" value=Value />
      <qualifier name="Configuration" value=Value />
      <qualifier name="AlternateForm" value=Value />
    </default>
    

    Im nächsten Schritt ersetzen Sie die Value-Platzhalter durch gültige Ressourcenqualifizierer. Weitere Informationen erhalten Sie unter Benennen von Ressourcen mit Qualifizierern (Apps mit C#/VB/C++ und XAML) oder Benennen von Ressourcen mithilfe von Qualifizierern (Apps mit JavaScript und HTML).

  4. Ersetzen Sie jeden Value-Platzhalter durch einen gültigen Ressourcenqualifizierer.

    Das folgende Beispiel zeigt, wie das XML dargestellt wird, nachdem Sie die Value-Platzhalter durch gültige Ressourcenqualifizierer ersetzt haben.

    <default>
      <qualifier name="Language" value="en-us" />
      <qualifier name="Contrast" value="standard" />
      <qualifier name="Scale" value="120" />
      <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. Speichern und schließen Sie die Datei "priconfig.default.xml".

  6. Klicken Sie im Projektmappen-Explorer auf die Datei priconfig.default.xml.

  7. Ändern Sie im Fenster Eigenschaften die Werte der folgenden Eigenschaften abhängig von der Sprache des Projekts.

    • Bei C#- und VB-Projekten legen Sie die Eigenschaft Buildvorgang auf Keine fest.

    • Bei JavaScript-Projekten legen Sie für die Eigenschaft Paketaktion den Wert Keine fest.

    • Bei C++-Projekten legen Sie für die Eigenschaft Inhalt den Wert Falsch fest.

  8. Klicken Sie im Menü Erstellen auf Projektmappe erstellen.

  9. Öffnen Sie die Datei "priconfig.xml" im Ordner Projektordner**\obj\**ReleaseConfiguration im Editor.

  10. Vergewissern Sie sich, dass die Qualifizierer, die Sie hinzugefügt haben, in der Datei angezeigt werden.

Umbenennen der Datei "priconfig.default.xml"

Sie können der Konfigurationsdatei einen beliebigen Namen geben. Wenn Sie der Datei allerdings einen anderen Namen als priconfig.default.xml geben, müssen Sie eine Buildeigenschaft zur Projektdatei hinzufügen.

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, und klicken Sie anschließend auf Projekt entladen.

  2. Klicken Sie erneut mit der rechten Maustaste auf das Projekt, und klicken Sie dann auf AppName.csprojbearbeiten oder AppName.vbprojbearbeiten.

  3. Fügen Sie in der Projektdatei die folgende XML-Zeile zwischen dem Start- und Endtag des ersten <PropertyGroup>-Elements ein.

    <AppxPriConfigXmlDefaultSnippetPath>FilePath</AppxPriConfigXmlDefaultSnippetPath>
    

    Wichtig

    Ersetzen Sie FilePath durch den Pfad zu Ihrer Konfigurationsdatei, einschließlich des Namens der Datei.

  4. Speichern und schließen Sie die Projektdatei.

  5. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, klicken Sie auf Projekt erneut laden, und erstellen Sie dann die Projektmappe.

Option 2: Ändern der Projektdatei (fortgeschritten)

  1. Öffnen Sie die Projektdatei der App im Editor.

  2. Fügen Sie in der Projektdatei die folgende XML-Zeile zwischen dem Start- und Endtag des ersten <PropertyGroup>-Elements hinzu. Durch dieses XML werden die Ressourcen identifiziert, die das Betriebssystem des Geräts installiert, wenn die App über keine geeigneten Ressourcen für ein bestimmtes Gerät, Gebietsschema oder andere Einstellungen verfügt.

    <AppxDefaultResourceQualifiers>Language=ValueContrast=Value|Scale=Value|HomeRegion=Value|TargetSize=Value|
         LayoutDirection=Value|DXFeatureLevel=Value|Configuration=Value|AlternateForm=Value</AppxDefaultResourceQualifiers>
    

    Im nächsten Schritt ersetzen Sie die Value-Platzhalter durch gültige Ressourcenqualifizierer. Legen Sie beispielsweise den Language-Qualifizierer auf den Moniker {DefaultResourceLanguage} fest. Wenn Sie das App-Paket erstellen, ersetzt Visual Studio diesen Moniker durch den Wert der Eigenschaft Standardsprache, die Sie auf der Registerkarte Anwendung des Manifest-Designers festlegen können. Alternativ können Sie auch den Sprachqualifizierer auf einen bestimmten Gebietsschemawert festlegen, wie z. B. en-us. Weitere Informationen erhalten Sie unter Benennen von Ressourcen mit Qualifizierern (Apps mit C#/VB/C++ und XAML) oder Benennen von Ressourcen mithilfe von Qualifizierern (Apps mit JavaScript und HTML).

  3. Ersetzen Sie jeden Value-Platzhalter durch einen gültigen Ressourcenqualifizierer.

    Das folgende Beispiel zeigt, wie das XML dargestellt wird, nachdem Sie die Value-Platzhalter durch gültige Ressourcenqualifizierer ersetzt haben.

    <AppxDefaultResourceQualifiers>Language={DefaultResourceLanguage}|Contrast=high|Scale=140|HomeRegion=419|TargetSize=256|
         LayoutDirection=LTR|DXFeatureLevel=DX10|Configuration=|AlternateForm=altform-msft-phonetic</AppxDefaultResourceQualifiers>
    
  4. Speichern und schließen Sie die Projektdatei. Laden Sie anschließend die Projektdatei in Visual Studio erneut.

  5. Erstellen Sie die Projektmappe.

  6. Öffnen Sie die Datei "priconfig.xml" im Ordner Projektordner**\obj\**ReleaseConfiguration im Editor.

  7. Vergewissern Sie sich, dass die Qualifizierer, die Sie hinzugefügt haben, in der Datei angezeigt werden.

Siehe auch

Definieren von App-Ressourcen (Apps mit C#/VB/C++ und XAML)
Definieren von App-Ressourcen (Apps mit JavaScript und HTML)
Windows 8.1 Store-Apps: Sicherstellen, dass Ressourcen auf einem Gerät installiert sind, unabhängig davon, ob das Gerät sie benötigt.
App-Bundles
Entscheidungshilfe für das Generieren eines App-Bündels
Ressourcenpakete
Ressourcenverwaltungssystem