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.
ファイルの名前、場所、内容はワークスペースAPIの一部となります。
このファイルの名前、格納場所、及び内容はworkplace 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を通してプロジェクトの記述を変更するのと同じ効果を持ちます。ひとつの例外としては、プロジェクトの性質を追加や削除することで呼応する性質の設定や解除を引き起こすことはありません。もうひとつの例外としては、プロジェクト名に関する変更は無視されます。
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()と一致します。
新規プロジェクトが既存プロジェクトの説明ファイルが格納されている場所に作成される場合、既存プロジェクトファイルがプロジェクト説明ファイルとして採用される。
ひとつの例外は、新規に作成されるプロジェクト名が既存のプロジェクト説明ファイルのプロジェクト名と一致しない場合は、説明ファイルのプロジェクト名は無視される。格納されている説明ファイルが無効である場合は、新規プロジェクトの作成は失敗する。
name:プロジェクト名は、IProjectDescription.getName()に対応し、このファイルで使われているプロジェクト名と一致しない場合は無視される。
comment:プロジェクトのためのコメントで、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.
buildCommand- このプロジェクト用に単体で構築されたコマンドです。org.eclipse.core.resources.ICommandに相当します。
name- 追加するプロジェクトビルダーのシンボル名称です。ICommand.getBuilderName()に相当します。
arguments-プロジェクトビルダーに通過させることが可能な任意の議論です。ICommand.getArguments()に相当します。
dictionary- arguement list に含まれる<key, value>というペアの一覧です。java.util.Mapに類似しています。
natures-このプロジェクト上の本質の名称です。IProjectDescription.getNatureIds()に相当します。
nature- このプロジェクト上の単体の本質名称です。
buildCommand:このプロジェクトの為のひとつのビルドのコマンドで、org.eclipse.core.resources.ICommandに対応する。
name:昇順のプロジェクト ビルダーの記号名で、ICommand.getBuilderName()に対応する。
argument(引数):プロジェクト ビルダーに渡す事の出来る追加的アーギュメント(引数)で、ICommand.getArguments()に対応する。
dictionary:アーギュメント一覧の中の<key, value>ペアの一覧で、Analagous to 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.
link - 単体でリンクされたリソースの定義
name - ワークスペースに表示するためのリンクされたリソースのプロジェクト関連パス
type - リソースのタイプ。その値は、ファイルに対しては「1」、フォルダに対しては「2」となる。
location - リンクされたリソースのターゲットのローカルファイルシステムパス。最初のセグメントがワークスペースパス変数である絶対パス、あるいは関連パスをさす。
locationURI - ファイルがローカルファイルシステムにない場合、この特性にはいくつかのバックアップファイルシステムにあるリソースの絶対URIが含まれる。
link:ひとつの関連付けられたリソースの定義
name:関連付けられたリソースのプロジェクト関連パスで、ワークプレイス内に表示される。
type:リソースのタイプで、その値は「1」がファイルで、「2」がフォルダーである。
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情報:org.eclipse.core.resources.IProjectDescriptionインターフェイスへのプロジェクト記述ファイルマップの内容。この
プロジェクト記述ファイルはIProject.setDescription()の方法によって上書きすることができます。
ありがとうございます。こちらで使わせていただいています。
http://matome.naver.jp/odai/2141055213977636301