Anpassen der Datei info.plist

Nach oben zu Vorbereiten einer macOS-Anwendung für die Bereitstellung

Nach oben zu Vorbereiten von iOS-Anwendungen für die Bereitstellung

RAD Studio schreibt bestimmte Optionen Ihrer Anwendungen für macOS oder iOS in eine Datei, *.info.plist (EN), die bei der Bereitstellung der Anwendung für macOS oder iOS in Ihr endgültiges Anwendungspaket aufgenommen wird. In dieser Datei werden z. B. der Versionscode oder der Anzeigename Ihrer Anwendung, die Liste der Funktionen, die Ihre Anwendung benötigt, usw. festgelegt.

In der Regel müssen Sie sich nicht um diese Datei kümmern. RAD Studio übernimmt dies für Sie. In RAD Studio können Sie jedoch den Inhalt der Datei *.info.plist anpassen, wenn Sie benutzerdefinierte Daten in diese Datei einbeziehen müssen, die sich nicht visuell in den Projektoptionen festlegen lassen.

Bei der ersten Bereitstellung einer Anwendung für die Zielplattform macOS oder iOS fügt RAD Studio eine Datei in Ihren Projektordner ein: info.plist.TemplateOSX.xml bzw. info.plist.TemplateiOS.xml. Jedes Mal, wenn Sie eine Anwendung für macOS oder iOS bereitstellen, liest RAD Studio die entsprechende Datei, ersetzt bestimmte Platzhalter in der Datei durch tatsächliche Werte aus den Projektoptionen und schreibt den resultierenden Inhalt in eine Ausgabedatei: <Plattform>\<Build-Konfiguration>\*.info.plist. Diese Ausgabedatei ist die *.info.plist-Datei, die in das Anwendungspaket aufgenommen wird, das RAD Studio beim Bereitstellen Ihrer Anwendung für die Zielplattform macOS bzw. iOS erzeugt.

Um die *.info.plist-Ausgabedatei eines einzelnen Projekts anzupassen, bearbeiten Sie den Inhalt der info.plist.TemplateOSX.xml oder info.plist.TemplateiOS.xml im Projektordner.

Die Vorlagendatei, die RAD Studio dem Projekt bei der ersten Bereitstellung für die Zielplattformen macOS bzw. iOS hinzufügt, stammt aus der entsprechenden Datei in C:\Users\<Benutzername>\AppData\Roaming\Embarcadero\BDS\22.0. Bearbeiten Sie diese Datei, wenn Ihre neuen Projekte eine andere Vorlagendatei als Ausgangsdatei verwenden sollen.

Neu Erstellen der info.plist-Vorlagendateien

Die von RAD Studio erzeugte Vorlagendatei info.plist kann je nach Version von RAD Studio unterschiedlich sein. Um ein Projekt bereitzustellen, das ursprünglich mit einer anderen Version von RAD Studio bereitgestellt wurde, müssen Sie besonders sorgfältig mit den vorhandenen info.plist-Vorlagendateien in Ihrem Projektordner umgehen.

Es gibt zwei mögliche Szenarien:

• Sie möchten die alten info.plist-Vorlagendateien beibehalten, weil sie bereits angepasst sind.
• Sie benötigen die alten info.plist-Vorlagendateien nicht mehr.

Beibehalten der info.plist-Vorlagendateien

Sie möchten die info.plist-Vorlagendateien beibehalten, weil Sie manuelle Änderungen vorgenommen haben. In diesem Fall müssen Sie die folgenden Schritte ausführen:

