Custom Xcode File Template
Zusammenfassung
Kurz
Der Autor beschreibt, wie er mit einer `IDETemplateMacros.plist` den Header neu angelegter Swift-Dateien in Xcode angepasst hat. Er fand die Lösung nur durch Ausprobieren und Hinweise aus Foren; andere Dateitypen hat er nicht getestet.
Mittel
Der Bericht beschreibt den Versuch, den automatisch eingefügten Header neuer Dateien in Xcode zu ändern. Der Autor verweist auf die Standardvorlagen im Xcode-Bundle und auf Makros wie `___FILEBASENAME___`; eine passende Dokumentation in den Xcode-Entwicklerunterlagen habe er nicht gefunden. Die ältere Xcode-Hilfe und ihre Makro-Referenz seien laut ihm dennoch nützlich.
Seine Lösung für Swift-Quelldateien ist eine `IDETemplateMacros.plist` unter `~/Library/Developer/Xcode/UserData/`. Darin legt er Werte für `FILEHEADER` und `ORGANIZATIONNAME` fest. Xcode habe den benutzerdefinierten Header danach beim Erstellen neuer Swift-Dateien verwendet. Beim Format sei zu beachten, dass Xcode den expandierten Header offenbar an einen Kommentar mit `//` anhängt; weitere Zeilen müssen daher selbst mit `//` beginnen, wenn sie Kommentare sein sollen. `FILEHEADER` solle man nicht in seiner eigenen Definition zum Testen anderer Makros verwenden.
Der Autor hat das Verfahren nur für neue Swift-Quelldateien ausprobiert. Wie andere Dateitypen angepasst werden können, bleibt nach seiner Aussage ungeprüft; auch die zusätzlichen Hinweise aus einem verlinkten Forum hat er nicht getestet.
Ausführlich lesen
Der Bericht von Giik Web Developer beschreibt, wie sich der automatisch eingefügte Dateiheader beim Anlegen neuer Dateien in Xcode anpassen lässt. Als Beispiel zeigt der Autor den üblichen Header einer Swift-Datei mit Dateiname, Projektname, Erstellungsdatum und Name der erstellenden Person. Da ihm dieser Inhalt nicht gefiel, suchte er nach einer Möglichkeit, ihn zu ändern oder zu entfernen.
Der Autor führt zunächst zu den Standardvorlagen im Xcode-App-Bundle. Dort liegen für verschiedene Dateitypen eigene Vorlagen; die Swift-Dateivorlage enthält unter anderem eine Vorlagendatei und eine `TemplateInfo.plist`. In den Vorlagen fallen Zeichenfolgen mit drei Unterstrichen auf, etwa `___FILEBASENAME___`. Die ältere Xcode-Hilfe und deren Textmakro-Referenz könnten laut Bericht dabei helfen, diese Platzhalter zu verstehen. Der Autor sagt, er habe dazu keine passende Dokumentation in den Xcode-Entwicklerunterlagen gefunden.
Für einen eigenen Header legt der Autor die Datei `~/Library/Developer/Xcode/UserData/IDETemplateMacros.plist` an und definiert darin unter anderem `FILEHEADER` sowie `ORGANIZATIONNAME`. Nach seiner Erfahrung verwendet Xcode den eingetragenen `FILEHEADER` anschließend beim Erstellen neuer Swift-Quelldateien. Er zeigt ein Beispiel mit Dateiname, Projektname, Datum und Organisation als Makros. Zum Ausprobieren anderer dokumentierter Makros empfiehlt er, diese in der Vorlage einzutragen; `FILEHEADER` selbst solle man dabei auslassen, weil es nicht in seiner eigenen Definition verwendet werden könne.
Der Beitrag hebt eine Formatbesonderheit hervor: Xcode scheine den expandierten Wert von `FILEHEADER` an einen Kommentar mit `//` anzuhängen. Deshalb müsse der Wert mit einer Zeile beginnen, die für dieses Anhängen vorgesehen ist; weitere Zeilen sollten, wenn sie Swift-Kommentare sein sollen, selbst mit `//` beginnen.
Die belegte Reichweite der beschriebenen Lösung ist begrenzt: Der Autor hat sie für neue Swift-Quelldateien über die beim Anlegen einer Datei angebotenen Vorlagen ausprobiert. Wie sich andere Dateitypen beeinflussen lassen, hat er nach eigener Aussage noch nicht getestet. Ein verlinkter Forumsbeitrag enthalte weitere Hinweise, deren Ratschläge der Autor jedoch ebenfalls nicht geprüft hat. Der Bericht präsentiert seine Erkenntnisse daher als praktische Erprobung und nicht als umfassende, offiziell dokumentierte Anleitung.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Es wurden keine Sammelfragen oder Teilfragen angegeben, daher bleibt die Einordnung leer. Die Zusammenfassungen sind sachlich korrekt und enthalten keine erfundenen Angaben. Die kurze Fassung lässt die Dokumentationslücke und die Makros aus. Die mittlere Fassung erwähnt die Dokumentationslücke und die Makros, lässt aber den Zeilenumbruch nach <string> aus. Der Hinweis, FILEHEADER nicht in der eigenen Definition zu verwenden, ist im Original ein Tipp zum Testen anderer Makros und wird in der mittleren Fassung leicht verkürzt wiedergegeben.
Im Bericht, aber nicht in der Zusammenfassung
- Der Zeilenumbruch direkt nach dem <string>-Tag ist nötig, damit Xcode den Header korrekt übernimmt (in beiden Zusammenfassungen nicht erwähnt)
- Die Makros wie ___FILEBASENAME___ steuern die Standardvorlagen (nur in der kurzen Fassung nicht erwähnt)
- Die fehlende Dokumentation der Vorlagen und Makros in den Xcode-Entwicklerunterlagen (in der kurzen Fassung nicht erwähnt)
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.