Vorlagenbibliotheken erstellen
Nach oben zu So bearbeiten Sie Code im Quelltext-Editor
Vorlagenbibliotheken sind benutzerdefinierte Projekt-Templates, die festlegen, wie ein Projekt aussehen und was es enthalten soll. Wenn Sie eine benutzerdefinierte Vorlagenbibliothek erstellen, wird sie in das Dialogfeld Objektgalerie platziert. Beim Erstellen eines neuen Projekts können Sie sie mit Datei > Neu daraus übernehmen.
Sie können Vorlagenbibliotheksprojekte komplett neu anlegen oder bereits von Ihnen oder anderen Entwicklern erstellte Projekte als Basis für Vorlagenbibliotheken verwenden. Um ein vorhandenes Projekt zu verwenden, erstellen Sie einfach eine XML-Datei mit der Erweiterung .bdstemplatelib
, die das Projekt beschreibt. Anhand dieser Datei wird die Vorlagenbibliothek erstellt.
Hinweis: Beim Erstellen eines Projekts, das mit einer Vorlagenbibliothek verwendet werden soll, muss sich das Projekt in einem Unterverzeichnis befinden, das keine anderen Projekte enthält. Auch alle Dateien des Projekts müssen in diesem Unterverzeichnis oder in untergeordneten Unterverzeichnissen gespeichert werden.
Inhaltsverzeichnis
So erstellen Sie eine Vorlagenbibliothek
- Legen Sie ein neues Projekt an oder öffnen Sie ein vorhandenes, das als Basis für die Vorlagenbibliothek dienen soll.Führen Sie die alle gewünschten Änderungen an dem Projekt aus.
- Speichern und schließen Sie das Projekt.
- Wählen Sie Datei > Neu > Weitere > Webdokumente, und doppelklicken Sie auf das Symbol XML-Datei.
- Ersetzen Sie den Vorgabeinhalt der neuen XML-Datei durch den folgenden Inhalt:
<TemplateLibrary Version="1.0" id="">
<Name></Name>
<Description></Description>
<Items>
<Item id="" Creator="">
<Name>Name of template library here </Name>
<Description>Custom Project Template</Description>
<Author></Author>
<Icon>MyTemplate\MyTemplateIcon.ico</Icon>
<ProjectFile>MyTemplate.dproj</ProjectFile>
<DefaultProjectName>MyTemplate</DefaultProjectName>
<FilePath>MyTemplate</FilePath>
<Identities>RadStudio</Identities>
</Item>
</Items>
</TemplateLibrary>
-
- Hinweise:
- Das Attribut
id=""
des Elements<TemplateLibrary>
muss eindeutig sein, um Konflikte mit anderen Vorlagenbibliotheken zu vermeiden. Verwenden Sie beispielsweise Ihren Namen oder den Namen Ihres Unternehmens als Bestandteil derid
. - Ändern Sie für C++Builder-Projekte die Erweiterung im
<ProjectFile>
-Element zucbproj
. - Das Attribut
Creator=""
des Elements<Item>
legt fest, auf welcher Seite des Dialogfeldes Objektgalerie das Symbol für diese Vorlagenbibliothek angezeigt wird. Sie können das Projektsymbol auf einer speziellen Seite für den Projekttyp platzieren, der erstellt wird.
- Das Attribut
- Im Folgenden finden Sie mögliche Werte für das Attribut
Creator=""
:
- Hinweise:
Projekttyp | Attributwert für Item Creator |
---|---|
C++-Projekte | Creator="CBuilderProjectRepositoryCreator" |
Delphi-Projekte | Creator="DelphiProjectRepositoryCreator" |
-
Speichern Sie die xml-Datei
.bdstemplatelib
in einem Verzeichnis über dem Projektverzeichnis.Hinweis: Das Element
<FilePath>
in der.bdstemplatelib
-Datei gibt die Position des Projektverzeichnisses relativ zur Position der.bdstemplatelib
-Datei an. Passen Sie den xml-Inhalt
.bdstemplatelib
an, um ihn an Ihre Vorlagenbobliothek anzupassen:- Fügen Sie einen Vorlagenbibliotheksnamen, eine Beschreibung und den Wert für das Attribut
Creator
hinzu. - Bearbeiten Sie den Projektnamen, den Projektpfad, den Symbolpfad und den Dateinamen. Optional können Sie Ihren Namen als Autor hinzufügen.
-
Geben Sie den relativen Pfad zu der xml-Datei
.bdstemplatelib
im Wert<FilePath>
an. Wenn sich Ihr Projekt beispielsweise im VerzeichnisC:\MyProjects\TemplateLibraries\MyTemplate
befindet, und Sie die XML-Datei im VerzeichnisC:\MyProjects\TemplateLibraries
gespeichert haben, wäre der Wert für<FilePath>
in der XML-Datei<FilePath>TemplateLibraries\MyTemplate</FilePath>
.
- Fügen Sie einen Vorlagenbibliotheksnamen, eine Beschreibung und den Wert für das Attribut
- Wählen Sie Tools > Vorlage Bibliotheken , um das Dialogfeld Vorlagenbibliotheken zu öffnen.
- Klicken Sie auf die Schaltfläche Hinzufügen, navigieren Sie zu der gerade erstellten xml-Datei
.bdstemplatelib
, und klicken Sie auf Öffnen. Die neue Vorlagenbibliothek wird der Liste im Dialogfeld Vorlagenbibliotheken hinzugefügt. Sie wird außerdem der festgelegten Seite im Dialogfeld Neue Dateien hinzugefügt.Klicken Sie auf OK, um das Dialogfeld Vorlagenbibliotheken zu schließen.
Um mit dieser Vorlagenbibliothek ein neues Projekt zu erstellen, wählen Sie Datei > Neu > Weiter und im Dialogfeld Objektgalerie Ihre Vorlagenbibliothek.
Beispiel
<TemplateLibrary Version="1.0" id="CompanyNameDelphiVCLProject">
<Name>DelphiVCLProject</Name>
<Description>Simple Delphi VCL Project</Description>
<Items>
<Item id="DelphiVCLProject" Creator="DelphiProjectRepositoryCreator">
<Name>Delphi VCL Project</Name>
<Description>A simple Delphi VCL project.</Description>
<Author>John Doe</Author>
<ProjectFile>DelphiVCLProject.dproj</ProjectFile>
<DefaultProjectName>DelphiVCLProject</DefaultProjectName>
<FilePath>DelphiVCL</FilePath>
<Identities>RadStudio</Identities>
</Item>
</Items>
</TemplateLibrary>
Bei mehreren zusammengehörigen Projekten können Sie mit einer einzigen .bdstemplatelib
-Vorlagenbibliothek alle Projekte auflisten.
So verbinden Sie mehrere Projekte in einer Vorlagenbibliotheksdatei
- Platzieren Sie alle Projektordner auf derselben Ebne in demselben Projektunterordner.
- Erstellen Sie die
.bdstemplatelib
-Vorlagenbibliotheksdatei auf der Ebene über dem Ordner mit den Projekten. - Fügen Sie den Inhalt für das erste Projekt wie oben beschrieben hinzu.
- Fügen Sie dem Element
<Item></Item>
weitere<Items></Items>
-Elemente für alle Projekte in der Projektgruppe hinzu. Geben Sie dabei jedem<Item></Item>
-Element ein eindeutigesid="
-Attribut.
Beispiel
<TemplateLibrary Version="1.0" id="Embarcadero">
<Name>MultipleProjectsTemplate</Name>
<Description>Template with multiple projects.</Description>
<Items>
<Item id="DelphiVCLProject" Creator="DelphiProjectRepositoryCreator">
<Name>Delphi VCL Project</Name>
<Description>A simple Delphi VCL project.</Description>
<Author>John Doe</Author>
<ProjectFile>DelphiVCLProject.dproj</ProjectFile>
<DefaultProjectName>DelphiVCLProject1</DefaultProjectName>
<FilePath>DelphiVCL</FilePath>
<Identities>RadStudio</Identities>
</Item>
<Item id="CppVCLProject" Creator="CBuilderProjectRepositoryCreator">
<Name>C++ VCL Project</Name>
<Description>A simple C++ VCL project.</Description>
<Author>John Doe</Author>
<ProjectFile>CPPVCLProject.cbproj</ProjectFile>
<DefaultProjectName>CPPVCLProject2</DefaultProjectName>
<FilePath>CPPVCL</FilePath>
<Identities>RadStudio</Identities>
</Item>
</Items>
</TemplateLibrary>