开源项目源码集成,巧用 Git 实现自动升级,并合并您自己的修改

前言:

        当我们开发项目时因为需求的原因,需要引入第三方SDK,为了让开发者快速集成第三方会提供相关的接入Demo,有时会提供一套基于SDK实现的拥有常用功能的UI层组件。为了方便很多开发者也都会选择UI组件集成。不过由于UI组件的局限性,不能满足开发者的所有需求,所以就需要源码集成。我们需要根据自己的业务需求修改UI组件源码来实现自己想要的功能。说到这里相信大家已经想到了一个问题。当我们基于UI组件源码集成并修改了大量的代码后,此时如果UI组件本身存在Bug时。这里我们就有两种处理方案:

1. 自己找出Bug原因并修改(需要深入了解组件实现代码逻辑,处理问题耗时久)

2. 给官方提Bug单,让官方专业人士处理(重新引入TUIKit源码,解决效率快)

为了省事儿,很多人会选择第二种方案包括我。当官方给出新的UI组件后我们替换新的就好。不过由于之前改动过大量的UI组件源码,直接替换组件然后再针对修改的地方再次修改这个也相当耗时也没必要,所以为了解决这个问题,就引出这篇文档。

(1)入门篇:github上fork 别人的项目,源项目更新后怎么同步更新自己的fork

(2)进阶篇:github上fork别人的项目后,怎么进行代码贡献

(3)完结篇:开源项目源码集成,巧用 Git 实现自动升级,并合并您自己的修改

下面是实现自动升级组件源码并保存自己修改的代码方案


    适读范围:源码集成 TUIKit 且做了二次开发,并需要升级 TUIKit 的同学

1.目标: 通过 git merge 命令来大幅降低人工合并代码的工作量。

2.注意: 在集成 TUIKit 时尽量不要修改目录或者大量重命名类,这可能会造成 git merge 时冲突较多。

3.核心思想: 修改后的 TUIKit 源码作为新分支,合并官网主线分支。

主要步骤(本文以“腾讯IM Demo”为例)

    1、记录上次集成的 TIMSDK 工程的 commit ID,比如 commit1

        1.1 选择上次集成的版本号

        1.2 查看对应版本commit ID并记录

    2、下载或者更新最新的 TIMSDK到本地

        git clone https://github.com/tencentyun/TIMSDK.git

    3、基于 master 新建分支 mix:

git checkout -b mix remotes/origin/master

   4、恢复 mix 分支到    步骤一  的 commit1 (也就是恢复到你集成的)

git reset --hard commit1

   5、复制自己应用工程里面二次开发后的代码,覆盖到 TIMSDK 的相应位置,比如您是基于 ./TIMSDK/Android/tuikit 修改的,就把修改后的代码覆盖到此处。

  6、将代码提交到本地,生成 commit2。(此时新分支 mix 作成)

1. git add .

2. git commit -m 'first update'

   7、合并分支 master 到 mix

git merge master

8、 合并官网最新代码。可能会存在上图提示的冲突代码,需要手动解决一下。这里有解决冲突的一些方法。

9、最后把合并后的代码覆盖到您项目里,完成。


10、可以用下面图例来简单表示整个操作

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 223,858评论 6 521
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 95,753评论 3 402
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 170,876评论 0 366
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 60,560评论 1 300
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 69,574评论 6 399
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 53,097评论 1 314
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 41,477评论 3 427
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 40,452评论 0 278
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,980评论 1 324
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 39,017评论 3 343
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 41,168评论 1 354
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 36,807评论 5 350
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 42,497评论 3 336
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,976评论 0 25
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 34,094评论 1 275
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 49,659评论 3 380
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 46,196评论 2 363

推荐阅读更多精彩内容