Apfeltech. » Apple, iOS, iPhone, iPad & iPod Touch News-Blog

WinterBoard Workshop – Teil 4: Info.plist

Herzlich willkommen zum vierten Teil unseres WinterBoard-Workshops. Heute geht es um Info.plist. Info.plist ist anders als die meisten Teile eines Themes – Es “überschreibt” nicht, es “zählt zusammen”. Was ist eigentlich eine plist? Eine plist – genau genommen eine Property List – wird auf dem Mac verwendet um die Einstellungen sowie ein paar andere Dinge, wie  zum Beispiel den Bundle Identifier (de.ich.meinprogramm), eines Programmes zu speichern. Auf Windows übernimmt das die Registry.

Man erstellt sie ganz einfach als ein Textdokument und ändert die Dateiendung auf .plist, bevor man sie auf den iPod schubst. WinterBoard kommt mit mehreren  Info.plist’s klar, man muss nicht jedesmal die gleiche ändern. Wie sieht die Info.plist dann aus? Saurik hat bei WinterBoard schon ein paar Beispiele für die Benutzung von Info.plist geliefert – Diese werden (grösstenteils) hier erläutert. Die plist sieht also so aus:

<?xml version=”1.0″ encoding=”UTF-8″?>

<!DOCTYPE plist PUBLIC “-//Apple Computer//DTD PLIST 1.0//EN” “http://www.apple.com/DTDs/PropertyList-1.0.dtd”>

<plist version=”1.0″>

<dict>

<key>Irgend ein Key</key>

<string>die Beschreibung des Key’s</string>

</dict>

</plist>

Und dort kann man dann die entsprechenden Key’s reinpacken und gleich beschreiben. Damit kann man zum Beispiel die Icon-Labels oder die StatusBar-Uhr ändern. Es gibt einige Keys, mit neuen WinterBoard-Versionen kommen meistens auch neue dazu. Es gibt schon einige, hier werden nur 10 davon erläutert.

Verfügbare Keys:

• BadgeStyle

Ändert die Schrift der Badge-Aufschrift, also zB bei 8 ungelesenen Mails die kleine 8 auf dem Mail-Icon. (Nicht alles geht)

• CalendarIconDayStyle

Ändert die Schrift des Wochentags auf dem Kalender-Icon, zB “Mittwoch”.

• CalendarIconDateStyle

Ändert die Schrift des Datums auf dem Kalender-Icon, zB “7″.

• UndockedIconLabelStyle

Ändert die Schrift der Labels der Icons ausserhalb des Docks. (Safari, Kalender, Mail, …)

• DockedIconLabelStyle

Ändert die Schrift der Icons im Dock. (Musik, Videos, Fotos, …)

• StatusBarMode

Setzt eine der drei StatusBar’s fest, die dann immer benutzt wird (Default, FSO, FST).

• StatusBarContentsMode

Setzt eines der beiden StatusBar-Icon-Sets fest (FSO, Default).

• TimeStyle

Ändert die Uhr in der Statusbar.

• IconAlpha

Ändert die Transparenz der Icons auf dem SpringBoard.

• FontName-Bla

Zwingt das SpringBoard, andere Schriften zu verwenden

Bei allen Keys ausser “StatusBarContentsMode”, “StatusBarMode”, “FontName-Bla” und “IconAlpha” kann man CSS verwenden. Bei “IconAlpha” verwendet man Zahlen zwischen .1 und .9, um die Transparenz der Icons festzulegen. Es wird nur eine Nachkommastelle verwertet, also kann man nicht .15 oder .68 verwenden.  Normal ist ein Icon auf “1.0″ gesetzt, .9 ist der “untransparenteste” mögliche Wert. Bei StatusBarMode kann man für den Key “0″, “1″, “2″ oder “3″ eintragen. “0″ setzt die Statusbar auf die Default-Statusbar (Default_BG.png).

“1″ setzt sie auf FST (FST_BG.png) und bei “2″ oder “3″ wird immer die FSO-StatusBar verwendet (FSO_BG.png). Diese Statusbars werden dann immer verwendet, egal, was in der Info.plist einer App steht. Die StatusBars gehen nach MeinTheme.theme/Bundles/com.apple.springboard/ und heissen wie angegeben.

StatusBarContentsMode ist ähnlich, es setzt die kleinen Icons in der StatusBar fest. Man kann “0″, “2″ oder “3″ verwenden. Für “0″ wird das Default-Icon-Set benutzt, das ist das, welches zB in Mail verwendet wird. “2″ und “3″ bringen das FSO-Set, das ist das vom Homescreen. Auch die Sets werden dann immer verwendet.

“FontName-Bla” ist auch sehr interessant – Man kann Schriften tauschen. Das “Bla” muss man durch die zu tauschende Schrift ersetzen, in den Key kommt dann die neue Schrift. Mehr dazu nach dem Beispiel.

Hier ein Beispiel dieser Keys in einer Info.plist:

<?xml version=”1.0″ encoding=”UTF-8″?>
<!DOCTYPE plist PUBLIC “-//Apple Computer//DTD PLIST 1.0//EN” “http://www.apple.com/DTDs/PropertyList-1.0.dtd”>
<plist version=”1.0″>
<dict>
<key>BadgeStyle</key>
<string>color: transparent</string>
<key>TimeStyle</key>
<string>margin-left: 10px</string>
<key>CalendarIconDayStyle</key>
<string>font-family: monospace</string>
<key>CalendarIconDateStyle</key>
<string>font-size: 13px</string>
<key>UndockedIconLabelStyle</key>
<string>color: red</string>
<key>DockedIconLabelStyle</key>
<string>color: blue</string>
<key>StatusBarMode</key>
<string>1</string>
<key>StatusBarContentsMode</key>
<string>0</string>
<key>IconAlpha</key>
<string>.5</string>
<key>FontName-Helvetica</key>
<string>Courier New</string>
</dict>
</plist>

Was passiert jetzt alles mit dem iPod? – Die Zahlen auf den Badges werden unsichtbar, die Uhr wird 10 Pixel nach rechts verschoben, der Tag auf dem Kalender wird monospace angezeigt, das heisst, dass die Buchstaben alle die gleiche Breite haben. Das Datum wird mit winzigen 13 Pixeln angezeigt, die Icon-Labels ausserhalb des Docks sind rot, im Dock sind sie blau.
Die StatusBar ist immer die FST_BG.png, die Icons in ihr sind immer die Default-Icons und alle Icons sind halb-transparent. Im letzten Key steht “FontName-Helvetica” und im passenden string steht “Courier New”. Das bedeutet, dass überall, wo die Schriftart Helvetica verwendet würde, wird nun Courier New verwendet.

Das wars für diese Woche, Entschuldigung wegen der Verspätung, dafür gibts nächstes Mal die UIImages, die UISounds und die Sprachdateien!