When a project is created in the workspace, a project description file is automatically generated that describes the project. The purpose of this file is to make the project self-describing, so that a project that is zipped up or released to a server can be correctly recreated in another workspace. This file is always called ".project", and is located as a direct member of the project's content area. The name of the file is exposed through the static field DESCRIPTION_FILE_NAME on org.eclipse.core.resources.IProjectDescription.
The name, location, and content of this file are part of the workspace API.
プロジェクトがワークスペース上に作成されると、そのプロジェクトを記述するディスクリプションファイルが自動的に作成されます。このファイルの目的は、プロジェクトに自己記述性を持たせ、圧縮されたりサーバーへリリースされるプロジェクトが別のワークスペースにおいても正しく再生されるようにするものです。このファイルは必ず 「.project」と呼ばれ、プロジェクトエリアに直属します。ファイル名はorg.eclipse.core.resources.IProjectDescription.上の静的フィールドDESCRIPTION_FILE_NAMEを通してエクスポートされます。
ファイルの名前、場所、内容はワークスペースAPIの一部となります。
This means they are guaranteed not to change in a way that would break existing users of the file. However, the right to add additional elements and attributes to the markup is reserved for possible future additions to the file. For this reason, clients that read the description file contents should tolerate unknown elements and attributes.
Clients that modify, delete, or replace the project description file do so at their own risk. Projects with invalid or missing description files will not be generally usable. If a project with an invalid description file is discovered on workspace startup, the project is closed, and it will not be possible to open it until the project description file has been repaired.
これが意味するところは、従来のユーザー用ファイルを壊してしまうような変更はしないと保証しているということです。しかしながら、追加項目や特性を値上げに組み込む権利は今後のファイルへの追加分として保護されます。この理由により記述ファイルの内容に目を通したクライアントは未知なる項目や特性に対する耐性を持つことができるようになります。
プロジェクト記述ファイルの修正、削除、及び交換を行うクライアントは、上述の対応を自らの危険が迫った際に実施します。無効あるいは不十分な記述ファイルのプロジェクトは一般的に使用されることはありません。もしプロジェクトに無効な記述ファイルが含まれる場合は、ワークスペース上のスタートアップで検知され、そのプロジェクトが閉じられます。プロジェクト記述ファイルが修復されるまで、それが開かれることはありません。
The workspace will not generally attempt to automatically repair a missing or invalid description file. One exception is that missing project description files will be regenerated during workspace save and on calls to IProject.setDescription.
Modifications to the project description file have mostly the same effect as changing the project description via IProject.setDescription. One exception is that adding or removing project natures will not trigger the corresponding nature's configure or deconfigure method. Another exception is that changes to the project name are ignored.
ワークスペースは行方不明や無効になっている記述ファイルを自動的に修復することはありません。ひとつの例外としては、行方不明の記述ファイルはワークスペースの保存やIProject.setDescriptionの呼び出し時に再作成されます。
記述ファイルに変更を加えることはIProject.setDescriptionを通してプロジェクトの記述を変更するのと同じ効果を持ちます。ひとつの例外としては、プロジェクトの性質を追加や削除することで呼応する性質の設定や解除を引き起こすことはありません。もうひとつの例外としては、プロジェクト名に関する変更は無視されます。
If a new project is created at a location that contains an existing project description file, the contents of that description file will be honoured as the project description.
One exception is that the project name in the file will be ignored if it does not match the name of the project being created. If the description file on disk is invalid, the project creation will fail.
name - the name of the project. Ignored if it does match the name of the project using this description. Corresponds to IProjectDescription.getName().
comment - a comment for the project. The comment can have arbitrary contents that are not interpreted by the project or workspace. Corresponds to IProjectDescription.getComment().
もしも新規のプロジェクトが既存のプロジェクトファイルと同じ場所で作成された場合、新規プロジェクトの内容は既存のプロジェクトファイルに帰属します。
ひとつの例外として、もしも新規作成のプロジェクト名と既存のプロジェクト名が一致しない場合は無視されます。ディスク上のディスクリプションファイルが正しくない場合は、プロジェクトの新規作成は出来ません。
名前 - プロジェクトの名前。このプロジェクト名がディスクリプションを使用しているものと一致しない場合は無効となります。IProjectDescription.getName()と一致します。
コメント - プロジェクトへのコメント。コメントはプロジェクとやワークスペースへから影響されることなく任意の内容となります。IProjectDescription.getComment()と一致します。
buildSpec - the ordered list of build commands for this project. Corresponds to IProjectDescription.getBuildSpec().
buildCommand - a single build commands for this project. Corresponds to org.eclipse.core.resources.ICommand.
name - the symbolic name of an incremental project builder. Corresponds to ICommand.getBuilderName().
arguments - optional arguments that may be passed to the project builder. Corresponds to ICommand.getArguments().
dictionary - a list of <key, value> pairs in the argument list. Analagous to java.util.Map.
natures - the names of the natures that are on this project. Corresponds to IProjectDescription.getNatureIds().
nature - the name of a single natures on this project.
buildSpec－このプロジェクトのために構築されたコマンドの配置リストです。IProjectDescription.getBuildSpec()に相当します。
buildCommand－ このプロジェクト用に単体で構築されたコマンドです。org.eclipse.core.resources.ICommandに相当します。
name－ 追加するプロジェクトビルダーのシンボル名称です。ICommand.getBuilderName()に相当します。
arguments－プロジェクトビルダーに通過させることが可能な任意の議論です。ICommand.getArguments()に相当します。
dictionary－ arguement list に含まれる<key, value>というペアの一覧です。java.util.Mapに類似しています。
natures－このプロジェクト上の本質の名称です。IProjectDescription.getNatureIds()に相当します。
nature－ このプロジェクト上の単体の本質名称です。
linkedResources - the list of linked resources for this project.
link - the definition of a single linked resource.
name - the project-relative path of the linked resource as it appears in the workspace.
type - the resource type. Value values are: "1" for a file, or "2" for a folder.
location - the local file system path of the target of the linked resource. Either an absolute path, or a relative path whose first segment is the name of a workspace path variable.
locationURI - if the file is not in the local file system, this attribute contains the absolute URI of the resource in some backing file system.
linkedResources - このプロジェクト用のリンク済みリソースリスト
link - 単体でリンクされたリソースの定義
name - ワークスペースに表示するためのリンクされたリソースのプロジェクト関連パス
type - リソースのタイプ。その値は、ファイルに対しては「１」、フォルダに対しては「２」となる。
location - リンクされたリソースのターゲットのローカルファイルシステムパス。最初のセグメントがワークスペースパス変数である絶対パス、あるいは関連パスをさす。
locationURI - ファイルがローカルファイルシステムにない場合、この特性にはいくつかのバックアップファイルシステムにあるリソースの絶対URIが含まれる。
Examples: The following is a sample project description file. The project has a single nature and builder configured, and some project references.
API Information: The contents of the project description file map to the org.eclipse.core.resources.IProjectDescription interface. The project description file can be overwritten by the method IProject.setDescription().
用例: 以下はプロジェクト説明ファイルの用例である。プロジェクトにはひとつのネーチャー、構成されたビルダー、及びあるプロジェクト レファレンスを持っている。
API Information：org.eclipse.core.resources.IProjectDescriptionインターフェースにマップされたプロジェクト説明ファイルの内容。プロジェクト説明ファイルは、IProject.setDescription()の方法によって上書きすることができる。
