Upsource(代码审查工具) v2018.2官方版 附使用教程

Upsource是一款专业的代码审查工具，可对多种类型的代码库和软件开发语言进行代码浏览、变更差异比较、分支与合并等操作，支持对同一代码库的多个修订版本浏览。具有很强的扩展性，可容纳数百个项目。有需要的开发人员可以下载！

软件功能

1、自动代码审查

无论您的团队多么大或小，都可享受一个轻量级的工作流程，用于提交后审查，拉取请求和分支审查。设置触发器来自动创建代码评论，并根据许多标准分配评论者。

2、存储库浏览和搜索

享受统一访问您所有的Git，Mercurial，Perforce或Subversion项目。使用我们强大的搜索引擎，快速找到您要查找的内容。

3、集成

查看Upsource中的GitHub pull请求和GitLab合并请求。将Upsource与JIRA和YouTrack等常见问题跟踪器以及持续集成服务器相集成。

4、代码洞察

Upsource为数十种语言提供了语法高亮显示，但是使用Java，Kotlin，PHP，JavaScript和Python的团队还可以获得额外的优势。Upsource拥有IntelliJ IDEA核心，拥有对这些语言的深入了解，并提供服务器端静态代码分析，代码感知导航以及搜索用法。

5、数据驱动的 项目分析

Upsource收集VCS使用情况和代码审查统计信息，并提供大量报告，以便全面了解项目中发生的情况。

6、安全

利用高级用户管理，粒度和每项目权限以及多个身份验证模块。

7、团队协作

参与讨论，提名其他用户，并通过网址分享所有内容，包括代码，修订版，差异，代码评论，搜索过滤器，文件甚至代码选择。在使用Upsource时使用反应并解锁成就!

8、IDE插件

为IntelliJ IDEA和其他JetBrains IDE安装代码审查插件，并参与代码讨论，并从您的IDE中舒适地管理代码评论。

9、可扩展性

Upsource提供了一个分布式集群设置，可以容纳数百个项目，为成千上万的用户提供服务，并确保全天候可用性和容错性。

软件特点

1、执行高效的代码审查

2、从 IDE 审阅

3、通过浏览器跟踪重要的变化

4、发现设计缺陷, 找出项目中需要开发人员注意的部分

5、检测项目范围的风险, 分散责任

6、快速面板, 便于新成员了解项目并了解其他人的职责范围

7、@回应, 讨论变化, 帮助队友

8、可与持续交付/问题跟踪/github同步

Upsource2018安装教程

Win下启动安装配置

Upsource对比较耗内存，建议机器内存在4G以上

在Windows环境，为了避免碰到各种奇奇怪怪的问题，最好关闭所有杀毒软件

Upsource两种启动方式：作为后台进程进行启动、作为Windows Service安装

1.运行Upsource作为后台进程进行安装

以管理员身份运行 打开cmd，切换到目录，执行命令

upsource_home\bin\upsource.bat start

2.运行Upsource安装为Windows Service

upsource_home\bin\upsource.bat service install /runAsSystem

启动完成后会打开默认浏览器网址 http://机器名:80/welcome 页面，注意在3.5版本中windows默认端口为80，在以前的版本端口默认是8080。这是你会看到如下页面：

点击 Set up 进行安装，这时我们可以修改访问域名和端口

点击 Next 进入用户管理，设置管理员用户名密码

点击 Next ，这里会提示免费版支持10个免费用户，如果你有License Key的话，在这里可以输入。

点击 Finish ，静候安装

启动完成后，会默认打开欢迎页面，到这步安装大功告成。

Upsource使用教程

创建/管理项目

使用admin账户登录，点击 Create Project 创建项目

点击 Create project 完成项目创建，接下来就等待代码clone完成。

设置用户/组/角色权限

代码下载完成之后，就开始设置用户权限

点击 Users 进行用户/组/角色权限设置，Upsource安装完成之后默认添加了admin和guest用户。

设置用户时可以指定用户组，每个项目有三个用户组，分别为 Code Viewers 、 Developers 、 Project Admin 。同一个用户可以拥有多个用户组。

角色权限可以设置全局角色和对应某个项目的角色，总共有五种，分别是： Code Viewer 、 Developer 、 Observer 、Project Admin 、 System Admin ，每个角色所拥有的权限都可以根据自己需求灵活进行配置

这里我们为 cms 项目添加两个用户： Lucy 为 Project Admin 角色， tom 为 Developer 角色

代码审查(Code Review)

Upsource能为代码审查提供哪些便利

对多种类型的代码库与软件开发语言进行代码浏览

对同一个代码库的多个修订版本进行浏览，并且通过一个图形化工具显示多个修订版本之间的关系

对代码变更进行跟踪，包括提交历史、变更差异比较，以及分支与合并的操作

对团队的代码进行审查，包括代码的讨论、跟踪代码评论以及最终的结论

如何进行代码审查

当开发者 tom 提交完代码之后，项目管理员 Lucy 登录到Upsource，可以看到所有项目的索引，每个项目都有对应一个特定的VCS仓库。

单击项目名称列出每一次提交的版本，每一次提交的代码罗列，这里你可以浏览代码，创建代码审核，分支列表，分支与分支代码比较，代码提交代码审核分析(可视化图表)……等等你想要的功能。

拖动滚动条，将光标移动到需要进行审核的修订版本上，点击 Create review 创建一次新的代码审查

代码对比

点击左边修订版中提交的文件名显示嵌入差异：

点击 Side-by-side diff 可以查看整个文件在提交前后的变化

关于代码评论

无论你是作为一个 author 、 reviewer 或 watcher ，你都可以发表评论，发表的评论所有参与的人都可以看得见

有三种类型的评论：

审查意见：这种类型的评论是不是捆绑到任何代码特定文件或部分。

行级评论：这种类型的注释与特定的代码行相关联。

代码块评论：这种类型的评论是为了找出一个特定的代码片段中的一个文件进行审查。

行级评论

代码块评论

参与评论

Lucy 进行评论后，开发者 tom 会收到邮件通知，登录 tom 账户，可以清晰的看到 Lucy 的评论的代码，可以进行回复。

当点击 Accept 时，表示接受此次修订，此次审查被视为完成。

Upsource分析功能

Upsource提供了例如代码提交分析、代码审查分析等功能。

其他

JetBrains提供的Upsource授权计划是根据用户的数量所决定的，不超过10人(去掉admin、guest其实就只有8个用户)的团队可以免费使用。同样，教育机构及非盈利的开源项目也可以免费使用。