Anwendungsoptionen

Nach oben zu Projektoptionen (Dialogfeld)

Projekt > Optionen > Anwendung

Auf der Seite Anwendung legen Sie die Optionen für die aktuelle Anwendung fest.

Optionen	Beschreibung
Ziel, Übernehmen, Speichern	Siehe Optionen für das Ziel.
Gemeinsame Elemente	Siehe Gemeinsame Elemente auf den Projektoptionsseiten.

Ausgabeeinstellungen

Option	Beschreibung
Erweiterung der Zieldatei	Gibt die Erweiterung der endgültigen Zieldatei an.

Die Anwendungsoptionen variieren je nach ausgewählter Zielplattform:

• Desktop-Plattformen (VCL oder FireMonkey)
• iOS (nur FireMonkey)
• Android (nur FireMonkey)

Anwendungsoptionen für Desktop-Plattformen

Für geräteübergreifende Anwendungen können Sie auf der Seite Anwendung die folgenden Optionen konfigurieren.

Einstellungen für Programmsymbol

Option	Beschreibung
Symbol (für Windows-Anwendungen)	Legt die Symboldatei (.ico) für die Ausgabedatei fest. Das in diesem Dialogfeld angezeigte Programmsymbol wird im Windows-Explorer neben dem Namen der Ausgabedatei angezeigt. Klicken Sie auf Symbol laden..., um das Dialogfeld Programmsymbol anzuzeigen und nach einer .ico-Datei zu suchen. Klicken Sie auf Vorgabe, um das ursprüngliche für Ihre Anwendung bereitgestellte Standardsymbol wiederherzustellen. RAD Studio enthält Personality-spezifische .ico-Dateien, die im Verzeichnis /bin Ihrer Produktinstallation verfügbar sind. Jede .ico-Datei enthält eine Gruppe von Symbolen in unterschiedlichen Größen. Auf Windows-Plattformen wird automatisch die für die jeweilige Situation passende Größe ausgewählt. delphi_PROJECTICON.ico object_pascal_PROJECTICON.ico cbuilder_PROJECTICON.ico Für Konsolenanwendungen sind die Einstellungen für das Programmsymbol deaktiviert. Windows verwendet ein Standardsymbol für Konsolenanwendungen. Im folgenden Tutorial wird das Ändern des Symbols für Konsolenanwendungen beschrieben: Delphi @ About.com: Change the Default Application Icon for a Console Mode Delphi Application (EN).
Icns-Symbol (für FireMonkey-macOS-Anwendungen)	Legt eine Icns-Symboldatei (.icns) fest, die in die Ausgabedatei eingefügt wird. Das Symbol, das in diesem Dialogfeld angezeigt wird, repräsentiert Ihre Anwendung unter macOS. Klicken Sie auf Icns laden..., um das Dialogfeld Programm-Icns anzuzeigen und nach einer .icns-Datei zu suchen. Klicken Sie auf Vorgabe, um das ursprüngliche für Ihre RAD Studio-Anwendung bereitgestellte Standardsymbol wiederherzustellen. RAD Studio enthält Personality-spezifische .icns-Dateien, die im Verzeichnis /bin Ihrer Produktinstallation verfügbar sind. Die Dateinamen lauten: object_pascalPROJECTICNS.icns delphi_PROJECTICNS.icns cbuilder_PROJECTICNS.icns Jede .icns-Datei enthält einen Satz von Symbolen in unterschiedlichen Größen. macOS wählt die geeignete Größe für jede Situation automatisch aus. Informationen zum Erstellen eines gültigen Icns-Symbols für Ihre Anwendung finden Sie unter: How can I set the icon for a Mac Application in Xcode? (EN) Optimizing for High Resolution (EN) Führen Sie die folgenden Schritte aus, um die icns-Symboldatei, die für macOS bereitgestellt werden soll, zu aktualisieren: Gehen Sie zu Projekt > Bereitstellung, um den Bereitstellungs-Manager zu öffnen. Wählen Sie die Build-Konfiguration für das macOS-Projekt im Kombinationsfeld Konfigurationsauswahl aus. Klicken Sie auf Revert to Default, um das neue icns-Symbol dem Bereitstellungs-Manager hinzuzufügen. Revert to Default entfernt alle Einträge, die nicht mehr benötigt werden, wie vorige icns-Symbol-Dateien.

