如何运行 JSVN

JSVN 是一个用 Java Swing 编写的 Subversion 图形客户端,运行它的前提是本地已安装 Subversion 客户端,然后用 java -jar jsvn-0.8.jar 启动。启动后既可以把 JSVN 指向已有的工作副本,也可以直接用它从仓库检出(Checkout)一份新副本。

运行前的准备

  • 本地机器上必须已安装 Subversion 客户端。JSVN 本身不替代 Subversion,它是对 Subversion 命令的封装。
  • 需要能运行 Java 程序的环境,因为 JSVN 以 jar 包形式发布。
  • 准备好要访问的仓库地址,以及(如果需要)对应的用户名和密码。

启动 JSVN

下载 release 0.8 的 jar 文件后,在命令行执行:

java -jar jsvn-0.8.jar

预期结果是 JSVN 的图形界面被拉起,之后的操作都在这个界面里完成。

指向已有工作副本

如果本地已经有一份 Subversion 工作副本,想让 JSVN 接管它:

  1. 打开 Working Copy 菜单。
  2. 选择 Set。
  3. 指定该工作副本所在的本地目录。

设置完成后,JSVN 就会以这个目录为操作对象。

用 JSVN 检出新的工作副本

如果本地还没有工作副本,可以直接用 JSVN 检出:

  1. 打开 Working Copy 菜单。
  2. 选择 Checkout。
  3. 在对话框的 URL 字段填入仓库地址。资料中给出的示例地址是 http://golpira.homelinux.com/svn/repos/jsvn/trunk/。
  4. 在 Working Copy 字段选择一个本地目录,作为工作副本的存放位置。
  5. Username、Password、Confirm 三个字段留空。

这个示例仓库是公开可读的,所以不需要填认证信息;换成需要认证的仓库时,才需要按实际情况填写用户名和密码。

JSVN 目前能做什么

根据项目说明,JSVN 在 release 0.8 阶段已接近“功能完整”,大部分 Subversion 命令已完整实现,包括:

  • checkout
  • status
  • log
  • info
  • update
  • diff
  • commit

此外,所有 Subversion 命令都已做了桩(stub)实现,并且支持运行需要 Subversion 服务器认证的命令。从 release 0.6 起,JSVN 还开始实现若干 Ant 任务,以便在 Ant 脚本中访问仓库;与 IntelliJ IDEA 集成的插件也在开发中。

还没完成的部分

项目自述中列出的、在 1.0 之前仍需完成的工作包括:

  • 完整支持 Subversion 的全部命令集
  • 补齐一整套对话框,让用户能选择复杂的命令选项
  • 安装与用户文档

也就是说,当前版本可用,但复杂命令选项的图形化配置和文档还不完整。

常见卡点

  • 启动前没装 Subversion 客户端:JSVN 依赖本地 Subversion 客户端,缺了它无法正常工作。
  • Checkout 时填了示例仓库的认证信息:示例地址不需要用户名密码,这三个字段留空即可;填了反而可能出错。
  • 把 JSVN 当成独立客户端:它是对 Subversion 命令的封装,底层仍需要 Subversion 支持。

项目背景

JSVN 于 2003 年 1 月 14 日作为开源项目发布,采用 Academic Free License 1.2 许可。它的目标是开发一个 Java Swing 客户端,用来访问和操作 Subversion 仓库。项目作者选择 Java,是看中其可移植性,希望最终能让任何人在任何平台上免费使用。

jsvn.alternatecomputing.com