1. Öffnen Sie Ihren Projektordner.
2. Erstellen Sie eine Sicherung Ihrer info.plist-Vorlagendateien.
3. Löschen Sie die info.plist-Vorlagendateien aus Ihrem Projektordner.
4. Öffnen Sie das Projekt in der neuen Version von RAD Studio.
5. Führen Sie für jede betroffene Zielplattform (macOS, iOS-Gerät - 32 Bit, iOS-Gerät - 64 Bit und iOS-Simulator) Folgendes aus:
   1. Wählen Sie in der Projektverwaltung den Zielplattformknoten aus.
   2. Stellen Sie Ihr Projekt für die ausgewählte Zielplattform bereit.

      Hinweis: Durch die Bereitstellung des Projekts wird eine neue info.plist-Vorlagendatei für die ausgewählte Zielplattform erstellt.

   3. Überprüfen Sie, ob in Ihrem Projektordner eine neue info.plist-Vorlagendatei erstellt wurde.
   4. Fügen Sie der neuen info.plist-Vorlagendatei Ihre Änderungen manuell hinzu.

Erstellen neuer info.plist-Vorlagendateien

Wenn Sie Ihre info.plist-Vorlagendateien nicht geändert haben, führen Sie diese Schritte aus, damit RAD Studio neue Dateien erstellt:

1. Öffnen Sie Ihren Projektordner.
2. Löschen Sie die info.plist-Vorlagendateien, sofern vorhanden.
3. Öffnen Sie das Projekt in der neuen Version von RAD Studio.
4. Führen Sie für jede betroffene Zielplattform (macOS, iOS-Gerät - 32 Bit, iOS-Gerät - 64 Bit und iOS-Simulator) Folgendes aus:
   1. Wählen Sie in der Projektverwaltung den Zielplattformknoten aus.
   2. Stellen Sie Ihr Projekt für die ausgewählte Zielplattform bereit.

      Hinweis: Durch die Bereitstellung des Projekts wird eine neue info.plist-Vorlagendatei für die ausgewählte Zielplattform erstellt.

   3. Überprüfen Sie, ob in Ihrem Projektordner eine neue info.plist-Vorlagendatei erstellt wurde.

Inhalt der info.plist-Vorlagendateien

Die info.plist-Vorlagendateien enthalten zwei Platzhalter, die von RAD Studio beim Bereitstellen von Anwendungen durch Schlüssel/Wertepaare ersetzt werden. Die folgenden Werte geben an, welche Platzhalter durch info.plist-Schlüsselwörter ersetzt werden:

Platzhalter	Ersatzinhalt
<%VersionInfoPListKeys%>	Schlüsselwörter auf der Seite Versionsinformationen.
<%ExtraInfoPListKeys%>	Schlüsselwörter zu grafischen Gestaltungsmitteln auf Basis der Informationen auf der Seite Anwendung. Für iOS: Schlüsselwörter zur Ausrichtungsunterstützung auf Basis der Informationen auf der Seite Ausrichtung. Schlüsselwörter zum Deaktivieren der APS-Funktion, wenn die Funktion "HTTP-Protokollanforderungen aktivieren" auf der Seite Berechtigungsliste deaktiviert ist. CFBundleShortVersionString auf Basis des Wertes der zugehörigen Felder auf der Seite Versionsinformationen. UIRequiredDeviceCapabilities ist "arm64" für iOS-Gerät - 64 Bit bzw. "armv7" für andere Plattformen. Für iOS-Geräteplattformen: CFBundleSupportedPlatforms ist "iPhoneOS". CFBundleResourceSpecification ist "ResourceRules.plist" (RAD Studio erzeugt diese Datei). MinimumOSVersion ist der Wert, der für die Option "Niedrigste unterstützte iOS-Version" auf der folgenden Optionsseite konfiguriert wurde: Delphi: Projekt > Optionen > Delphi-Compiler > Linken C++: Projekt > Optionen > C++-Linker Für die Plattformkonfiguration Anwendungs-Store: DTPlatformName ist "iphoneos". Die Werte für DTPlatformBuild und DTXcodeBuild hängen vom SDK ab, mit dem Sie Ihre Anwendung erzeugen.

Siehe auch

• Anpassen von Berechtigungslisten für iOS oder macOS

• Anpassen der Datei "AndroidManifest.xml"