テンプレート ライブラリを作成する

提供: RAD Studio
移動先: 案内検索

操作手順:コード エディタでコードを編集する への移動


テンプレート ライブラリは、プロジェクトの外観と包含するものを指定するカスタム プロジェクト テンプレートです。 カスタム テンプレート ライブラリを作成すると、[新規作成]ダイアログ ボックスに配置されます。このダイアログ ボックスには、プロジェクトを作成するために [ファイル|新規作成]からアクセスできます。

テンプレート ライブラリ プロジェクトは、最初から作成することもできますし、以前作成されたプロジェクトをテンプレート ライブラリのベースとして使用することもできます。 既存のプロジェクトを使用するには、単純にXML ファイルを拡張子 .bdstemplatelib で作成します。このファイルには、プロジェクトの内容が記述され、そのプロジェクトを使用してテンプレート ライブラリを作成するために使用されます。

メモ: テンプレート ライブラリで使用するプロジェクトを作成する場合、プロジェクトは他のプロジェクトを含んでいないサブディレクトリに配置してください。 また、プロジェクトのすべてのファイルは、そのサブディレクトリか、その配下のサブディレクトリに配置してください。

テンプレート ライブラリを作成するには:

  1. カスタム テンプレート ライブラリのベースとなる新しいプロジェクトを作成するか、既存のプロジェクトを開きます。 テンプレート ライブラリ用にカスタマイズするために、プロジェクトに変更を加えます。
  2. プロジェクトを保存して、閉じます。
  3. [ファイル|新規作成|その他...|Web ドキュメント]を選択し、[XML ファイル]アイコンをダブルクリックします。
  4. 新しい XML ファイルのデフォルトの内容を以下のサンプルの内容で置き換えます。


  <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>


メモ:
  • <TemplateLibrary> 要素の id = "" 属性は、他のテンプレート ライブラリと競合することを防ぐために一意になるようにしてください。 自分の名前か、会社の名前を id の一部として含めることをお勧めします。
  • C++Builder プロジェクトの場合、<ProjectFile> 要素での拡張子を、cbproj に変更します。
  • <Item> 要素の Creator = "" 属性には、[新規作成]ダイアログ ボックスのどのページにこのテンプレート ライブラリのアイコンが表示されるかを指定します。 プロジェクト アイコンは、そのアイコンが作成するプロジェクトの種類に応じた特定のページに配置できます。
指定できる Creator="" 属性値を以下に示します。


プロジェクトの種類 Item 要素の Creator の属性値
C++ プロジェクト Creator="CBuilderProjectRepositoryCreator"
Delphi プロジェクト Creator="DelphiProjectRepositoryCreator"


  1. .bdstemplatelib ファイルをプロジェクト ディレクトリの上のディレクトリに保存します。
    メモ: .bdstemplatelib ファイルの <FilePath> 要素は、.bdstemplatelib ファイルの場所からプロジェクト ディレクトリへの相対的な位置を示します。
  2. 独自のテンプレート ライブラリにカスタマイズするために、.bdstemplatelib xml の内容を編集します。

    • テンプレート ライブラリ名、説明、および Creator 属性値を追加します。
    • プロジェクト名、プロジェクト パス情報、アイコン パス、およびファイル名を編集します。 オプションで、作成者として自分の名前を追加できます。
    • .bdstemplatelib xml への相対パスを <FilePath> 値で指定します。たとえば、プロジェクトが C:\MyProjects\TemplateLibraries\MyTemplate にあり、XML ファイルを C:\MyProjects\TemplateLibraries を置く場合、XML ファイルの <FilePath> 値は <FilePath>TemplateLibraries\MyTemplate</FilePath> となります。
  3. [ツール|テンプレート ライブラリ...]を選択して、[テンプレート ライブラリ]ダイアログ ボックスを開きます。
  4. 追加 ボタンをクリックして、先ほど作成した .bdstemplatelib xml ファイルを見つけて選択し、開くをクリックします。 新しいテンプレート ライブラリが、テンプレート ライブラリ ダイアログ ボックスのリストに追加されます。 [新規作成] ダイアログ ボックスの指定されたページにも追加されます。[OK]をクリックして、[テンプレート ライブラリ]ダイアログ ボックスを閉じます。

このテンプレート ライブラリを使用して新しいプロジェクトを作成するには、[ファイル|新規作成|その他...]を選択し、[新規作成]ダイアログ ボックスでテンプレート ライブラリを選択します。

  <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>

関連するプロジェクトがいくつかある場合、1 つの .bdstemplatelib テンプレート ライブラリ ファイルを使用してすべてのプロジェクトをリストできます。

複数のプロジェクトを 1 つのテンプレート ライブラリ ファイルにまとめるには:

  1. すべてのプロジェクト フォルダを同じプロジェクト サブフォルダの同じレベルに配置します。
  2. .bdstemplatelib テンプレート ライブラリ ファイルをすべてのプロジェクトを含むフォルダの上のレベルに作成します。
  3. 最初のプロジェクトの内容を上で説明したとおりに追加します。
  4. さらに <Item></Item><Items></Items> 要素に、グループ内の各プロジェクト毎に追加します。その際、各 <Item></Item> には、一意の id=" 属性を指定します。

  <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>


関連項目