使用JF代码库进行项目代码管理

Size: px

Start display at page:

Download "使用JF代码库进行项目代码管理"

皮肃居
4 years ago
Views:

1 项目经理创建配置管理 JF 项目代码库 1 使用 JF 代码库进行项目代码管理 1) 创建项目 JF 代码库是基于项目管理的, 要使用代码库, 首先要在 Jointforce 中创建项目 ( 如果已经有创建好的项目, 可以跳过此步骤 ): 2) 创建仓库创建完项目, 进入创建的项目并选择代码库, 进行代码库管理 JF 代码库中, 每个项目可以创建多个代码仓库 :

2 代码仓库 : 分为项目自用仓库, 用于项目组自己用的仓库 ; 项目众包仓库, 用于保存项目发包时, 用于保存接包人提交项目成果的仓库, 发包签单时自动创建 3) 代码仓库授权管理代码库创建后, 项目经理默认为管理员身份, 需要给其他需要访问代码库的项目成员或者团队管理者分配正确的权限

3 JF 代码库提供了三种不同的访问权限, 如下表所示 : 操作权限仅 Web 端浏览文件可修改提交管理员通过网页浏览文件获得项目代码 (Pull project code) 下载项目 (Download project) 创建代码片断 (Create code snippets) 创建新合并请求 (Create new merge request) 创建分支 (Create new branches) 提交到非保护分支 (Push to non-protected branches) 移除非保护分支 (Remove non-protected branches) 添加标签 (Add tags) 提交到保护分支 (Push to protected branches) 设置分支保护 (Enable/Disable branch protection) 修改 / 移除标签 (Rewrite/remove git tags) 由于管理员权限较高, 建议只授给项目经理或技术经理 ; 4) 分支保护

4 分支保护可以保护您的分支代码避免被破坏, 当分支启用保护时具有以下特性 : 1) 禁止成员往该分支提交 ( 管理员除外 ) 2) 禁止成员删除分支 ( 管理员除外 ) 5) 代码提交记录项目管理者通过代码提交视图可以查看所有代码库全部分支下各项目成员的代码提交情况的动态信息, 且可以分别查看指定仓库或分支的代码提交情况同时, 项目成员也可以通过该视图了解自己所在项目的代码提交动态信息 6) 代码统计

5 可以查看本项目全部或分库的每日代码变化情况 : 每日增加了多少, 减少了多少 7) 代码贡献可以查看项目组成员每日的代码提交变化情况 : 点击每个成员, 可以查看该成员在本团队所有项目的代码提交变化情况 :

6 2 Git 客户端 SourceTree 的安装及配置要使用 JF 代码库, 需要做一些准备工作首先是需要下载安装 Git 客户端工具, 才可以向 JF 代码库提交代码 SourceTree 是 Windows 和 Mac OS X 下免费的 Git 客户端支持创建克隆提交 push pull 和合并等操作 1) 安装介质下载通过以下地址下载 jointforce 提供的 SourceTree 安装介质点击这里下载 :JF 代码库客户端解压压缩包文件, 包括以下安装文件及注册文件 : Windows 版本安装介质 Git preview exe SourceTreeSetup_ exe NetFramework4.5.1-KB x86-x64-AllOS-ENU.exe SourceTree 注册文件

7 2) 安装 windows 版 Git 双击 Git preview exe, 开始安装 : 点击 next,

8 继续 next, 选择安装目录, 使用默认目录即可 : 继续 next, 安装选项, 采用默认即可

9 继续 next, 默认继续 next, 命令行环境变量设置, 默认即可

10 继续 next, 默认即可继续 next, 开始安装程序

11 安装完成下面继续安装 SourceTree 3)SourceTree 安装 SourceTree 是 Git 图形化客户端, 使用 SourceTree 可以直接操作 Git, 满足开发人员的日常代码拉取提交工作双击 SourceTreeSetup_ exe, 开始安装