Manifestdatei (Nur Windows)

Option	Beschreibung
Automatisch erzeugen	Legt fest, ob die Manifestdatei automatisch erzeugt wird. Sie können eine der folgenden Optionen auswählen: Keine: Die Manifestdatei wird nicht erzeugt. Automatisch erzeugen: Die Manifestdatei wird entsprechend den folgenden Einstellungen erzeugt. Benutzerdefiniert: Verwenden Sie diese Option, wenn Sie ein benutzerdefiniertes Manifest bereitstellen möchten. Geben Sie im Feld Benutzerdefiniertes Manifest die .manifest-Datei an.
Laufzeit-Themes aktivieren	Legt fest, ob die Anwendung, die Sie entwickeln, Laufzeit-Themes verwenden soll. Hinweis: Diese Option ist standardmäßig aktiviert.
DPI-Unterstützung	Sie können die folgenden Optionen auswählen: Ohne: DPI wird nicht erkannt. Unbekannt: Wählen Sie diese Option aus, wenn Anwendungen unter der Annahme einer 100%igen Skalierung (96 DPI) gerendert werden. Systembekannt: Verwenden Sie diese Option, wenn Sie die DPI des Hauptbildschirms zum Zeitpunkt der Anmeldung bei Ihrem Computer kennen. Über Monitor: Wählen Sie diese Option aus, wenn Apps Inhalte mit unterschiedlichen DPI-Werten rendern und die DPI-Skalierung ändern können, wenn die Anwendungen zwischen Monitoren mit unterschiedlichen DPI-Werten verschoben werden. Über Monitor v2: Verwenden Sie diese Option, um benachrichtigt zu werden, wenn die Anwendungs-DPI sich ändern. GDI-Skalierung: Wählen Sie diese Option aus, um Grafiken und Text unabhängig vom Display in der richtigen Größe zu rendern.
Ausführungsebene	Legt die Ausführungsebene für Ihre Anwendung fest. Als Aufrufer: Wählen Sie diese Option, um Ihre Anwendung mit demselben Zugriffs-Token, das auch der übergeordnete Prozess verwendet, auszuführen. Verwenden Sie diese Option für Standardbenutzeranwendungen. Gestalten Sie die App mit internen Rechteerweiterungspunkten um. Maximal verfügbar: Wählen Sie diese Option, um Ihre Anwendung mit den höchsten Rechten, die ein Benutzer erhalten kann, auszuführen. Verwenden Sie diese Option für Anwendungen im gemischten Modus. Gestalten Sie die Anwendung in einem zukünftigen Release um. Administrator erforderlich: Wählen Sie diese Option für Ihre Anwendung, um Administratorrechte anzufordern. Die Anwendung wird nur für Administratoren ausgeführt, und es ist erforderlich, dass die Anwendung mit dem vollständigen Zugriffs-Token eines Administrators aufgerufen wird. Verwenden Sie diese Option nur für Administratoranwendungen. Interne Rechteerweiterungspunkte sind nicht erforderlich, die Anwendung wird bereits mit erweiterten Rechten ausgeführt. Weitere Informationen darüber, welche Option am besten für Ihre Anwendung geeignet ist, finden Sie unter Requested Execution Levels (EN) im Windows Dev Center. Wählen Sie UI-Zugriff, wenn Ihre Anwendung die Schutzebenen der Benutzeroberfläche umgehen und Eingaben in Fenster mit einer höheren Berechtigung auf dem Desktop leiten soll.
Benutzerdefiniertes Manifest	Wenn Sie Benutzerdefiniert auswählen, wird das Feld Benutzerdefiniertes Manifest aktiviert. Klicken Sie auf die Ellipsen-Schaltfläche [...], um nach der .manifest-Datei zu suchen. Weitere Informationen und Beispiele von benutzerdefinierten Windows-Anwendungsmanifestdateien finden Sie unter Anpassen der Windows-Anwendungsmanifestdatei.

