使用方法

ginskeleton 不是市面上的框架,框架一般来说不会集成任何业务模块,只有最通用的功能,因此框架版本不发生大版本变化时,升级很随意。

ginskeleton 是一款项目骨架,你也可以理解为一款项目模板(纯净版),本身已经集成一个项目所必须的业务模块,例如:tb_userstoken相关的功能模块。

因此使用本项目骨架时只要保证项目开发时使用的 ginskeleton是最新版本即可,你可以自行扩展、更新已经集成的相关东西,例如:依赖包版本,默认集成的业务代码你都可以更新、改造。

项目骨架本身会伴随着项目的开发不断完善,并不是新版本的所有功能都必须更新到已经在开发的项目中,我们也不建议对已经在使用中的项目骨架更新版本。

一旦项目进入开发阶段,您只需要更新已集成的依赖包(go.mod文件中时所有的依赖包清单),或者安装您业务需要的其他包来解决项目问题即可。

ginskeleton 的更新以生产环境项目需求为驱动,是我们开发实际业务时,将遇到的问题、可以优化的地方总结、归纳、整理后合并到主线版本的结果。

您在使用 ginskeleton 时也欢迎将遇到的问题、或者需要优化的地方通过 issue 向我们反馈,以便下个版本又能更好地为大家服务。

问题反馈

1.提交问题请在项目顶栏的issue直接添加问题,基本上都是每天处理当天上报的问题。

2.本项目优先关注 Gitee Issue 仓库的所有问题, github 太卡严重影响效率。

3.qq群也欢迎大家加入讨论与交流:273078549。

如何在使用过程保持最新版

目前 ginskeleton 已经持续更新2年多了,所有的功能基本成型、固定,我们后续更新的方向是不断打磨细节,完善基础功能,不会大面积做改动,因此是可以做到在项目开发中一直使用最新版本的,但是我们不推荐对于已经开发、测试结束的项目进行骨架本身,

对于熟练使用 git以及goland(jetbrains系列)的开发者而言,通过设置即可实现。

  1. #注意:master 分支不要做业务开发,业务代码编写在 dev 等分支即可.
  2. #克隆本项目 master 分支
  3. git clone https://gitee.com/daitougege/GinSkeleton
  4. # 在 goland 自带的 git 菜单,远程管理,设置多个远程仓库地址,将自己公司的 git 仓库地址添加进去
  5. # 基于 master 分支在本地创建一个dev分支,dev分支就是你自己扩展业务的分支。
  6. # 如果 ginskeleton 官方仓库有更新,那么您首先将官方仓库的 master更新到本地,然后合并到 dev 即可。
  7. #经过以上设置您的master 分支就是 ginskeleton 的 master 分支
  8. #dev 分支是实际业务分支,向自己公司仓库提交代码只需要将 dev 分支提交到公司git仓库远程地址即可

以上方案的缺点就是一个项目存在多个远程地址,开发者提交项目时需要选择,但是您放心,您的代码不可能提交到 ginskeletonmaster分支的,如果不小心提交了,也只会失败。