12 点击 next, 由于 SourceTree 安装需要.Net Framework4.5 或以上版本, 如果你的机器没有安装.Net Framework4.5 或以上版本, 出现下面这两个对话框时, 点击 Cancel 取消按钮, 先安装下载文件夹中的 : NetFramework4.5.1-KB x86-x64-AllOS-ENU.exe, 安装好 net 环境, 从头重新开始安装 SourceTree:

14 如果你的机器已经安装好 net 环境, 不会出现上面两个对话框, 点击 next, 选择安装目录, 使用默认目录即可 : 继续 next, 准备好安装

15 点击 Install, 开始安装程序选中 Launch SourceTree, 点击 Finish, 需要同意许可协议

16 选中我同意许可协议, 点击继续会弹出正在下载版本控制系统对话框, 这是下载 SourceTree 默认内置的 git, 需要连接官网下载, 不用理会它, 直接关闭即可因为前面已经安装过了 git 如果网络不通畅, 也可能会出现下面的对话框, 都直接关闭即可

17 然后会问是否加载 SSH 密钥, 这里选择 No 要选择 Mercurial, 选择最后一个选项我不想使用 Mercurial 到这,SourceTree 安装完成, 打开了一个 SourceTree 实例

18 接下来, 要注册 SourceTree 4)SourceTree 注册 SourceTree 是一个免费工具, 但是需要到官网注册才能正常使用,jointforce 为大家注册了一个公共的 license 证书, 只需要在安装完后导入注册文件即可完成注册 (1) 点击文件菜单, 选择注册 (2) 选择导入产品证书

19 2) 选择证书文件并点击打开按钮 3) 注册成功的界面 : 点击关闭, 完成 SourceTree 注册

20 5) 配置 SourceTree 默认的用户信息这里配置的用户信息比较重要,Jointforce 将会用这个用户信息记录你每天提交的代码, 作为你每天的工作成果记录, 如果信息不正确, 你的工作成果可能会遗失选择工具菜单, 点击选项弹出选项对话框, 填写全名 : 对应 Jointforce 中的用户 ID 电子邮件地址 : 对应 Jointforce 中的邮箱这两个信息可以在代码库管理界面获得 :

21 点击确定, 完成配置 2 使用 Git 客户端 SourceTree 进行日常工作 1) 项目仓库克隆

22 打开 SourceTree, 点击克隆 / 新建, 弹出如下界面 : 仓库地址获得登录 jointforce, 进入项目复制仓库地址 : 将该地址复制到下面框中, 如果是第一次克隆 jointforce 上面的仓库, 将会弹出用户认证对话框要求认证,, 在这里输入 jointforce 用户 ID 和密码 ( 用户 ID 与上面配置的一样 ):

23 当下图红色框所标志区域正常, 说明该用户正确点击克隆, 完成代码库的克隆, 可以用开发工具导入克隆下来的项目导入工程从仓库上成功克隆项目后, 找到项目所在目录, 将项目导入到开发工具中 (Eclipse), 即可开始在开发工具中进行开发工作了 SourceTree 将会自动监控项目所在的目录, 如果在开发工具中对代码进行了修改,SourceTree 将会自动检测到变化, 切换到 SourceTree 界面, 可以进行代码的更新提交 :

24 : 2) 代码拉取提交操作拉取代码在开发新的功能之前, 需要通过拉取操作将本地库与远程库文件进行同步, 更新到最新的状态, 这样能够减少或者避免在后续的提交代码过程中由于多人修改同一文件造成的冲突, 同时也能够培养一个良好的代码开发习惯点击工具栏的拉取 /Pull, 勾选中第一个选项, 如下图, 将远程代码库的最新提交记录更新同步到本地代码库, 如下图所示提交代码

当我们在本地进行开发完成新的代码, 可能会有新增的内容, 或者修改的内容, 都需要先提交到本地仓库这样, 即使在与远程仓库无法连接 ( 比如网络中断 ) 的情况下也仍然可以在本地环境继续提交代码, 待网络环境恢复正常的时候再将本地的所有提交记录进行同步更新到远程服务器, 这是其它的 SVN CVS 等代码管理工具所不具备的