Anwendungsoptionen für iOS

Für iOS-Anwendungen enthält die Seite Anwendung zwei Registerkarten:

• iPhone
• iPad

Symbole für iOS-Apps

Für die iPhone- und iPad-Plattformen stellt RAD Studio Symboldateien für FireMonkey-iOS-Anwendungen in Form von .png-Dateien in unterschiedlichen Größen bereit. Diese Dateien befinden sich im Verzeichnis /bin/Artwork/iOS Ihrer Produktinstallation.

Die folgenden Namen sind Beispiele für die von RAD Studio bereitgestellten Symboldateien:

• FM_ApplicationIcon_120x120.png
• FM_SpotlightSearchIcon_120x120.png
• FM_SettingIcon_58x58.png
• FM_NotificationIcon_40x40.png
• FM_LaunchImage_2x.png

Klicken Sie auf der plattformspezifischen Registerkarte ("iPhone" oder "iPad") im entsprechenden Feld auf die Ellipsen-Schaltfläche (), um die Bilder und Symbole, die mit Ihrer iOS-Anwendung bereitgestellt werden, zu konfigurieren.

Registerkarte "iPhone"

Feld	Beschreibung
Programmsymbol (120x120)	Symbol, das Ihre Anwendung repräsentiert. Dieses Symbol können Benutzer auf ihrem Startbildschirm platzieren und darauf tippen, um Ihre Anwendung zu starten.
Programmsymbol (180x180)
Programmsymbol (1024x1024)	Symbol, das Ihre Anwendung im App Store repräsentiert.
Spotlight-Symbol (80x80)	Symbol, das Ihre Anwendung bei einer Spotlight-Suche repräsentiert.
Spotlight-Symbol (120x120)
Einstellungssymbol (58x58)	Symbol, das Ihre Anwendung in der integrierten Anwendung "Einstellungen" repräsentiert.
Einstellungssymbol (87x87)
Benachrichtigungssymbol (40x40)	Das Benachrichtigungssymbol wird für die Benachrichtigungen Ihrer Anwendung angezeigt.
Benachrichtigungssymbol (60x60)
Startbild beliebige Darstellung 2-fache Größe	Das Startbild wird anstelle Ihrer Anwendung angezeigt, bis das Laden der Anwendung beendet ist und die Anwendung den Platz des Bildes einnimmt.
Startbild dunkle Darstellung 2-fache Größe
Startbild beliebige Darstellung 3-fache Größe
Startbild dunkle Darstellung 3-fache Größe

Registerkarte "iPad"

Feld	Beschreibung
Programmsymbol (152x152)	Symbol, das Ihre Anwendung repräsentiert. Dieses Symbol können Benutzer auf ihrem Startbildschirm platzieren und darauf tippen, um Ihre Anwendung zu starten.
Programmsymbol (167x167)
Spotlight-Symbol (80x80)	Symbol, das Ihre Anwendung bei einer Spotlight-Suche repräsentiert.
Einstellungssymbol (58x58)	Symbol, das Ihre Anwendung in der integrierten Anwendung "Einstellungen" repräsentiert.
Benachrichtigungssymbol (40x40)	Das Benachrichtigungssymbol wird für die Benachrichtigungen Ihrer Anwendung angezeigt.
Startbild beliebige Darstellung 2-fache Größe	Das Startbild wird anstelle Ihrer Anwendung angezeigt, bis das Laden der Anwendung beendet ist und die Anwendung den Platz des Bildes einnimmt.
Startbild dunkle Darstellung 2-fache Größe

