Freigeben über

Eigenschaftenlistendatei

  • Artikel

Eine Eigenschaftslistendatei ist eine XML-Datei, die mit Unicode UTF-8 kodiert ist und Konfigurationsinformationen für Ihre .NET Multiplatform App UI (.NET MAUI) App auf iOS und Mac Catalyst enthält. Der Stammknoten der Datei ist ein Wörterbuch, das eine Reihe von Schlüsseln und Werten enthält, die Ihre App-Konfiguration definieren. Der Name der Eigenschaftslistendatei mit Informationen ist Info.plist. Es wird zwischen Groß- und Kleinschreibung unterschieden. Alle .NET MAUI iOS- und Mac Catalyst-Apps müssen eine Info.plist-Datei enthalten, die die App beschreibt.

.NET MAUI erstellt Info.plist-Dateien für iOS und Mac Catalyst, wenn Sie eine .NET MAUI-App aus einer Projektvorlage erstellen. Die Dateien befinden sich in den Ordnern Platforms/iOS und Platforms/Mac Catalyst und werden mit einer ersten Liste von Schlüsseln aufgefüllt.

Wenn Sie Ihre App erstellen, kopiert .NET MAUI Ihre Info.plist-Datei in das kompilierte Bündel, bevor das Bündel mit Code signiert wird. Während des Kopiervorgangs führt .NET MAUI mithilfe von Buildeigenschaften einige Variablenersetzungen durch. Es kann auch zusätzliche Schlüssel einfügen, die die Konfiguration repräsentieren, die auf andere Weise angegeben wurde. Aus diesem Grund ist die in Ihrem App-Bündel enthaltene Datei mit der Liste der Informationseigenschaften nicht identisch mit der Quelldatei in Ihrem Projekt.

Bearbeiten der Informationseigenschaftsliste im Editor

Die Info.plist-Datei wird durch Doppelklicken im Info.plist-Editor von Visual Studio geöffnet.

Der Info.plist-Editor von Visual Studio enthält zwei Ansichten der Daten:

  • Anwendung, in der Sie allgemeine App-Eigenschaften festlegen können:

    Screenshot of application tab in Visual Studio Info.plist editor.

    Hinweis

    Die Werte für die Felder Anwendungsname, Bündelbezeichner, Version" und Build werden aus der Projektdatei Ihrer App abgerufen. Weitere Informationen finden Sie unter Bereitstellen von App-Informationen.

  • Erweitert, in der Sie unterstützte Dokumenttypen, universelle Typenbezeichner (UTIs) und URL-Typen angeben können:

    Screenshot of advanced tab in Visual Studio Info.plist editor.

Bearbeiten der Quelle der Eigenschaftenlistendatei mit Informationen

Die Datei Info.plist kann auch in einem externen Editor geöffnet werden, um die XML-Quelle zu bearbeiten. Schlüssel und Werte zum Konfigurieren der App können für die folgenden Kategorien hinzugefügt werden:

  • Bündelkonfiguration, um die grundlegenden Merkmale eines Bündels wie Name, Typ und Version zu konfigurieren. Weitere Informationen finden Sie unter Bundle configuration auf developer.apple.com.
  • Benutzeroberfläche zum Konfigurieren der Szenen, Symbole und Schriftarten einer App. Weitere Informationen finden Sie unter User interface auf developer.apple.com.
  • App-Ausführung, um Start, Ausführung und Beendigung der App zu konfigurieren. Weitere Informationen finden Sie unter App execution auf developer.apple.com.
  • Geschützte Ressourcen, um den Zugriff einer App auf geschützte Dienste und Benutzerdaten zu steuern. Weitere Informationen finden Sie unter Protected resources auf developer.apple.com.
  • Daten und Speicher, um die Datenverwaltungsfunktionen Ihrer App zu konfigurieren. Weitere Informationen finden Sie unter Data and storage auf developer.apple.com.
  • App-Dienste, um die von Ihrer App bereitgestellten Dienste zu konfigurieren. Weitere Informationen finden Sie unter App services auf developer.apple.com.
  • Kernel und Treiber, um Gerätetreiber zu konfigurieren, die von Ihrer App bereitgestellt werden. Weitere Informationen finden Sie unter Kernel and drivers auf developer.apple.com.

Bereitstellen von App-Informationen

Der Info.plist-Editor ruft grundlegende App-Daten aus der Projektdatei der App ab. Die Daten werden nicht direkt in der Info.plist-Datei gespeichert. Zur Erstellungszeit kopiert .NET MAUI diese Daten in die Datei Info.plist, die im App-Bündel enthalten ist.

Anwendungsname

Der Anwendungsname für eine .NET MAUI-App wird in der Projektdatei der App als die ApplicationTitle-Buildeigenschaft gespeichert:

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihr .NET MAUI-App-Projekt, und wählen Sie Eigenschaften aus. Navigieren Sie dann zur Registerkarte MAUI freigegeben > Allgemein. Im Feld Anwendungstitel" ist der Name der Anwendung aufgeführt.

Wenn der Wert des Felds Anwendungstitel aktualisiert wird, wird das Feld Anwendungsname in der Anwendungsansicht der Datei Info.plistautomatisch auch aktualisiert.

Anwendungs-ID

Der Bündelbezeichner für eine .NET MAUI-App wird in der Projektdatei der App als die ApplicationId-Buildeigenschaft gespeichert:

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihr .NET MAUI-App-Projekt, und wählen Sie Eigenschaften aus. Navigieren Sie dann zur Registerkarte MAUI freigegeben > Allgemein. Im Feld Anwendungs-ID ist der Bezeichner des Bündels aufgeführt.

Wenn der Wert des Felds Anwendungs-ID aktualisiert wird, wird das Feld Bündelbezeichner in der Anwendungsansicht der Datei Info.plist automatisch auch aktualisiert.

Version der Anwendungsanzeige

Die Version der Anwendungsanzeige für eine .NET MAUI-App wird in der Projektdatei der App als ApplicationDisplayVersion-Buildeigenschaft gespeichert:

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihr .NET MAUI-App-Projekt, und wählen Sie Eigenschaften aus. Navigieren Sie dann zur Registerkarte MAUI freigegeben > Allgemein. Im Feld Version der Anwendungsanzeige" ist die Version der Anwendungsanzeige aufgeführt.

Wenn der Wert des Felds Version der Anwendungsanzeige aktualisiert wird, wird der Wert des Felds Version in der Anwendungsansicht der Datei Info.plistautomatisch auch aktualisiert.

Anwendungsversion

Die Version der Anwendungsanzeige für eine .NET MAUI-App wird in der Projektdatei der App als ApplicationVersion-Buildeigenschaft gespeichert:

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihr .NET MAUI-App-Projekt, und wählen Sie Eigenschaften aus. Navigieren Sie dann zur Registerkarte MAUI freigegeben > Allgemein. Im Feld Anwendungsversion" ist die Anwendungsversion aufgeführt.

Wenn der Wert des Felds Anwendungsversion aktualisiert wird, wird der Wert des Felds Build in der Anwendungsansicht der Datei Info.plistautomatisch auch aktualisiert.

Siehe auch