mirror of https://gitee.com/cxasm/notepad--.git
patchs-doc: 增加补丁操作说明文档
This commit is contained in:
parent
692b29d9e0
commit
ed5adfc592
patchs
|
@ -0,0 +1,56 @@
|
|||
# 补丁操作说明
|
||||
|
||||
> 用于 patchs/coconil-cmake-spark-deb-appimage.patch 补丁化构建方式
|
||||
|
||||
- 如何使用此补丁(测试本补丁)
|
||||
|
||||
> 注:此补丁仅可基于 master 分支进行构建
|
||||
|
||||
1. 在项目中使用此补丁?
|
||||
```shell
|
||||
git am --whitespace=fix < patchs/coconil-cmake-spark-deb-appimage.patch
|
||||
```
|
||||
2. 使用在线的方式直接使用补丁文件,并对纯净的 ndd 项目进行打补丁
|
||||
```
|
||||
# 克隆 notepad-- 项目
|
||||
git clone https://gitee.com/cxasm/notepad--
|
||||
cd notepad--
|
||||
|
||||
# 打在线补丁
|
||||
curl -s https://gitee.com/zinface/coconil-notepad--/raw/cmake-patchs/patchs/coconil-cmake-spark-deb-appimage.patch | git am --whitespace=fix
|
||||
|
||||
make package # 构建 release 模式的 deb 包
|
||||
make linuxdeploy # 构建出相关文件与自动组织 appimage 的结构目录
|
||||
make genrate-appimage # 基于已 linuxdeploy 的结构目录进行打包为 Appimage
|
||||
```
|
||||
|
||||
|
||||
- 在应用补丁时,并对补丁进行的更新操作
|
||||
|
||||
```shell
|
||||
# 切换到一个新的分支,即可开始进行补丁内的更新提交
|
||||
git checkout -b coconil-cmake-spark-deb-appimage
|
||||
|
||||
# origin/dev 表示本仓库的 dev 开发分支
|
||||
# 在应用过补丁,并产生了新的提交,即可在当前所在补丁更新分支内
|
||||
# 相对基于 origin/master 为参考,目前所包含的所有最新提交内容将生成为一个补丁文件(其中尾部为增量更新)
|
||||
git format-patch --stdout origin/master > patchs/coconil-cmake-spark-deb-appimage.patch
|
||||
|
||||
# 最后,回到你的原 master 分支,将被改变的补丁文件进行提交
|
||||
# 在推送完成后,即可放弃你在 coconil-cmake-spark-deb-appimage 分支中所有产生的内容(因为都已经进入补丁)
|
||||
```
|
||||
|
||||
- 一些注意事项
|
||||
|
||||
```shell
|
||||
# 在不了解补丁时,你需要认识一下补丁,但补丁与补丁之间有着不同的用法
|
||||
# 本 patchs/coconil-cmake-spark-deb-appimage.patch 补丁为支持 Appimage 构建
|
||||
|
||||
# 关于补丁的一些方面
|
||||
# 1. 首先你需要了解 git 是什么,以及简单的使用
|
||||
# 2. 你需要了解补丁是什么,以及简单的使用(应用补丁)
|
||||
# 3. 你需要了解如何创建一个补丁,最基本的就是相对于旧目标分支,将本分区新增的提交进行导出为补丁
|
||||
# 4. 你可能只会将单个提交、或多个提交导出为补丁,但这还不够,你需要具有绝对的对于补丁的理解
|
||||
# 5. 对于不同的目的补丁,应该是多个 patch 文件存在的形式
|
||||
# 6. 最后,不管在什么时候,你在应用补丁前,你应该考虑是否应用到当前分支?为什么不切换到一个新的分支呢?
|
||||
```
|
Loading…
Reference in New Issue