25 当我们在本地进行开发完成新的代码, 可能会有新增的内容, 或者修改的内容, 都需要先提交到本地仓库这样, 即使在与远程仓库无法连接 ( 比如网络中断 ) 的情况下也仍然可以在本地环境继续提交代码, 待网络环境恢复正常的时候再将本地的所有提交记录进行同步更新到远程服务器, 这是其它的 SVN CVS 等代码管理工具所不具备的在工作副本 /Working Copy 中, 将需要提交的文件 ( 包括新增的和修改的 ) 加入到本地仓库的暂存区 ( 这是提交到本地仓库的一个临时存储 /Stage 区域 ), 点击提交提交 /commit, 如下图所示 : 在提交对话框中填写好本次提交的备注描述 /Commit message, 点击提交 /Commit

拉取远程最新更新合并提交的代码在代码提交到本地仓库之后, 通常需要再次拉取一下, 将远程仓库最新的内容同步到本地仓库, 在本地与提交到暂存区的文件内容进行对比 ( 注意 Git 是在本地仓库进行提交内容的对比, 和 SVN 等工具的与远程仓库直接对比是不同的 ), 系统默认会对有冲突的内容 ( 通常是有人同时修改了同一段代码 )

26 拉取远程最新更新合并提交的代码在代码提交到本地仓库之后, 通常需要再次拉取一下, 将远程仓库最新的内容同步到本地仓库, 在本地与提交到暂存区的文件内容进行对比 ( 注意 Git 是在本地仓库进行提交内容的对比, 和 SVN 等工具的与远程仓库直接对比是不同的 ), 系统默认会对有冲突的内容 ( 通常是有人同时修改了同一段代码 ) 进行提示, 这时候需要对提示冲突的内容进行对比修改, 只有在完成对所有的冲突处理后才能进行代码合并在没有提交代码冲突的情况下, 系统会对暂存区的提交内容和远程仓库的更新内容进行自动合并处理, 并且需要提交到本地仓库推送在本地仓库进行的提交需要推送到远程仓库, 才能被其它开发者获取点击工具栏上的推送 /Push, 点击确认 /OK

标签管理同 CVS SVN 一样,Git 也可以对某一时间点上的版本打上标签通常在发布某个软件版本 ( 比如 v1.

27 标签管理同 CVS SVN 一样,Git 也可以对某一时间点上的版本打上标签通常在发布某个软件版本 ( 比如 v 等等 ) 的时候需要在分支上打一个标签使用 SourceTree 创建标签的方法 : 点击工具栏上的标签 /Tag 按扭, 弹出标签管理对话框, 输入标签名称如 v , 通常是设置一个软件版本的发布号 ; 您可以选择以下 2 种方式来在选择在不同的提交记录上创建标签 : 方式一 : 选择当前工作分支 /Working copy parent, 默认是在当前分支的最新提交记录上创建标签 ; 勾选自动推送 /Push tag, 添加完标签后将自动推送到远程代码仓库 ; 方式二 : 选择指定提交 /Specified commit, 是在指定的某一历史提交记录上创建标签 ; 勾选自动推送 /Push tag, 添加完标签后将自动推送到远程代码仓库 ;

一登录 crm Mobile 系统 : 输入 ShijiCare 用户名和密码, 登录系统, 如图所示 : 第 2 页共 32 页

一登录 crm Mobile 系统 : 输入 ShijiCare 用户名和密码, 登录系统, 如图所示 : 第 2 页共 32 页第 1 页共 32 页 crm Mobile V1.0 for IOS 用户手册一登录 crm Mobile 系统 : 输入 ShijiCare 用户名和密码, 登录系统, 如图所示 : 第 2 页共 32 页二 crm Mobile 界面介绍 : 第 3 页共 32 页三新建 (New) 功能使用说明 1 选择产品第 4 页共 32 页 2 填写问题的简要描述和详细描述第 5 页共