Vorschau

Option	Beschreibung
Vorschau	Bei iOS-Zielplattformen erscheint dieses Feld rechts auf der Seite Anwendung und zeigt eine Vorschau des ausgewählten Bildes an.
Tatsächliche Größe	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau des Symbols in der tatsächlichen Größe anzuzeigen. Standardmäßig wird die Größe der Vorschau so angepasst, dass nicht mehr als der in der rechten Spalte verfügbare Platz ausgefüllt wird. Je nach Größe des Bildes müssen Sie eventuell einen Bildlauf durchführen, um das gesamte Bild anzuzeigen.

Hinweise für iOS

• Sie können die Bilder und Symbole immer auf den Registerkarten iPhone und iPad konfigurieren, unabhängig vom aktuell ausgewählten iOS-Zielgerät.

• Bilddateien müssen .png-Dateien sein, und die Dateien müssen die erforderliche Größe haben, ansonsten erhalten Sie eine Fehlermeldung.

• Nicht alle Bilder sind erforderlich; Einzelheiten dazu finden Sie in den Custom Icon and Image Creation Guidelines (EN) von Apple.
  • Wenn Sie ein bestimmtes Bild nicht bereitstellen möchten, entfernen Sie den Eintrag aus dem Bildfeld und klicken auf OK.
  • Wenn Sie ein Bildfeld leeren, müssen Sie sicherstellen, dass das auf der Seite Anwendung ausgewählte Ziel auf Alle Konfigurationen eingestellt ist. Leere Felder werden mit den Pfaden aus den übergeordneten Zielen überschrieben, und Alle Konfigurationen ist das einzige Ziel, das nicht überschrieben wird.

• Sie können auch den Ihrer iOS-App zugeordneten Eigenschaftswert UIDeviceFamily definieren. UIDeviceFamily ist ein Wert in der Datei info.plist file, die Ihrer iOS-App zugeordnet ist; UIDeviceFamilylegt die iOS-Geräte fest, auf denen Ihre App unterstützt wird. Die Standard-UIDeviceFamily für iOS-Apps ist iPhone & iPad, aber Sie können Ihre iOS-App auf nur iPad oder iPhone beschränken. Legen Sie auf der Seite Projekt > Optionen > Versionsinformationen in der Liste Schlüssel/Wert einen Wert für UIDeviceFamily fest.

• iOS-Anwendungen können so gestaltet werden, dass sie entweder den Darstellungsmodus Beliebig oder Dunkel oder beide Darstellungsmodi gleichzeitig unterstützen.

Helle Darstellung	Dunkle Darstellung
Die Hintergrundfarbe und das Bild des Startbildschirms für den Darstellungsmodus "Beliebig" werden in einer iOS-Anwendung verwendet, wenn auf dem Zielgerät: Eine beliebige iOS-Version ausgeführt wird Die systemweite Darstellung auf Hell eingestellt ist	Die Hintergrundfarbe des Startbildschirms und das Bild für den Darstellungsmodus Dunkel werden in einer iOS-Anwendung verwendet, wenn auf dem Zielgerät: Die iOS-Version 13.0 oder höher ausgeführt wird Die systemweite Darstellung auf Dunkel eingestellt ist

• Die Optionen Hintergrundfarbe des Startbilds und Dunkle Hintergrundfarbe des Startbilds sind nur auf der Registerkarte iPhone verfügbar, sie können aber für iPhone- und iPad-Geräte angewendet werden.

• Die Unterstützung des Darstellungsmodus Dunkel in einer iOS-Anwendung ist optional. Wenn eine iOS-Anwendung den Darstellungsmodus Dunkel gegenwärtig nicht unterstützen muss, ist es möglich, die Optionen Startbild dunkle Darstellung 2-fache Größe und Startbild dunkle Darstellung 3-fache Größe zu deaktivieren.

Anwendungsoptionen für Android

