如何运行 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 接管它:
- 打开 Working Copy 菜单。
- 选择 Set。
- 指定该工作副本所在的本地目录。
设置完成后,JSVN 就会以这个目录为操作对象。
用 JSVN 检出新的工作副本
如果本地还没有工作副本,可以直接用 JSVN 检出:
- 打开 Working Copy 菜单。
- 选择 Checkout。
- 在对话框的 URL 字段填入仓库地址。资料中给出的示例地址是
http://golpira.homelinux.com/svn/repos/jsvn/trunk/。 - 在 Working Copy 字段选择一个本地目录,作为工作副本的存放位置。
- 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,是看中其可移植性,希望最终能让任何人在任何平台上免费使用。