SVN 插件 Subclipse 的安装与使用

在非 Windows 平台上使用该插件，需要单独安装 JavaHL.

通过平台更新

安装参官方教程: How to install SVN client plugin

也可以把下载的插件包解压後, 把 features 和 plugins 中的文件, 拷贝到 Eclipse 目录下对应的 features 和 plugins 目录.

另外, 对于 MyEclipse 7.1, 它改变了传统的 Eclipse 目录结构, features 和 plugins 目录在 C:\Program Files\Genuitec\Common 下, 目前似乎只能使用上面说的方法. 参 Installing Subclipse 1.6 into MyEclipse 7.1, 下面介绍的 links 方式与它无缘了.

对于 Eclipse JEE(Helios) for Ubuntu 64 因为插件依赖关系，也只能用这种方式安装。

以 link 方式安装

按: 这里用到的文件目录是以我办公室机器为例.

下载的插件解压後, 要放在名为 eclipse 的文件夹下.

示例如下:

C:\myeclipseplugins\subclipse\eclipse

├─artifacts.xml

├─content.xml

├─features

├─plugins

└─site.xml

然後在 Eclipse 的根目录 C:\eclipse-jee-galileo-win32\eclipse 之下建立目录 links. links 和 features, plugins 两个文件夹是并列的.

在links 文件夹里添加一文本文件, 可以任意名称即後缀名. 这里用 plugins.txt, 内容如下:

path=C:/myeclipseplugins/subclipse

(目录分隔符用不能用 Windows 文件分隔符 \, 但可使用双 Windows 分隔符 \\ )

path 是插件目录.

下面摘录一些<使用 links 方式安装 Eclipse 插件>的内容:

1. 插件可以分别安装在多个自定义的目录中。

2. 一个自定义目录可以安装多个插件。

3. link文件可以有多行path=插件目录，对应多个自定义插件目录，每一行的path参数都将生效。

4. 在links目录也可以有多个link文件，每个link文件中的path参数都将生效。

5. 插件目录可以使用相对路径。

6. 可以在links目录中建立一个子目录，转移暂时不用的插件到此子目录中，加快eclipse启动。

7. 如果安装後看不到插件，把eclipse安装目录下的configuration/org.eclipse.update/目录整个删除，重启eclipse。

局域网中的代理设置

安装好 Subclipse 插件後, 修改配置文件, 下面以我的为例:

  • Windows XP: C:\Documents and Settings\caoyi\Application Data\Subversion\servers
  • Windows 7: C:\Users\iridium\AppData\Roaming\Subversion\servers

打开後, 修改两个参数值即可, 还是以我的为例:

http-proxy-host = 192.168.1.39

http-proxy-port = 808

提交时自动加入 $Id$ 信息

提交文件时, SVN server 会自动记录时间, 提交者, 版本号等等. 但也可以将这些信息直接记录到文件里, 方便在查看文件时就能查到, 例如:

$Id: hello2.properties 40 2009-08-26 06:15:42Z iridiumcao $

SVN 系统提供几个关键字: Date, Revision, Author, HeadURL, Id, 在创建新文件时, 以 $keyword$ 的形式写到要提交的文件里就可以了. $Id$ 包含其他几个关键字的内容.

但是, 还需要设置一下配置文件才可以, 配置文件的位置如下:

  • C:\Documents and Settings\caoyi\Application Data\Subversion\config
  • ~/.subversion/config

具体修改如下:

  1. 把 enable-auto-props = yes 前的注释符号#删掉,
  2. 把形如 *.png = svn:mime-type=image/png; svn:needs-lock=* 的行的注释符#删掉,
  3. 如果文件类型不在列表中, 可以考虑自己手工添加, 如:
    • *.java = svn:eol-style=native; svn:keywords=Id Author Date Revision
    • *.properties = svn:eol-style=native; svn:keywords=Id Author Date Revision

在 ArgoUML 上有一部分现成的内容(Configrating Subversion 部分)拷贝过去.

工程被锁定导致不能提交

Eclipse 中出现 SVN 资源被锁定无法修改本地文件怎么办？

资源被锁定，有时候是之前的同步或提交操作失败导致的，比如网络被封，连接不畅，强制关闭和重启 eclipse 就可能导致这个问题。

or

eclipse resource locked by svn

解决办法: Team -> Refresh/Clean Up (中文: "清理")

注: 这个办法来源于此.

提交空文件夹的办法

如果移动文件到某文件夹，而这个文件夹还没有提交过，就会出现下面的报错信息：

解决办法是先提交空文件夹，再提交文件。

附

  1. Subclipse 官网: http://subclipse.tigris.org/
  2. 文中皆以 Windows 为例, Linux 系统类似, 只是代理文件位置需要调查, 容日後到用再补记.
  3. 通过 Eclipse 更新功能安装插件的参考
  4. 大约在2014年底左右, 版本管理系统切换到 git, 就再也没有回头用 SVN 了.