入门
主要内容
- 创建一个存放位置
- 把一个新项目导入到存储库
- 连接一个存在SVN的项目
- 检出项目
创建一个存放位置
概述
毋庸置疑,在您开始使用一个SVN存储库工作之前,您必须在Eclipse IDE中定义这个存放位置。
步骤
一般是通过SVN Repository 视图中创建和运用您的存储库地址,它属于SVN Repository Exploring Perspective(SVN存储库扫描透视图)的一部分。当你需要创建一个新的存储库地址时,点击Add SVN Repository按钮 或者在右击透视图,选择New > Repository Location...
添加SVN存储库对话框会提示您的存放位置的URL 。输入存放您要连接的。没有身份验证信息,请在该位置的定义,它是留给SVN请求您的用户和密码信息时,这是必需的。
在Add SVN Repository 对话框中会提示您输入存放位置的URL,当然输入的存储库地址必须是可连接的。在定义该位置不需要请求身份验证,只有当SVN请求您的的用户和密码信息时,它们才是必需的。这种方式的主要好处是让SVN来管理您的密码,当您的密码发生更改时它会提示您输入一个新密码。此外,它也将缓存和加密新密码。
当您点击finish,这个向导将创建这个存放位置。展开它就可以看到这个指定地址里的内容。
把一个新项目导入到存储库
概述
这是把您的Eclipse工作区的一个新项目导入到存储库的过程,以便您能通过SVN管理它。如果你已经使用了SVN ,而且您现在您的工作区中已有的项目拷贝,当你要连接到SVN ,您可能需要参阅连接现有项目(接下来的一节)中的步骤。
步骤
如果您还没有准备好把您的项目导入到存储库,先创建一个简单的项目,包含一些文件,使它们可以被存储到存储库中。您可以采用一个简单的方式即可实现这个目标,譬如通过选择File > New > Project... 和 Plug-in Development > Plug-in Project,提供项目名称,点击完成这个向导,就创建了一个示例插件工程。
要把项目导入存储库中,首先右键单击要导入的项目,然后从菜单栏中选择Team > Share Project...
这将开启Share Project向导,选择存储库类型如SVN ,点击Next。
如果您已定义了一个存放位置来存储这个项目,那么就在列表中选择它,然后单击Next。否则,就选择"Create a new repository location"选项,然后单击Next。如果您需要创建它,请参阅创建一个存放位置部分以查询更多信息。
您必须为存储的项目指定文件夹名称。文件夹名称是一个相对的URL,存放在指定位置的上一步。所有中间文件夹必须已经存在于存储库中,但最终的文件夹名称则不能已经存在。您可以使用Browse... 按钮从存储库选择一个路径。Browse(浏览) 对话框还允许您创建文件夹,这样您就可以使用该选项创建任何中间文件夹。在上面的例子中,我们将按照项目储存的约定定义成"ProjectName/trunk"的结构。在这个例子中, ProjectName文件夹必须已经存在而trunk文件夹必须不存在。当您结束时,单击Next 或Finish 。
题外话:当您使用Browse... 时请确保选择的URL是可存在的,不然会不断弹出窗口,从而有可能导致程序崩溃。
向导的最后一页只是一个最后确认页面。当您单击Finish,SVN将调出mkdir命令在存储库的指定位置创建一个空文件夹。接着它将检出该文件夹至您的本地项目。这一步将在该项目内部中创建 .svn文件夹,从而将它变成一个有效的项目拷贝。最后,向导将弹出一个提交对话框,提交您可以向存储库提交的任何东西。当然您没必要提交一切,或者任何其他东西。您也可能想要取消提交对话框,然后返回您的工作区并执行Team菜单的其他操作。例如,如果你想要设置如"Commit"角色的SVN属性,你将首先使用Team > Add to Version Control选项,然后使用Team > Set Property 选项等等。一旦你的东西变成了您想要的方式,您就可以执行Team > Commit。
题外话:.svn是一组隐藏文件夹。
连接一个存在SVN的项目
概述
这是在您的工作区中存在现有的项目拷贝的同时连接到SVN的过程。如果您有一个全新的项目要导入到您的存储库,那么请查看把一个新项目导入到SVN存储库部分。
步骤
此过程假定您在您的工作区已经有一个现有的项目,而且该项目是一个有效的工作副本。选择您需要连接的SVN项目,然后右击选择Team > Share Project...
这将开启Share Project向导,选择存储库类型如SVN ,点击Next。
该向导将在您最初选择共享的项目根目录中检查.svn元数据文件夹是否有效。如果它发现了这些文件夹,那么您将会看到如上图所示的截屏。如果您没有看到这个截屏,取而代之的是提示这是一个新项目的截屏时,那么您应该取消此向导。这就意味着,该向导不承认这是一个现有的工作副本。如果您继续,该向导将按把一个新项目导入到您的存储库的步骤一样处理它。否则,假设你看到上述画面,则只要按一下Finish 即可连接SVN项目 。该向导将完成提交对话框的流程,并提交任何本地修改过的文件。如果您不想在这个时侯做任何事情,您可以取消该对话框。
题外话:这里的SVN项目是指您用其他SVN客户端工具检出的项目。
检出项目
概述
检出是一个专有名词,指从存储库的一个项目中产生一个副本,并把它复制到您的本地工作区的过程。在SVN中,检出过程创建一个工作副本。工作副本是一个特殊格式的文件夹结构,它额外包含一些.svn文件夹,这些文件夹存储SVN信息,以及在检出该项目后为项目中每项保留一个原始副本。
过程
因为检出直接对应着您的存储库,那么导航到SVN Repository Exploring Perspective(SVN存储库扫描透视图)吧。如果您还没有为您的存储库定义一个连接,您将首先要添加一个新的存放位置。
选择您需要的存储库目录,然后右击上下文菜单选择Checkout。
如果Eclipse的.project文件已经存在于选定的存储库文件夹中,检出向导将自动地默认检出的方法,并使用项目定义文件。如果没有在存储库文件夹不存在.project文件,向导将让您选择以标准Eclipse项目或者新建工程向导的方式检出文件夹。
接下来,将允许您找出您创建的工作副本。系统设定在您的Eclispe工作区中创建工作副本。要选择其他位置,请取消勾选use default workspace location选项,输入或者Browse 一个新的目标地址。