Für Android-Anwendungen enthält die Seite Anwendung eine Registerkarte:

• Gestaltungsmittel

Gestaltungsmittel für Android-Apps

Für die Android-Plattform stellt RAD Studio Symboldateien und Startbilder in unterschiedlichen Größen für FireMonkey-Android-Anwendungen in Form von .png-Dateien bereit. Diese Dateien befinden sich im Verzeichnis \bin\Artwork\Android Ihrer Produktinstallation.

Klicken Sie auf der Registerkarte Gestaltungsmittel im entsprechenden Feld auf die Ellipsen-Schaltfläche (), um die Symbole und Bilder, die mit Ihrer geräteübergreifenden Anwendung bereitgestellt werden, zu konfigurieren.

Registerkarte "Gestaltungsmittel" für Android

Startprogrammsymbole

Feld	Beschreibung
Startprogrammsymbol (36x36 ldpi)	Symbol, das Ihre Anwendung repräsentiert. (Dieses Symbol können Benutzer auf ihrem Startbildschirm platzieren und darauf tippen, um Ihre Anwendung zu starten.)
Startprogrammsymbol (48x48 mdpi)
Startprogrammsymbol (72x72 hdpi)
Startprogrammsymbol (96x96 xhdpi)
Startprogrammsymbol (144x144 xxhdpi)

Benachrichtigungssymbole

Feld	Beschreibung
Benachrichtigungssymbol (24x24 mdpi)	Benachrichtigungssymbol für Ihre Anwendung. (Dies sind Symbole, die Ihre Benutzer für Benachrichtigungen verwenden können.)
Benachrichtigungssymbol (36x36 hdpi)
Benachrichtigungssymbol (48x48 xhdpi)
Benachrichtigungssymbol (72x72 xxhdpi)
Benachrichtigungssymbol (96x96 xxxhdpi)

Startbilder

Mit dem Kontrollkästchen Startbild einbeziehen können Sie die Startbilder Ihres Projekts aktivieren oder deaktivieren.

Feld	Beschreibung
Startbild (426x320 klein)	Startbilder für Ihre Anwendung. (Dies sind Bilder, die beim Öffnen Ihrer Anwendung angezeigt werden. Sie können entweder ein einzelnes Bild oder mehrere Bilder in verschiedenen Größen angeben. Verwenden Sie entweder ein Bitmap mit Mehrfachauflösung oder mehrere Bilder in verschiedenen Größen, um die Neuskalierung zu minimieren.)
Startbild (470x320 normal)
Startbild (640x480 groß)
Startbild (960x720 sehr groß)

Kachelmodus für Startbild: Wenn der Kachelmodus aktiviert ist, wird das Bild wiederholt angezeigt. In diesem Kombinationsfeld können Sie den Kachelmodus mit den folgenden Optionen festlegen:

Kachelmodus	Beschreibung
disabled	Das Bild wird einmal auf dem Bildschirm angezeigt.
clamp	Die Farbe am Rand des Bildes wird repliziert, um den Bildschirm auszufüllen.
repeat	Das Bild wird horizontal und vertikal wiederholt, um den Bildschirm auszufüllen.
mirror	Das Bild wird horizontal und vertikal mit einem Spiegelungseffekt bei jedem zweiten Bild wiederholt, um den Bildschirm auszufüllen.

In der Dokumentation zum Android Tile Mode (EN) finden Sie weitere Informationen.

Startbildanordnung: Die Startbildanordnung legt die Position des Bildes auf dem Bildschirm fest, falls das Bild kleiner als der Bildschirm ist. Die Startbildanordnung wird nur berücksichtigt, wenn der Kachelmodus für das Startbild deaktiviert ist. In der Dokumentation zur Android Gravity (EN) finden Sie weitere Informationen.

Hinweise zu Bildern für Android

• Sie können die Bilder für Ihre App immer auf der Registerkarte Gestaltungsmittel konfigurieren, unabhängig vom aktuell ausgewählten mobilen Zielgerät.

