Fireflyforeclipse使用规范.doc

中国光大银行配置管理人力资源服务项目Firefly for eclipse使用规范 All rights reserved 版权所有，侵权必究Firefly for eclipse使用规范文档修订记录编号*变化状态修订说明日期变更人*变化状态：A增加，M修改，D删除目 录1 前言32 Firefly Client的安装33 Firefly Client参数设置33.1 Firefly Client参数33.2 Firefly for Eclipse插件参数33.3 客户机操作系统时间调整34 wsad项目初始化35 关闭wsad46 Firefly for Eclipse插件的使用46.1 Birngover命令（更新本地工作区文件）46.2 6.2 add to source control增加新文件文件46.3 checkout和checkoutnow命令46.4 检入文件46.5 文件的删除、移动和重命名56.6 Rollback（回滚）命令56.6.1 Undelete命令56.6.2 History命令56.6.3 文件版本合并57 Firefly Client的使用57.1 组织工作区57.2 脱机工作模式67.3 文件状态67.4 过滤文件77.5 其他命令87.6 Firefly WEB的使用88 Firefly常见问题处理81 前言本文描述了开发人员在开发工作中Firefly for eclipse集成的正确使用方法，以减少由于操作方法不当对工作造成影响。2 Firefly Client的安装在安装Firefly Client for Windows软件时，需要安装MS .NET framework和VJ语言发布包，但是多数开发人员的操作系统中已经有MS .NET framework，因此直接安装VJ语言发布包和Firefly安装包，但是有可能原来的MS .NET framework版本比较旧，可能会造成Firefly Client使用问题，如果出现MS .NET framework引起的问题，重新安装MS .NET framework即可。在安装Firefly for Eclipse插件后，打开wsad可能会看不到Firefly菜单，需要关闭wsad现有打开视图，再重新打开就能够看到Firefly菜单了。3 Firefly Client参数设置3.1 Firefly Client参数安装Firefly Client之后需要在Firefly Client Setting中设置License Server主机地址（4）和端口号（缺省4761），以及界面语言（中/英文）。3.2 Firefly for Eclipse插件参数在wsad中打开config firefly界面，设置Firefly for Eclipse的参数，只填入License Server主机地址和端口号即可。其他选项和参数使用缺省值即可。3.3 客户机操作系统时间调整开发人员的客户机操作系统时间应与Firefly服务器时间一致（偏差不能超过24小时），如果由于某种原因将客户机操作系统时间进行调整，以致与Firefly服务器时间不一致，则会出现Firefly client连接不到Firefly Server的问题。4 wsad项目初始化开发人员在工作前需要将源代码从Firefly的存储库中下载到本地，然后在wsad中进行开发。正确方法如下：u 在Firefly Client中初始化工作区。将所需的源文件bringover到本地工作区。u 打开wsad，选择File-import，将bringover到本地工作区的项目导入wsad。u 选择Firefly-bind project from Source ，源代码后出现版本号，即可使用Firefly对代码进行版本管理工作。注意：u Firefly for Eclipse中的Open project from Source Control命令也可将Firefly存储库中的源文件下载到本地，但经常会出现问题，不推荐使用这个功能。u 如果不希望使用Firefly管理项目版本，选择Firefly-unbind project from Source。u 如果执行bind project from Source后出现异常，执行unbind命令，重新执行初始化工作区、import、bind项目操作。5 关闭wsad在结束开发工作关闭wsad之前，应使用wsad的“close project”命令关闭受控项目，然后再关闭wsad。如果不关闭project而直接关闭wsad，下次再打开wsad时，会出现wsad进程没有响应的现象。注意：如果不小心没有关闭工程直接关闭了wsad，再次启动wsad没有响应，可以将FireFly受控的工程在资源管理器中，暂时重命名，打开wsad，关闭对应的工程，关闭wsad，将刚才改名的工程恢复，打开wsad，打开工程即可。6 Firefly for Eclipse插件的使用6.1 Bringover命令（更新本地工作区文件）Bringover命令从Firefly存储库中下载最新版本的文件。但如果本地文件处于checkout状态时，不更新最新版本。注意：不要将所有文件作checkout，否则bringover命令不起作用。需要修改文件时再checkout这个文件。6.2 add to source control增加新文件文件使用add to source control命令将新建的文件直接放入受控库，不需再使用checkin命令。6.3 checkout和checkoutnow命令准备对选定文件进行编辑状态，其中checkout可以查看您正在提交的所有任务，目前的状态以及错误信息，如果您不想查看这些信息，可直接点击checkoutnow，这个操作将缺省检出最新版本。6.4 checkin检入文件文件修改后，使用checkin命令将文件提交到Firefly存储库。每个文件都能单独checkin到Firefly存储库。但如果所修改的多个文件有相关性，可以将多个相关的文件一起checkin到存储库，这样这一组文件作为一个变更集提交到Firefly 存储库保存，并且能够在Firefly WEB中的分支历史中查到6.5 文件的删除、移动和重命名分别使用Firefly菜单中的remove、move和rename命令对文件进行删除、移动和重命名操作，使得所有的操作都是在Firefly控制下进行。不要使用wsad中命令进行这些操作。在firefly中，移动和重命名将不简单的被看作删除和新建的组合，从而避免了历史版本的丢失。Firefly完整的保存了一个文件的历史，即使这个文件被移动到其他目录下（移动本身也会成为一个版本保留下来），6.6 Rollback（回滚）命令文件如果需要从某个历史版本重新修改，使用Rollback命令。Rollback命令将建立一个新版本，这个新版本的内容与我们想要到历史版本内容相同。即版本增加，但内容不变。6.6.1 Undelete命令如果文件remove操作后，及删除此文件后，可以使用undelete命令找回文件。Firefly对受控文件不作物理删除，所有remove操作的文件都可以使用undelete命令找回。6.6.2 History命令能够列出文件所有历史版本，并可以选择任意两个版本进行比较，选择HIistory命令后，选中两个版本，单击右键，出现compare，即可对两个版本进行比较，Firefly会自动列出两个版本不一样的地方。注：如果执行History命令列出的版本号出现重名，比如两个1.3版本，这是eclipse显示问题，实际上应该显示1.3.1和1.3.2。出现这种情况时，可以使用Firefly Client或Firefly Web上查看文件版本历史。6.6.3 文件版本合并当两个开发人员同时checkout一个文件进行修改，这时就处于并发开发状态，第一个开发人员checkin后，第二个开发人员checkin时出现冲突，Firefly会自动打开冲突解决窗口，让开发人员合并文件内容。7 Firefly Client的使用7.1 组织工作区在工作区-组织工作区中删除、卸载和加载工作区。对于不再使用的工作区，应该在这里删除，而不是在资源管理器中直接删除工作区目录。如果已经在资源管理器中删除了工作区的目录，使用卸载命令可删除在Firefly Client中的链接。7.2 脱机工作模式在工具选项当前工作区设置中，选择“脱机”复选框，Firefly进入“脱机工作”模式。当网络出现故障，不能连接服务器时，可采用“脱机工作”模式。Firefly在离线状态下仍然能够允许开发人员进行版本管理。当网络故障修复后，再采用“联机工作”模式，重新连接服务器，并将脱机工作状态下的所有文件历史全部提交到Firefly存储库中。7.3 文件状态当firefly用户（包括当前用户和其他用户）对文件进行操作时，文件的状态会发生变化，firefly在文件列表栏中以不同的标识代表不同的状态，如图所示。7.4 过滤文件一些中间过程产生的文件或者临时文件，是不应该作为配置项入库的，比如.class文件和.tmp文件。可以通过在Firefly client端设置来自动过滤，避免这种情况的发生，方法如下：（1） 进入Firefly client，点击菜单工具选项（2） 选择“文件操作”选项卡，在“文件过滤器”中添加希望过滤掉不入库的文件类型，同时要选择“缺省使用文件过滤器”选项，点“确定”，完成过滤文件的设置。7.5 其他命令Firefly Client工具提供了更加丰富的命令管理文件版本。例如，找回丢失文件、列出非法修改文件、提供文件版本数、建立变更集等操作，具体使用方法请参考Firefly Users Guide。7.6 Firef