• Bilddateien müssen *.png*-Dateien sein, und die Dateien müssen die erforderliche Größe haben, ansonsten erhalten Sie eine Fehlermeldung.

• In Android können Sie 9-Patch-Grafiken verwenden, die festlegen, wie das Bild gestreckt wird.
  • Sie können ein Bild mit dem Tool draw9patch, das sich im Verzeichnis C:\Users\Public\Documents\Embarcadero\Studio\22.0\CatalogRepository\AndroidSDK-<Version>\tools\lib befindet, in 9-Patch konvertieren.
  • Mit dem Tool draw9patch können Sie .png- und .9.png-Bilder laden. nach Ausführung des Tools wird Ihr Bild mit der Erweiterung .9.png gespeichert. Draw9patch arbeitet mit einem 1-Pixel-Umfang, daher werden .png-Bilder mit 4 zusätzlichen Pixel (2 horizontal und 2 vertikal) gespeichert, .9.png-Bilder bleiben unverändert.
  • Zeichnen Sie die obere und linke 1 Pixel breite Hilfslinie in Schwarz, um den skalierbaren Bereich des Bildes festzulegen. In der Dokumentation zu Android Draw 9-patch (EN) finden Sie weitere Informationen.

• Alle Bilder sind optional.
  • Wenn Sie ein bestimmtes Bild nicht bereitstellen möchten, entfernen Sie den Eintrag aus dem Bildfeld und klicken auf OK.
  • Wenn Sie ein Bildfeld leeren, müssen Sie sicherstellen, dass das auf der Seite Anwendung ausgewählte Ziel auf Alle Konfigurationen eingestellt ist. Leere Felder werden mit den Pfaden aus den übergeordneten Zielen überschrieben, und Alle Konfigurationen ist das einzige Ziel, das nicht überschrieben wird.

• Beim Ausführen einer Android-Anwendung auf einem Kindle Fire wird auf dem Karussell das MDPI-Startprogrammsymbol (48x48) Ihrer Anwendung angezeigt, selbst wenn Sie ein Symbol mit einer höheren Auflösung bereitgestellt haben. Dieses MDPI-Startprogrammsymbol wird zudem verschwommen dargestellt. Dies tritt aber nur bei der Installation Ihrer Android-Anwendung auf dem Kindle Fire über USB auf. Wenn Benutzer Ihre Anwendung aus dem Amazon-Anwendungs-Store herunterladen, wird das Symbol Ihrer Anwendung, das auf dem Karussell des Kindle Fire angezeigt wird, aus dem Amazon-Anwendungs-Store heruntergeladen. In den Anwendungs-Store können Sie ein kleines Anwendungssymbol (114x114) und ein größeres Anwendungssymbol (512x512) hochladen. In der Amazon-Dokumentation (EN) finden Sie weitere Informationen.

• Um eine Android-Anwendung ohne Startbildschirm bereitzustellen, müssen vor dem Deaktivieren der Option Startbild einbeziehen und dem erneuten Erstellen der Anwendung zuerst manuell die Dateien splash_image_def.xml, styles.xml und styles-v21.xml gelöscht werden, die für ein früheres Build Ihrer Anwendung erstellt wurden (diese Dateien sollten sich im Unterordner "<Active-Target-Platform>\<Active-Build-Configuration>" befinden).

Themen

• Programm-Icns (Dialogfeld)
• Programmsymbol (Dialogfeld)

• Erscheinungsbild (Seite)
• Ausrichtung (Seite)

Siehe auch

• Erstellen und Bereitstellen von App-Symbolen

• Hilfe in Anwendungen aktivieren

• Vorbereiten von iOS-Anwendungen für die Bereitstellung
• Vorbereiten von Android-Anwendungen für die Bereitstellung
• Verwenden von 9-Patch-Grafiken in Android

• Anpassen der Windows-Anwendungsmanifestdatei
• Manifestdatei