通常 Push 代码到远程托管平台（GitHub，Gitlab，Gitee 等），需要提前在托管平台上传我们 Git 账户的公钥（*.pub），平台使用上传的公钥来验证身份（本地的 Git 私钥与平台上的公钥配对，以确保你有权限读写该仓库），该验证只会在 Push 时进行检查

为什么要签名

虽然对 Push 做了检查，但依然不够安全，因为任何拥有该仓库权限的人，都可以在 commit/tag 时使用 git config user.name "假的用户名", git config user.email "假的邮箱地址" 命令来伪造提交者用户信息，这样我们根本无法追溯提交者的身份，所以我们需要给 commit/tag 签名，签名的目的是确保提交的代码在传输和存储过程中没有被篡改，并验证提交者的身份，同时也保证代码的可追溯性

commit 签名是在本地，在使用 git commit 命令时进行签名，push 时会将你的签名信息，原封不动 push 到远程仓库

commit 签名只是用于验证这条 commit 来自于你本人，与是否有权限操作远程仓库无关

如何签名

可以使用 GPG、SSH 或 S/MIME，可以在本地对 commit/tag 进行签名。 这些 commit/tag 在 GitHub 上标示为已验证，便于其他人信任更改来自可信的来源

SSH、GPG、S/MIME 区别

• SSH 签名是最容易生成的，甚至可以将现有身份验证密钥上传到 GitHub 以用作签名密钥
• 生成 GPG 签名比生成 SSH 密钥复杂，但 GPG 具有 SSH 没有的功能，GPG 密钥可以在不使用时过期或撤销
• 较大型组织的环境中通常需要 S/MIME 签名

👍 SSH（常用）

SSH 签名验证需 Git 2.3.4 及以上版本

检查现有 SSH 密钥

1
2
3

# 查看本地 ~/.ssh 路径现有密钥
ls -al ~/.ssh
# 检查输出的列表

检查已有密钥列表已有 RSA 密钥，如果你已经有 SHA-2 算法生成 RSA 密钥 那么你可以 跳过 生产新 SSH 密钥，如果没有，为了安全，还是建议重新生成 SHA-2 算法生成 RSA 密钥

生产新 SSH 密钥

在生成 SSH 密钥时，我们可以给 SSH 密钥添加密码，也可以不添加密码，这里根据需要选择是否添加密码

1. 执行 ssh-keygen -t ed25519 -C "Jerry.x@outlook.com" 命令，这里的邮箱换成你的 GitHub 邮箱
2. 确认密钥存放位置
   • 如果不需调整（默认：/User/blade/.ssh/id_ed25519），可 Enter 键进入下一步
   • 这里我重命名了密钥 /User/blade/.ssh/id_ed25519_test
3. 给密钥设置密码
   • 如果无需设置，可 Enter 键进入下一步
   • 如果需设置，输入密码即可
4. 确认输入的密钥密码，和上一步输入内容一致
5. 提示生成的密钥存放位置和指纹信息

除了上述的方式生成密钥，还有 为硬件安全密钥生成新的 SSH 密钥 方式，这里不做说明，可以移步官方文档查看

将 SSH 密钥添加到 GitHub 账户

其他更多设置可参考官方文档 新增 SSH 密钥到 GitHub 帐户

将签名密钥告诉 Git

1
2
3
4
5
6
7
8
9

# 1. 配置 Git 使用 SSH 对提交和标记签名
git config gpg.format ssh
# 2. 配置指定 SSH 签名密钥
#    将 ~/.ssh/id_ed25519 替换为要使用的公钥路径
git config user.signingkey ~/.ssh/id_ed25519.pub
# commit 开启自动签名
git config commit.gpgsign true
# tag 开启自动签名
git config tag.gpgsign true

配置可信公钥列表

1
2
3
4
5
6
7

mkdir -p ~/.config/git
touch ~/.config/git/allowed_signers
# 将指定的密钥文件（~/.ssh/id_ed25519）内容复制到 allowed_signers 文件中
# 如果是继续追加, 将 > 替换为 >>
cat ~/.ssh/id_ed25519.pub > ~/.config/git/allowed_signers
# 配置可信公钥
git config gpg.ssh.allowedSignersFile "~/.config/git/allowed_signers"

对 commit 签名

1
2
3
4

# 1. 当本地分支中的提交更改时，请将 -S 标志添加到 git commit 命令
git commit -S -m "YOUR_COMMIT_MESSAGE"
# 2. 在本地完成创建提交后，将其推送到 GitHub 上的远程仓库
git push

对 tag 签名

注意：如果 Git 客户端配置为默认对提交进行签名，GitHub Desktop 仅支持提交签名

1
2
3
4

# 1. 若要对标记进行签名，请将 -s 添加到 git tag 命令
git tag -s MYTAG
# 2. 通过运行 git tag -v [tag-name] 验证已签名的标记
git tag -v MYTAG

GPG

具体实践可参考官方文档 GPG 提交签名验证

S/MIME

S/MIME 签名验证需 Git 2.19 及以上版本

由于 S/MIME 用的比较少，这里就不做具体的演示，可参考 官方文档

验证签名

1
2
3
4

# 查看一下本地签名信息
# 正常情况，在 commit 提交号下
# good "git" signature for $(email) with $(publicKey)
git log --show-signature

问题

验证签名提示异常

如何给现有密钥更新密码

通过输入以下命令，您可以 更改 现有私钥 的密码而无需重新生成密钥对

1
2
3
4
5
6
7

# 修改 id_ed25519 密钥密码
$ ssh-keygen -p -f ~/.ssh/id_ed25519
> Enter old passphrase: [Type old passphrase]
> Key has comment 'your_email@example.com'
> Enter new passphrase (empty for no passphrase): [Type new passphrase]
> Enter same passphrase again: [Repeat the new passphrase]
> Your identification has been saved with the new passphrase.

参考

1. Git 提交使用 SSH 签名和 GPG 签名验证
2. SSH 提交签名验证
3. GitHub commit 签名指南
4. 维护代码的尊严：GPG签名让你的Git commit不再裸奔

话说，国内的网络环境真的是一言难尽，不得不说在技术、技术基础设施、技术思想等发展道路上任重道远

对于个人几个主要的站点，规划如下

1. incoder.org: 作为分享生活、感悟、个人状态为主的地方，偶尔汇总某些技术等的综合性文章
2. backend.incoder.org: 记录以 Java 为基础的后端开发生态技术领域
3. mobile.incoder.org: 记录以原生开发为基础的移动端开发生态技术
4. incoder.app: 记录个人开源应用

VPN

虚拟专用网络（Virtual Private Network，缩写：VPN）是常用于连接中，大型企业或团体间私人网络的通讯方法。它利用隧道协议（Tunneling Protocol）来达到发送端认证，消息保密与准确性等功能。

VPN 只是一个统称，它有多种具体实现。比如：

• PPTP（点对点隧道协议：Point to Point Tunneling Protocol）;
• L2TP（第二层隧道协议：Layer Two Tunneling Protocol）;
• IPsec（互联网安全协议：Internet Protocol Security）;
• WireGuard（一种协议）;
• OpenVPN（一种虚拟专用网络 Virtual Private Network（VPN）系统）;
• IKEv2（因特网密钥交换：Internet Key Exchange） 等

WireGuard

WireGuard 是由 Jason A. Donenfeld 开发，是最新的协议实现（在 2020 年，WireGuard 协议已被添加到 Linux 和 Android 内核中，从而为 VPN 提供商所采用。默认情况下，WireGuard 使用 Curve25519 进行秘钥交换，并使用 ChaCha20 进行加密，但还具有客户端和服务器之间预共享对称秘钥的功能）

OpenVPN

OpenVPN 是由 James Yonan 编写，实现了在路由或桥接配置和远程访问设施中创建安全点对点或站点对站点连接的技术。它实现了客户端和服务器应用程序。它不与IPsec兼容

OpenVPN 允许对等方使用预先共享的密钥、证书或用户名/密码相互验证。当在多客户端服务器配置中使用时，它允许服务器使用签名和证书颁发机构为每个客户端发布身份验证证书。

SS

SS 是 Shadowsocks 的缩写，中文名为影梭，为了避免关键词过滤，网友喜欢将 Shadowsocks 称为 “酸酸”，是一种基于 Socks5 代理方式的加密传输协议，也可以指定实现这个协议的各种开发包。Shadowsocks 是由 Clowwindy 为了自己使用谷歌查资料而编写；Shadowsocks 分为服务端和客户端，在使用之前，需要先将服务器端程序部署到服务器上面，然后通过客户端连接并创建本地代理。后来，他觉得这个东西非常好用，速度也很快，于是将源码提交到了 GitHub。由于其优秀的使用体验，Shadowsocks 被广泛传播，导致作者被某部门请去 “喝茶”。迫于压力 Clowwindy 于 2015-08-22 宣布停止维护此项目，并移除其个人页面所存储的源代码，而且保证永不再参与维护更新

虽然 Clowwindy 被迫放弃了 Shadowsocks，但开源界没有放弃，各路大神依旧在为 Shadowsocks 添砖加瓦，这就是开源的力量，倒下一个 Clowwindy，会有千千万万个 “Clowwindy” 站出来

SSR

SSR 是 ShadowsocksR 的缩写，网名爱称 “酸酸乳”，是在 Shadowsocks 的作者被请去喝茶之后，网名为 breakwa11 的用户发起的 Shadowsocks 的一个分支版本，它在 Shadowsocks 的基础上增加了一些数据混淆方式，修复了部分安全问题并提高了 QoS 优先级。由于 ShadowsocksR 在协议和混淆方面做了改进，更加不容易被 GFW 检测到，而且兼容原 Shadowsocks，并为新项目命名为 Shadowsocks-R，一开始部分代码由社区人员进行更新。由于不完全开源，也导致后来使用 SS 和 SSR 的用户分为两个阵营，互相撕逼，直到开发者 breakwa11 被人肉出来。breakwa11 最终决定删除 Shadowsocks-R 项目的所有代码，并解散了所有相关群组

事件始末澄清

ShadowsocksR 的作者一开始曾有过违反 GPL 协议，在发布二进制文件时不开放源码的争议。不过后来 Shadowsocks-R 项目由 breakwa11 采用了与 Shadowsocks 相同的 GPL、Apache、MIT 等多重自由软件许可协议

• 2017-07-19，ShadowsocksR 作者 breakwa11 在 Telegram 频道 ShadowsocksR news 里转发了深圳市启动 SS 协议检测的消息并被大量用户转发，在电报（TG）圈引发恐慌。
• 2017-07-24，breakwa11 遭到自称 “ESU.TV” 的不明省份人士人身攻击，对方宣传如果不停止开发并阻止用户讨论此事件将发布更多包含个人隐私的资料，随后 breakwa11 表示遭到对方人肉搜索并公开个人资料。为防止对方继续伤害无关人士，breakwa11 删除了 GitHub 上的所有代码、解散相关交流群组，并停止 ShadowsocksR 项目

从本质上来说，Shadowsocks 与 ShadowsocksR 的基本原理相同，都是基于 Socks5 的代理工具，只在本地客户端和服务器对数据包加解密，然后使用 Socks5 协议转发加密的数据包，而不用在乎使用什么协议，所以 Socks5 代理比其他应用层代理速度要快的多

Socks5

这里顺带科普一下 Socks5，Socks5 代理的原理是把你的网络数据请求先发送到你的代理服务器，然后由代理服务器转发给目标；如果目标有反馈发送到代理服务器，那么代理服务器会将数据包直接传回到你的本地网络，整个过程只需要数据的二次传输，并没有额外的处理。

示例：现在呢在深圳，你的代理服务器在香港，如果你想要访问 Google，那么你首先需要把数据请求通过本地 Socks5 代理客户端发给在你在香港的服务器上的 Socks5 代理服务端，然后你在香港的服务器将数据请求发送给 Google，再把 Google 反馈的结果传到你香港的代理服务器，然后通过 Socks5 服务端回传到本地的 Socks5 客户端，这样就可以绕开 GFW 的检测而实现科学上网

显而易见，Socks5 代理的所有数据走的任然是公网，而且在公网传输过程中，没有对数据进行任何加密和混淆，这跟 VPN 在公网建立虚拟专用通道传输过程中，对数据高强度加密的方式完全不同。Shadowsocks 和 ShadowsocksR 只在客户端和服务器端对数据做了简单加密和认证，主要功能是流量转发，过强才是主要目的。虽然 ShadowsocksR 已经停止更新很久了，而 Shadowsocks 仍处于社区人员的更新和维护之中，不断修复漏洞并增加新功能，所以现在 Shadowsocks 比 ShadowsocksR 更强大

提醒

不要迷信 SSR 一定比 SS 强，也包括现在的 V2Ray，Trojan，甚至是 WireGuard 等，因为增加混淆意味着损失速度，混淆加密越是强悍，那么其速度和稳定性损失就越大，另外 SSR 至今已被研究透了，而且长时间没有更新维护，其流量特征是可以被 GFW 精准识别，所以用 SSR 和 SS 没有本质区别，由于 SS 一直更新维护，反而更稳定。

V2Ray

V2Ray 是在 Shadowsocks 被封杀后，为表示抗议而开发，属于后起之秀，功能更加强大，为抗 GFW 封锁而生。V2Ray 现在已经是 Project V 项目的核心工具。而 Project V 是一个平台，其中也包括支持 Shadowsocks 协议。由于 V2Ray 早于 Project V 项目，且名声更大，我们习惯称 Project V 项目为 V2Ray，所以我们平常所说的 V2Ray 其实就是 Project V 这个平台，也就是一个工具集。其中，只有 VMess 协议是 V2Ray 社区原创的专属加密通讯协议

V2Ray 目前支持一下协议（截止 2019-12）

• Blackhole: 中文名称“黑洞”，是一个出站数据协议，它会阻碍所有的数据的出站，配合路由（Routing）一起使用，可以访问被封杀的网站
• DNS: 是一个出站协议，主要用于拦截和转发 DNS 查询。此出站协议只能接收 DNS 流量（包含基于 UDP 和 TCP 协议的查询），其它类型的流量会导致错误。在处理 DNS 查询时，此出站协议会将 IP 查询（即 A 和 AAAA）转发给内置的 DNS 服务器。其它类型的查询流量将被转发至原本的目标地址，DNS 出站协议在 V2Ray 4.15 中引入
• Dokodemo-door: 中文名称“任意门”，是一个入站数据协议，它可以监听一个本地端口，并把所有进入此端口的数据发送到指定服务器的一个端口，从而达到端口映射的效果
• Freedom: 是一个出站协议，可以用来向任意网络发起（正常的）TCP 或 UDP 数据
• HTTP: 超文本传输协议，是传统的代理协议
• Socks: 标准的 Socks 协议实现，兼容 Socks 4、Socks 4a、Socks 5『🙃目前无法正常访问』，也属于是一种传统的代理协议
• VMess: 是 V2Ray 专用的加密传输协议，它分为入站和出站两部分，通常作为 V2Ray 客户端和服务器之间的桥梁。因为增加了混淆和加密，据说比 Shadowsocks 更安全。VMess 依赖于系统时间，请确保使用 V2Ray 的系统 UTC 时间误差在 90 秒之内，与时区无关。在 Linux 系统中可以安装 ntp 服务来自动同步系统时间
• Shadowsocks: 包含入站，出站两部分协议，兼容大部分其它版本的实现。最早被个人开发的科学上网梯子协议，但 V2Ray 目前不支持 ShadowsocksR
• Trojan: 特洛伊木马服务器如何对有效的特洛伊木马协议和其他协议（可能是 HTTPS 或任何其他探针）做出反应
• VLESS: 是一个无状态的轻量传输协议，它分为入站和出站两部分，可以作为 V2Ray 客户端和服务器之间的桥梁，与 VMess 不同，VLESS 不依赖与系统时间，认证方式同样为 UUID，但不需要 alterId
• Loopback: 是一个出站协议，可使出站连接被重新路由，最低支持版本 v4.36.0+

截止到 2021-05，V2Ray 可选的传输层配置有：TCP、mKCP，WebSocket、HTTP/2，DomainSocket、QUIC、gRPC。其中 mKCP、QUIC 和 TCP 用于优化网络质量；WebSocket 用于伪装；HTTP/2 和 DomainSocket 用于传输以及 TLS 加密

V2Ray 不仅可以在传输层配置 TLS 使用 HTTP 和 Socks 变成 HTTPS 和 Socks over TLS 协议，也可以使用 MTProto、Shadowsocks 和 VMess 通过传输层配置 TLS 加密伪装成 TLS 流量。所以，VMess 配置是 TLS 加密的最常见的做法，但没人会对 Shadowsocks 使用 TLS 加密，因为完全没有意义

客户端

V2Ray 客户端

Xray 与 XTLS

Xray 与 V2Ray 完全类同，Xray 是 Project X 项目的核心模块。因为 Xray 和 XTLS 黑科技 的作者 rpfx 曾是 V2fly 社区的重要成员，所以 Xray 直接 fork 全部 V2Ray 的功能，然后进行性能优化，并增加了新的功能，使 Xray 在功能上成为了 V2Ray 的超集，且完全兼容 V2Ray。

简而言之，Xray 是 V2Ray 的项目分支，Xray 是 V2Ray 的超集，就跟 Trojan-Go 和 Trojan-GFW 的关系类似，而且 Xray 性能更好，速度更快，更新迭代也更频繁。

由于 V2Ray-core 4.33.0 版本起，删除了 XTLS 黑科技，但任然支持 VLESS，所以是否原生支持 XTLS 是 Xray 和 V2Ray 最大的区别之一

Trojan 与 Trojan-Go

Trojan 原特指特洛伊木马，是一种计算机病毒程序。但是，我们今天所说的 Trojan 是一种新型的科学上网技术，全称为 Trojan-GFW，是目前最成功的科学上网伪装技术之一。你可以认为 Trojan 是 V2Ray 的 “WS + TLS” 模式的精简版，速度比 V2Ray 更快，伪装比 V2Ray 更逼真，更难以备 GFW 识别

Trojan 工作原理：Trojan 通过监听 443 端口，模仿互联网上最常见的 HTTPS 协议，把合法的 Trojan 数据伪装成正常的 HTTPS 通信，并真正地完整完成 TLS 握手，以诱骗 GFW 认为它就是 HTTPS，从而不被识别。Trojan 处理来自外界的 HTTPS 请求，如果是合法的，那么为该请求提供服务，否则将该流量交给 Caddy、Nginx 等 Web 服务器，由 Caddy、Nginx 等为其提供网页访问服务。基于整个交互过程，这样能让你的 VPS 更像一个正常的 Web 服务器，因为 Trojan 的所有行为均为 Caddy、Nginx 等 Web 服务器一致，并没有引入额外特征，从而达到难以识别的效果

Trojan-Go 是 Trojan-GFW 的分支项目，对 Trojan 进行性能优化，并增加不少新特性，Trojan-Go 性能和功能均有大幅度的提升，而且支持分流和 CDN

总结

通过上述，以及其他信息来源对这些技术有了一定的基本认识，从以下的几个方面来进行总结

原理不同

VPN：强调对公网传输过程中数据的加解密
SS/SSR/V2Ray/Xray/Traojan：专注于在客户端和服务器间加密，公网传输过程中特征没有 VPN 明显

目的不同

VPN：是走在公网中自建的虚拟专用通道，使用强大的加解密算法，为数据传输安全性、私密性而生，被广泛应用于企业、高校、科研部门等远程数据传输领域
SS/SSR/V2Ray/Xray/Trojan/Trojan-Go：是为了数据能够安全通过 GFW 而生，更强调的是对数据的混淆和伪装，加解密只是为了更好的隐藏数据特征而顺利通过 GFW 的检测

项目诞生的大致顺序

VPN > SS > SSR/V2Ray/WireGuard > Trojan/Trojan-Go > Xray

致每一个追求真理的人

凡事都有两面性，看如何去看待。其实我一直认为，有墙确实是一件好事，毕竟祖国互联网发展也不过 20 多年，在一定程度上过滤掉了一些没有自我认知，自我思考盲目跟风，觉得国外的月亮圆，国外什么都好的一群人；保障了在互联网开始萌芽的本土企业（毕竟国外的产品和技术都已经发展了好几轮，从解决问题的能力，使用的用户体验（不含本地化）等等方面都是完全甩开本地企业的服务）发展，提供给企业和网民一起成长的安全环境，在这一点上 GFW 功不可没。但作为一个技术从业人员来说，其中大部分的技术理念思想，技术平台等纯技术领域相关的东西来说不是那么友好，常常伴随着由于网络原因而造成的各种乱七八糟的问题，对于暂无本土相关替代服务支持时，在一定程度上阻碍了国内相关技术的发展进度和创新。

真如前面所述，凡事都有两面性。对于未知的事物，人类本能的会产生恐惧，因为它不可控，而互联网正真不可控的不是技术而是人，人是复杂的个体，一个技术的好坏不是它本身，而是使用的人在做什么样的事，而做的事在一定的环境下它是有好坏之分的。因此我在这里对自我约束，仅为获取相关学习的知识，不参与散布谣言、政治相关等言论，踏踏实实搞技术

希望未来的有一天，国内技术人员的输出是全球技术的风向标

参考

1. 试用 Always Free 云服务
2. 申请 Oracle Cloud 永久免费服务
3. 2021年申请永久免费甲骨文云 Oracle Cloud 并创建实例最全攻略
4. 多种科学上网指导教程汇总
5. V2ray XTLS黑科技

什么是 OSS

OSS 是一种面向海量数据规模的分布式存储服务，具有稳定，可靠，安全，低成本的特点。主要用来存储各种非结构化的数据，比如视频，图像，日志，文本文件等。OSS 服务提供标准的 RESTful API 接口，并提供一些常用语言的 SDK 包，方便开发者进行快速开发和二次处理

常用的 OSS

市面上提供云服务的厂商有很多，这里以阿里云的 OSS 服务为主来，完成 OSS 相关的学习和实践

依赖

1
2
3
4
5
6

<!-- https://mvnrepository.com/artifact/com.aliyun.oss/aliyun-sdk-oss -->
<dependency>
    <groupId>com.aliyun.oss</groupId>
    <artifactId>aliyun-sdk-oss</artifactId>
    <version>3.11.1</version>
</dependency>

OSS 工具类

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

/**
 * OSS 文件上传
 *
 * @author : Jerry xu
 * @since : 2020/11/3  09:12
 */
@Slf4j
public class OssUtils {

    // 访问域名
    private static final String ENDPOINT = "xxxxx";
    // 存储空间
    private static final String BUCKET_NAME = "xxxxx";
    //==================访问密钥==================
    private static final String ACCESS_KEY_ID = "xxxxx";
    // 用户用于加密签名字符串和OSS用来验证签名字符串的密钥，必须保密
    private static final String ACCESS_KEY_SECRET = "xxxxx";

    /**
     * 通过文件上传图片
     *
     * @param file 文件
     * @return 上传结果地址
     */
    public static String uploadFileByFile(File file) {
//        // NIO 方式
//        byte[] fileByte = Files.readAllBytes(new File(file.getPath()).toPath());
//        // 其他方式
//        byte[] fileByte = Files.readAllBytes(Paths.get(file.getPath()));
//        return uploadFileByByte(fileByte, file);
        URL url;
        String urlStr = null;
        String[] split = new String[0];
        try {
            OSS ossClient = new OSSClientBuilder().build(ENDPOINT, ACCESS_KEY_ID, ACCESS_KEY_SECRET);
            // 获取文件名
            String fileName = file.getName();
            ossClient.putObject(BUCKET_NAME, fileName, file);
            // 设置过期时间
            url = ossClient.generatePresignedUrl(BUCKET_NAME, fileName, new Date(System.currentTimeMillis() + 3600 * 24 * 365 * 10));
            log.info("原始图片地址：{}", url);
            urlStr = url.toString();
//            byte[] fileByte = Files.readAllBytes(new File(file.getPath()).toPath());
//            PutObjectRequest putObjectRequest = new PutObjectRequest(BUCKET_NAME, "test", new ByteArrayInputStream(fileByte));
//            // 不设置过期时间
//            PutObjectResult putObjectResult = ossClient.putObject(putObjectRequest);
//            // 去除过期时间参数地址
//            split = urlStr.split("\\?");
        } catch (Exception e) {
            log.warn(e.getMessage());
        }
        return urlStr;
    }

    /**
     * 通过字节数组上传图片
     *
     * @param binaryBytes 字节数组
     * @param fileName    文件名
     * @return 上传结果地址
     */
    public static String uploadFileByByte(byte[] binaryBytes, String fileName) {
        InputStream inputStream = new ByteArrayInputStream(binaryBytes);
        return uploadFileByInputStream(inputStream, fileName);
    }

    /**
     * 通过输入流上传图片
     *
     * @param inputStream 输入流
     * @param fileName    文件名
     * @return 上传结果地址
     */
    public static String uploadFileByInputStream(InputStream inputStream, String fileName) {
        URL url;
        String urlStr = null;
        String[] split = new String[0];
        try {
            OSS ossClient = new OSSClientBuilder().build(ENDPOINT, ACCESS_KEY_ID, ACCESS_KEY_SECRET);
//            String fileName = UUID.randomUUID().toString() + ".jpeg";
            ossClient.putObject(BUCKET_NAME, fileName, inputStream);
            // 设置过期时间
            url = ossClient.generatePresignedUrl(BUCKET_NAME, fileName, new Date(System.currentTimeMillis() + 3600 * 24 * 365 * 10));
            log.info("原始图片地址：{}", url);
            urlStr = url.toString();
//            byte[] fileByte = Files.readAllBytes(new File(file.getPath()).toPath());
//            PutObjectRequest putObjectRequest = new PutObjectRequest(BUCKET_NAME, "test", new ByteArrayInputStream(fileByte));
//            // 不设置过期时间
//            PutObjectResult putObjectResult = ossClient.putObject(putObjectRequest);
//            // 去除过期时间参数地址
//            split = urlStr.split("\\?");
        } catch (Exception e) {
            log.warn(e.getMessage());
        }
        return urlStr;
    }

}

上传

这里我们写一个上传接口

1
2
3
4
5
6
7
8
9
10
11
12
13
14

@ApiOperation("文件上传", notes = "支持多图上传")
@PostMapping(value = "/upload", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
public List<String> uploadTest(@RequestParam("file") List<MultipartFile> file) {
    List<String> uploadList = new ArrayList<>(file.size());
    file.forEach(t -> {
        try {
            String url = OssUtils.uploadFileByInputStream(t.getInputStream(), t.getOriginalFilename());
            uploadList.add(url);
        } catch (IOException e) {
            e.printStackTrace();
        }
    });
    return uploadList;
}

测试

不废话了，直接看图就好了

问题

1. 对于上传获取到的文件地址是一个会过期的地址，并不是一个固定不变的地址，如上截图所示，我偷懒直接将地址链接出的相关参数删去，拿到了一个永久存储的访问连接地址。但这里需要注意，这需要在你的 OSS 管理后台去设置你的文件存储的过期策略。这里就不进行截图演示了（主要是我没有登录系统的账号密码，逃 ~）
2. 对于上传的文件我没有自定义文件名，这里有个问题是当用户上传 OSS 服务中已经存在的文件名的文件时，新上传的会覆盖旧文件，因此这个地方需要根据实际的业务场景选择合适的方式。在 OssUtils 工具类中我已经注释掉了将文件名重命名的代码，你可以在此处按照你的业务进行更改
3. 第三个问题就是结合上面的两点的汇总方案，其实呢，对于一般的系统，这些静态资源就存永久的连接地址即可。但目前新的系统对用户的资料等也有了 “稍微” 高一点的保护，就是这些资源都是有时效性的，获取的地址就是我们上传拿到的原始地址，而我们存放在数据库中当然也不会是之前那种永久的连接地址，而是对应图片的一个唯一标识信息（可以是重命名后的文件名或者其他能够唯一标识资源你的字段），然后用户访问这些资源时，用存放在数据库中的唯一标识去 OSS 服务上查询对应的资源，然后加载这个地址去显示。

参考

1. 阿里云对象存储 OSS
2. 对象存储 Kodo
3. 华为云对象存储服务 OBS

MinIO 包含 MinIO Server, MinIO Client 以及方便开发基于不同编程语言使用的 MinIO SDK，这三部分组成，使用步骤也很简单，在服务器上安装 MinIO Server 应用，在项目中集成对应的 MinIO SDK，然后按照你的业务情况编写相应的实现即可，在开始前，我们先看看为什么我选择 MiniIO 作为自建的 OSS 服务

1. MinIO 由良好的存储机制
2. 兼容 Amason 的 S3 分布式存储
3. 天然的支持云原生
4. 支持私有部署，可分布式，可单机，100%开源
5. 友好简单的部署方式，提供管理页面
6. 还可以配合其他的健康管理工具进行监控，比如 Prometheus

安装

由于 MinIO Server 已经提供了 Docker 的安装镜像，那我们就以 Docker 安装为例，其他安装方式可参考官方教程 MinIO Quickstart Guide

关于 Docker 的安装这里不再赘述，Docker 相关详细的使用等知识，可参考我之前的文章 Docker（一）

1
2
3
4
5
6
7
8

# 1. 拉取 minio docker 镜像
docker pull minio/minio
# 2. 运行 minio 服务
docker run -p 9000:9000 --name minio \
  -v /opt/docker/minio/data:/data \
  -v /opt/docker/minio/config:/root/.minio \
  -d --restart=always \
  -d minio/minio server /data

这里简单说一下命令的含义，应用命名为 minio ，运行服务在 9000 端口，同时将容器的相关路径文件映射到宿主机的 /opt/docker/minio 路径，开机自启

成功运行服务，可查看日志

1
2
3
4
5
6
7
8
9
10

Endpoint: http://172.17.0.2:9000 http://127.0.0.1:9000
Browser Access:
http://172.17.0.2:9000 http://127.0.0.1:9000
Object API (Amazon S3 compatible):
Go: https://docs.min.io/docs/golang-client-quickstart-guide
Java: https://docs.min.io/docs/java-client-quickstart-guide
Python: https://docs.min.io/docs/python-client-quickstart-guide
JavaScript: https://docs.min.io/docs/javascript-client-quickstart-guide
.NET: https://docs.min.io/docs/dotnet-client-quickstart-guide
Detected default credentials 'minioadmin:minioadmin', please change the credentials immediately using 'MINIO_ROOT_USER' and 'MINIO_ROOT_PASSWORD'

安装完成后，我们就可以通过 http://localhost:9000 访问 MinIO 服务，默认用户名和密码分别为: minioadmin, minioadmin

使用

页面操作

我们直接看图，输入账号密码后，可以看到 MinIO 的管理页面，我们就可以上传文件，是不是很方便。第一次上传必须先要创建一个 bucket 后，才可以上传，如下图操作结果

Client 操作

SDK 操作

导入依赖

1
2
3

dependencies {
  implementation "io.minio:minio:8.1.0"
}

功能实现

由于我这里是 SpringBoot 项目，为了方便在应用的 application.yml 文件中配置了 MinIO 相关的参数

配置文件

1
2
3
4
5
6
7
8
9
10
11

minio:
  # minio 服务运行的地址
  endpoint: http://127.0.0.1
  # minio 服务运行的端口
  port: 9000
  # minio 服务登录账号
  accessKey: minioadmin
  # minio 服务登录密码
  secretKey: minioadmin
  # minio 设置上传默认存放桶
  bucketName: cpe-manager-test

工具类

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201

/**
 * 资源上传工具类
 *
 * @author : Jerry xu
 * @since : 2021/3/18  14:05
 */
@Slf4j
@Component
public class MinioUtils {

    /**
     * minio:
     * endpoint: http://192.168.1.163
     * port: 9000
     * accessKey: minioadmin
     * secretKey: minioadmin
     * bucketName: cpe-manager-test
     */
    @Value("${minio.endpoint}")
    private static final String ENDPOINT = "http://192.168.1.163";
    @Value("${minio.port}")
    private static final Integer PORT = 19000;
    @Value("${minio.accessKey}")
    private static final String ACCESS_KEY = "minioadmin";
    @Value("${minio.secretKey}")
    private static final String SECRET_KEY = "minioadmin";
    @Value("${minio.bucketName}")
    private static final String BUCKET_NAME = "cpe-manager-test";

    private static MinioClient minioClient;

    public static MinioClient getInstance() {
        if (minioClient == null) {
            minioClient = MinioClient.builder().endpoint(ENDPOINT, PORT, false).credentials(ACCESS_KEY, SECRET_KEY).build();
        }
        return minioClient;
    }

    /**
     * 获取minio所有的桶
     *
     * @return java.util.List<io.minio.messages.Bucket>
     * @throws Exception exception
     */
    public static List<Bucket> getAllBucket() throws Exception {
        // 获取minio中所以的 bucket
        List<Bucket> buckets = getInstance().listBuckets();
        for (Bucket bucket : buckets) {
            log.info("bucket 名称:  {}      bucket 创建时间: {}", bucket.name(), bucket.creationDate());
        }
        return buckets;
    }

    /**
     * 将图片上传到minio服务器
     *
     * @param inputStream 输入流
     * @param objectName  存储的文件名称，必须包含后缀
     * @param bucketName  自定义存储桶
     */
    public static String uploadToMinio(InputStream inputStream, String objectName, String bucketName) {
        try {
            // 获取文件后缀
            String fileSuffix = Objects.requireNonNull(objectName).substring(objectName.lastIndexOf("."));
            String contentType = FileType.getContentType(fileSuffix);
//            // 重新生成文件名，避免重复
//            String objectName = UUID.randomUUID().toString() + fileSuffix;
            long size = inputStream.available();
            PutObjectArgs putObjectArgs = PutObjectArgs.builder()
                    .bucket(bucketName)
                    .object(objectName)
                    .stream(inputStream, size, -1)
                    .contentType(contentType)
                    .build();
            // 上传到minio
            ObjectWriteResponse objectWriteResponse = getInstance().putObject(putObjectArgs);
            inputStream.close();
            if (!StringUtils.isEmpty(objectWriteResponse.etag())) {
                // 返回上传获取到的地址
                return getUrlByObjectName(objectName);
            }
        } catch (Exception e) {
            log.error(e.getMessage());
            e.printStackTrace();
        }
        return null;
    }

    /**
     * 将图片上传到minio服务器，默认存放在 cpe-manager-test 桶内
     *
     * @param inputStream 输入流
     * @param objectName  存储的文件名称，必须包含后缀
     */
    public static String uploadToMinio(InputStream inputStream, String objectName) {
        try {
            // 获取文件后缀
            String fileSuffix = Objects.requireNonNull(objectName).substring(objectName.lastIndexOf("."));
            String contentType = FileType.getContentType(fileSuffix);
//            // 重新生成文件名，避免重复
//            String objectName = UUID.randomUUID().toString() + fileSuffix;
            long size = inputStream.available();
            PutObjectArgs putObjectArgs = PutObjectArgs.builder()
                    .bucket(BUCKET_NAME)
                    .object(objectName)
                    .stream(inputStream, size, -1)
                    .contentType(contentType)
                    .build();
            // 上传到minio
            ObjectWriteResponse objectWriteResponse = getInstance().putObject(putObjectArgs);
            inputStream.close();
            if (!StringUtils.isEmpty(objectWriteResponse.etag())) {
                // 返回上传获取到的地址
                return getUrlByObjectName(objectName);
            }
        } catch (Exception e) {
            log.error(e.getMessage());
            e.printStackTrace();
        }
        return null;
    }

    /**
     * 根据指定的objectName获取下载链接，需要bucket设置可下载的策略
     *
     * @param objectName 对象的名称
     * @return java.lang.String
     */
    public static String getUrlByObjectName(String objectName) {
        try {
            return getInstance().getPresignedObjectUrl(
                    GetPresignedObjectUrlArgs.builder()
                            .method(Method.GET)
                            .bucket(BUCKET_NAME)
                            .object(objectName)
                            // 过期策略【默认有效期7天】
//                            .expiry(2, TimeUnit.HOURS)
                            .build());
        } catch (Exception e) {
            log.error(e.getMessage());
            e.printStackTrace();
        }
        return null;
    }

    /**
     * 根据objectName从minio中下载文件到指定的目录
     *
     * @param objectName minio上的文件名称
     * @param fileName   下载生成的文件名
     * @param dir        文件目录
     * @throws Exception exception
     */
    public static void downloadFromMinioToFile(String objectName, String fileName, String dir) throws Exception {
        GetObjectArgs objectArgs = GetObjectArgs.builder()
                .bucket(BUCKET_NAME)
                .object(objectName)
                .build();
        File file = new File(dir);
        if (!file.exists()) {
            if (file.mkdirs()) {
                log.error("创建失败");
            }
        }
        InputStream inputStream = getInstance().getObject(objectArgs);
        FileOutputStream outputStream = new FileOutputStream(new File(dir, fileName.substring(fileName.lastIndexOf("/") + 1)));
        int length;
        byte[] buffer = new byte[1024];
        while ((length = inputStream.read(buffer)) != -1) {
            outputStream.write(buffer, 0, length);
        }
        outputStream.close();
        inputStream.close();
    }

    /**
     * 根据文件名批量删除（默认删除 BUCKET_NAME 下的文件）
     *
     * @param listFile 文件名(含后缀)列表，例如：demo.png
     * @return 成功返回为null， 失败返回Map<objectName, failMessage>
     */
    @SneakyThrows
    public static Map<String, String> removeObjects(List<String> listFile) {
        List<DeleteObject> objects = new LinkedList<>();
        Map<String, String> resultMap = new HashMap<>();
        listFile.forEach(t -> objects.add(new DeleteObject(t)));
        Iterable<Result<DeleteError>> results =
                getInstance().removeObjects(
                        RemoveObjectsArgs.builder()
                                .bucket(BUCKET_NAME)
                                .objects(objects)
                                .build());
        for (Result<DeleteError> result : results) {
            DeleteError error = result.get();
            resultMap.put(error.objectName(), error.message());
            log.error("Error in deleting:{}, message{}", error.objectName(), error.message());
        }
        return resultMap;
    }

}

上传接口

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

@PostMapping(value = "/upload", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
@ApiOperation(value = "文件上传", notes = "支持多文件上传")
public List<String> uploadTest(@ApiParam(value = "文件") @RequestParam("file") List<MultipartFile> file) {
    // 上传的图片地址
    List<String> successFile = new ArrayList<>(file.size());
    file.forEach(t -> {
        try {
            String url = MinioUtils.uploadToMinio(t.getInputStream(), t.getOriginalFilename());
            log.info("图片地址{}", url);
            successFile.add(url);
        } catch (IOException e) {
            e.printStackTrace();
        }
    });
    return successFile;
}

测试

问题

bucket命名

创建 bucket 时，命名不可以使用下划线符号 “_”

账号密码修改

通过网页管理页面修改登录账号及密码，提示 “Credentials of this user cannot be updated through MinIO Browser.” ，原因是安装应用时，并未显示的指定用户名和密码，可在运行启动时添加如下配置

1
2

-e "MINIO_ROOT_USER=admin" \
-e "MINIO_ROOT_PASSWORD=admin123456" \

最长7天有效

通过网页管理页面共享图片或者是使用 SDK 上传图片得到的图片 URL 地址，有效期最长为7天

1
2
3
4
5
6

mc config host add minio http://192.168.1.163:19000 minioadmin minioadmin --api S3v4
mc policy set public minio/cpe-manager-test

mc config host add minio http://127.0.0.1:9000 minioadmin minioadmin --api S3v4
mc policy set public minio/bucket (bucket修改成你自己的名字)

图片无法查看

1. 使用 SDK 上传时，需要注意设置content-type信息
2. 无权限查看

小结

关于 MinIO 还有很多知识点，本片只是站在使用者角度，把一些使用过程和问题进行了汇总，谈不上深度

参考

1. Minio 手册
2. Minio 示例
3. Minio 修改密码
4. Minio
5. Minio 安装以及使用
6. Minio 设置文件链接永久有效

计算机网络

数据结构与算法

操作系统

计算机组成原理

编译原理

资源

参考

1. 聊一聊我在B站上自学编程的经历吧

这是我第一次来开发小程序，虽然之前有开发 Android 客户端的经验，有一定的客户端经验，但是小程序却一直没有去实践，我主要是觉得小程序的使用体验真的很差。但随着现在人们的硬件设备越来越好，并且微信团队在应用底层也做了很多的扩展和优化，现在使用小程序开发轻量级的应用还是很方便且高效

环境及选型

1. OS：macOS（11.2.1）
2. IDE：WeChat Devtools（1.05.2102010）
3. Node：v15.5.0
4. Vant：1.6.7
5. 微信小程序账号

关于账号的申请，这里不做讲解，请自行解决

初始化项目

创建项目

不废话，直接看图

项目结构

项目是一个基于云开发的方式，创建完成后会包含云相关的一些操作实例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

bill
  ├── cloudfunctions/               # 云函数管理【清空当前文件夹下的内容】
  │    │── callback/
  │    │── echo/
  │    │── login/
  │    └── openapi/    
  ├── minprogram/
  │    │── components/              # 组件【清空当前文件夹下内容】
  │    │── images/                  # 图片管理【清空当前文件夹下内容】
  │    │── pages/                   # 页面管理【除 index 页面，其余都删除】
  │    │    │── addFunction/
  │    │    │── chooseLib/
  │    │    │── databaseGuide/
  │    │    │── deployFunctions/
  │    │    │── im/
  │    │    │── index/
  │    │    │    │── index.js
  │    │    │    │── index.json
  │    │    │    │── index.wxml
  │    │    │    │── index.wxss
  │    │    │    └── user-unlogin.png
  │    │    │── openapi/
  │    │    │── storageConsole/
  │    │    └── userConsole/
  │    │── style/                   # 样式管理
  │    │── app.js                   # 项目入口逻辑管理
  │    │── app.json                 # 组件库配置
  │    │── app.wxss                 # 全局样式设置
  │    └── sitemap.json             # 
  ├── project.config.json           # 项目配置文件
  └── README.md                     # 项目说明

精简项目

从上面我们可知初始化的项目，包含了一些示例，我们对其精简

1. 清空 cloudfunctions 目录下的云函数内容
2. 根据项目结构里的备注，进行删除相关的文件
   • 清空 components 文件夹下的组件
   • 清空 images 文件夹中的内容
   • 删除 pages 文件夹下，除 index 的文件夹
   • 删除 index 文件夹下的 user-unlogin.png 文件
3. 修改文件内容
   • 清空 index 文件夹下 index.wxml，index.wxss 文件中的内容
   • 修改 index 文件夹下 index.js 文件内容
   • 清空 minprogram 文件夹下 app.wxss 文件中的样式内容
4. 修改配置
   • 移除 app.json 文件中 已经移除掉的 pages 的配置
   • 修改 project.config.json 文件，移除 miniprogram 的配置

添加 vant 组件

整个步骤，如下截图

执行命令根据官方提供的方式和自身喜好选择，我这里使用的是 yarn 命令进行安装相关的依赖

测验效果

这里以添加 Button 为例来查看是否生效

1. 在 pages/index 路径下的 index.json 文件中，添加 vant 的 Button 组件

   1 2 3 4 5

   { "usingComponents": { "van-button": "@vant/weapp/button/index" } }

2. 在 pages/index 路径下的 index.wxml 文件中，添加 vant 的相关组件

   1 2 3 4

   <van-button type="primary">主要按钮</van-button> <van-button type="info">信息按钮</van-button> <van-button type="warning">警告按钮</van-button> <van-button type="danger">危险按钮</van-button>

3. 编译，在模拟器中查看效果

对于引用的组件，是公共的，可以写在 app.json 文件中

参考

1. 官方开发文档
2. 微信小程序组件库Vant weapp的使用与weui零基础入门课程

回想起之前写文章主要是为了记录一些操作步骤和一些知识点，方便遇到类似问题，快速定位，解决问题。但随着文章的越写越多，包含的内容也越来越多，需要去了解的知识也越来越多，真的是有一种 “你知道的越多，你不知道的越多” 的感觉，这种感觉让我对待每个知识点都能有往深去深挖的动力，对每一个知识点用自己文字将它讲出来时有一种让我欲罢不能成就感，这或许就是上瘾吧

总结下第一个里程碑，主要是平时接触到领域算是一些入门级别的一些文章，以及一些比较粗浅的见闻，缺乏深层次的剖析和思考，这也是第二个里程碑首要做的事情，把每个接触到的知识点进行深挖，打通自己的技术栈。技术领域能不能走得远，很大程度上并不是你的技能宽度，而是深度，是在一个方向上的深耕，并且对于底层的技能也是要有足够的涉猎，只有这样就算是技术的花样任它怎么去变，你都能以不变应万变（透过现象找到本质）；第二点是是对第一阶段内容完善补充；第三点就是打磨自己的语言表达能力，让文章更加的通俗易懂；第四点就是不能太拖拉，要保持高效的内容输出

这一阶段，对开源项目贡献评价最高的是 rap2-delos 项目了。努力在接下来的里程中，提高质量和参与度，争取早日在大型项目中做到 Committer

很感谢这一路走来，大伙对我的认可和期待以及赞赏，下一个里程碑我们见~

环境

• OS：macOS 11.1
• JDK：JDK1.8
• Gradle：6.7.1-bin
• IDE：IntelliJ IDEA Community 2020.3

Gradle 版本通过 https://github.com/spring-projects/spring-boot/blob/master/gradle/wrapper/gradle-wrapper.properties 文件可知，使用的 6.7.1-bin，那么本地也使用该版本编译，对于 Gradle 的安装可参考 Gradle（一）基础 文章

获取源码

1
2

# 这里使用 cnpmjs 来提高 clone 速度
git clone https://github.com.cnpmjs.org/spring-projects/spring-boot.git

编译构建

使用 IDEA 打开项目，会自动创建索引以及，下载项目的依赖，由于依赖的 jar 比较多，建议使用 阿里云 镜像，关于 Gradle 怎么修改依赖镜像源，可参考 专治各种网络不服 文章，阿里云镜像能加速大部分的 jar，但有一部分在阿里云上并没有，你可以通过手动方式导入到本地

工程选择

对于单工程，和聚合工程的选择主要根据你所在项目团队的大小，项目分工，以及项目的复杂程度等来考虑。

单工程：适用于项目分工明确，项目庞大复杂，架构服务边界划分明确，配套的自动化等设施完善
聚合工程：适用于项目人员不是很多，项目功能一般，需要一个人集中化管理等

环境

• OS：macOS 11.1
• JDK：JDK1.8
• Gradle：6.7.1-bin
• IDE：IntelliJ IDEA Community 2020.3
• SpringBoot：2.4.1

build.gradle

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

// 项目使用插件，可从 https://plugins.gradle.org 库中寻找合适的插件
plugins {
    id 'org.springframework.boot' version '2.4.1'
    id 'io.spring.dependency-management' version '1.0.10.RELEASE'
    id 'java'
}

// 这里和 maven类似，用于项目唯一坐标
group = 'com.example'
version = '0.0.1-SNAPSHOT'
// 项目兼容版本
sourceCompatibility = '1.8'

// 依赖第三方jar从哪个仓库去下载
repositories {
    mavenCentral()
}

// 项目所需的第三方依赖
dependencies {
    implementation 'org.springframework.boot:spring-boot-starter'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

// 测试相关
test {
    useJUnitPlatform()
}

一个 SpringBoot 项目基本的 build.gradle 文件由 plugins，项目坐标，repositories，dependencies，test 基础内容组成。关于 plugins 使用常见有两种方式，核心的依赖，是没有版本号，它和你使用的 Gradle 关联，你无需过多关系这些核心插件的依赖版本

1
2
3
4
5
6
7

// 旧方式
apply plugin: 'java'

// 新方式（推荐）
plubins {
    id 'java'
}

settings.gradle

用于项目模块管理，由于这个单工程，这里只有一个模块

1

rootProject.name = 'demo'

多环境

可通过自定义 task 来出来

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

// prod
tasks.register("bootRunProd") {
    group = "application"
    description = "Runs the Spring Boot application with the prod profile"
    doFirst {
        tasks.bootRun.configure {
            systemProperty("spring.profiles.active", "prod")
        }
    }
    finalizedBy("bootRun")
}

// dev
tasks.register("bootRunDev") {
    group = "application"
    description = "Runs the Spring Boot application with the dev profile"
    doFirst {
        tasks.bootRun.configure {
            systemProperty("spring.profiles.active", "dev")
        }
    }
    finalizedBy("bootRun")
}

启动方式

• 方式一：图形化界面中，直接运行对应环境
  

• 方式二：在命令行中，使用命令来运行对应环境，比如 gradlew bootRunDev
  

• 方式三：当然你也可以在启动时指定你需要激活的环境

  1 2	# 这里激活的 test 环境，把 ${jar_name} 参数换成对应启动的应用文件 java -jar ${jar_name} --spring.profiles.active=test

排除依赖

1
2
3

testImplementation('org.springframework.boot:spring-boot-starter-test') {
    exclude group: 'org.junit.vintage', module: 'junit-vintage-engine'
}

打包

打包时需要，注意我们的 SpringBoot 应用它本质上是一个 bootJar（Fatjar） 应用，因此需要将应用打成一个 bootJar（Fatjar）。而对于什么是 bootJar 和 jar 的区别，可以查看之前在 SpringBoot（二） 启动分析JarLauncher 文章中对于 jar 规范 说明

打包方式

• 方式一：图形化操作

• 方式二：命名执行

  1 2 3

  # 在项目的根目录执行，Windows 使用：gradlew；Linux/macOS：./gradlew # 当然如果那你已安装且配置好 gradle 的环境，你可以直接使用 gradle 代替 ./gradlew 的相关命令 gradlew bootJar

发布

参考

1. SpringBoot+gradle 构建多模块项目
2. IDEA 2020.2 + Gradle 6.6.1 + Spring Boot 2.3.4 创建多模块项目
3. Spring-boot 2.3.x 源码基于Gradle编译
4. 用 Gradle 构建 Spring Boot 项目
5. 使用 Gradle 构建 springboot 多模块项目,并混合groovy开发
6. Spring Boot Gradle Plugin Reference Guide

Project 级别

build.gradle

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

// gradle 脚本执行所需依赖，分别是对应的maven库和插件
buildscript {
    repositories {
        google()
        jcenter()
    }
    // 声明依赖 Android Gradle 插件版本
    dependencies {
        classpath 'com.android.tools.build:gradle:3.5.3'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

// 项目所有 module 配置需要的依赖
allprojects {
    repositories {
        google()
        jcenter()
    }
}

// 一个 clean 任务，用于删除 build 目录的文件
task clean(type: Delete) {
    delete rootProject.buildDir
}

settings.gradle

1
2

// 默认指的是创建 Android 项目生成的 app 模块，也是默认的应用启动模块
include ':app'

Module 级别

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194

// 表示这是一个应用程序模块，可直接运行
apply plugin: 'com.android.application'

// 编译时间
static def releaseTime() {
    return new Date().format('yyyy-MM-dd', TimeZone.getTimeZone('UTC'))
}

android {
    // 编译 Android 版本
    compileSdkVersion 29
    // 默认配置
    defaultConfig {
        // 应用 ID，手机中用于识别应用的唯一标识
        applicationId "org.incoder.android"
        // 目标 Android 版本
        targetSdkVersion 29
        // 申明应用可超过 65536 的方法，可参考：https://developer.android.google.cn/studio/build/multidex?hl=zh_cn
        multiDexEnabled true
        // 申明要使用AndroidJUnitRunner进行单元测试
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }

    // 签名配置，相关信息放置在 gradle.properties 文件中
    signingConfigs {
        debug {
            storeFile file(DEBUG_STORE_FILE)
            storePassword DEBUG_STORE_PASSWORD
            keyAlias DEBUG_KEY_ALIAS
            keyPassword DEBUG_KEY_PASSWORD
        }
        release {
            storeFile file(RELEASE_STORE_FILE)
            storePassword RELEASE_STORE_PASSWORD
            keyAlias RELEASE_KEY_ALIAS
            keyPassword RELEASE_KEY_PASSWORD
            v2SigningEnabled true
        }
    }

    buildTypes {
        debug {
            minifyEnabled false
            zipAlignEnabled false
            shrinkResources false
            // 签名
//            signingConfig signingConfigs.debug
            manifestPlaceholders = [
                    //JPush
                    JPUSH_APPKEY : "",
                    JPUSH_CHANNEL: "",
                    // Pgy
                    PGYER_APPID  : "7907554687e4c116316feedb3820ce52",
                    // Bugly
                    BUGLY_APPID  : "",
                    VERSION_NAME : "0.1.0",
            ]
            ndk {
                // 设置支持的SO库架构
                abiFilters 'armeabi', 'x86', 'armeabi-v7a', 'x86_64', 'arm64-v8a'
            }
        }

        release {
            // 混淆
            minifyEnabled false
            // Zipalign优化
            zipAlignEnabled true
            // 移除无用的resource文件
            shrinkResources false
            // 前一部分代表系统默认的android程序的混淆文件，该文件已经包含了基本的混淆声明
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
            // 签名
            signingConfig signingConfigs.release
            // AppAnalytics key
            manifestPlaceholders = [
                    // JPush
                    JPUSH_APPKEY : "",
                    JPUSH_CHANNEL: "",
                    // Pgy
                    PGYER_APPID  : "7907554687e4c116316feedb3820ce52",
                    // Bugly
                    BUGLY_APPID  : "",
                    VERSION_NAME : "0.1.0",
            ]
        }
    }

    // 重命名安装包
    android.applicationVariants.all {
        variant ->
            variant.outputs.all {
                output ->
                    output.outputFileName = variant.flavorName + buildType.name +
                            "_" + releaseTime() + ".apk"
            }
    }

    // 产品变种
    flavorDimensions "minSDK"

    // 针对不同渠道的配置
    productFlavors {
        // 测试环境渠道包
        dev {
            applicationId 'org.incoder.test'
            minSdkVersion 19
            // 测试环境IP配置 API 接口地址
            buildConfigField 'String', 'API', '"http://xxx.xxx.xxx.xxx:8888"'
            versionCode 2020122501
            versionName "2.0"
            // 指定产品变种
            dimension "minSDK"
        }
        // 正式环境渠道包
        rel {
            applicationId "org.incoder.android"
            minSdkVersion 16
            // 正式环境域名 API 接口地址
            buildConfigField 'String', 'API', '"http://api.xxx.xxx/"'
            versionCode 2020122501
            versionName "2.1"
            // 指定产品变种
            dimension "minSDK"
        }
    }

    // 过滤指定产品变种（渠道，构建类型）
//    variantFilter { variant ->
//        def names = variant.flavors*.name
//        def isDebug = variant.buildType.debuggable
//        // To check for a certain build type, use variant.buildType.name == "<buildType>"
//        if (names.contains("rel") && isDebug) {
//            // Gradle ignores any variants that satisfy the conditions above.
//            setIgnore(true)
//        }
//    }

    // 多渠道配置
    productFlavors.all {
        flavor ->
            flavor.manifestPlaceholders = [CHANNEL_VALUE: name]
    }

    // 执行lint检查，有任何的错误或者警告提示，都会终止构建
    lintOptions {
        disable 'MissingTranslation', 'ExtraTranslation'
        // abortOnError一定要设为false，这样即使有报错也不会停止打包了
        abortOnError false
        // 在打包Release版本的时候进行检测,可以打开，这样报错还会显示出来
        checkReleaseBuilds false
    }

    dexOptions {
        jumboMode true
        javaMaxHeapSize "4g"
    }

    // 打包时的配置
    packagingOptions {
        exclude 'META-INF/LICENSE'
        exclude 'META-INF/NOTICE'
        exclude 'META-INF/rxjava.properties'
    }

    aaptOptions.cruncherEnabled = false
    aaptOptions.useNewCruncher = false

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

// 项目依赖的包
dependencies {
    implementation fileTree(include: ['*.jar'], dir: 'libs')
    implementation 'com.android.support:appcompat-v7:28.0.0'
    implementation 'com.android.support:design:28.0.0'
    implementation 'com.android.support:support-v4:28.0.0'
    implementation 'com.android.support:support-v13:28.0.0'
    implementation 'com.android.support.constraint:constraint-layout:1.1.3'
    implementation 'com.android.support:support-vector-drawable:28.0.0'
    androidTestImplementation 'com.android.support.test:runner:1.0.2'
    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
    testImplementation 'junit:junit:4.12'
}

关于 module 中的 build.gradle 配置文件中的各项已在示例中加入了注释说明，其中一些配置，这里再简单的说明下

apply plugin

这里的 apply plugin 有两种模式：

1. com.android.application：表示这是一个应用程序模块
2. com.android.library：表示这是一个库模块

前者可以直接运行，后着是依附别的应用程序运行

buildTypes

这里主要是生成安装文件的配置信息，一个 debug 类型，用于指定生成测试版安装文件配置，可忽略不写；另一个是 release，用于指定生成正式版安装文件的配置。

• minifyEnabled：是否对代码进行混淆，默认 false
• proguardFiles：指定混淆的规则文件，默认指定了 proguard-android.txt 文件和 proguard-rules.pro 文件。
  • proguard-android.txt：默认的混淆文件，里面定义了一些通用的混淆规则
  • proguard-rules.pro：位于当前项目的根目录下，可以在该文件中定义一些项目特有的混淆规则
• buildConfigField：可用于解决不同渠道不同的服务地址，或不同渠道 LOG 打印控制等
• debuggable：是否支持断点调试，release 默认为 false，debug 默认 true
• jniDebuggable：是否可以调试 NDK 代码，使用 lldb 进行 C 和 C++ 代码调试，release 默认为 false
• signingConfig：设置签名信息，通过 singingConfig.release 或 singingConfig.debug，配置相应的签名，但是添加此配置前需要先添加 singingConfig 闭包
• renderscriptDebuggable：是否开启渲染脚本，就是一些 C 写的渲染方法，默认为 false
• renderscriptOptimLevel：渲染等级，默认为 3
• zipAlignEnabled：是否对 apk 包执行 zip 对齐优化，减少 zip 体积，提高运行效率，release 和 debug 都默认 true
• pseudoLocalesEnabled：是否在 apk 中生成伪语言环境，帮助国际化，一般很少使用
• applicationIdSuffix：和 defaultConfig 中配置一样，指在 applicationId 中添加一个后缀
• versionNameSuffix：添加版本名称的后缀，一般使用较少

productFlavors

这个配置主要是解决应用发布在不同应用市场，而需要对不同应用市场做一些不同配置，比如包名，应用名，以及一些统计，而需要不同渠道统计 ID 等

packagingOptions

packagingOptions 常见的设置项有 exclude、pickFirst、doNotStrip、merge

1. exclude：过滤掉某些文件或者目录不添加到APK中，作用于APK，不能过滤aar和jar中的内容

   1 2 3 4

   packagingOptions { exclude 'META-INF/**' exclude 'lib/arm64-v8a/libmediaplayer.so' }

2. pickFirst：匹配到多个相同文件，只提取第一个。只作用于APK，不能过滤aar和jar中的文件

   1 2 3 4

   packagingOptions { pickFirst "lib/armeabi-v7a/libaaa.so" pickFirst "lib/armeabi-v7a/libbbb.so" }

3. doNotStrip：可以设置某些动态库不被优化压缩

   1 2 3 4

   packagingOptions{ doNotStrip "*/armeabi/*.so" doNotStrip "*/armeabi-v7a/*.so" }

4. merge：将匹配的文件都添加到APK中，和pickFirst有些相反，会合并所有文件

   1 2 3 4

   packagingOptions { merge '**/LICENSE.txt' merge '**/NOTICE.txt' }

统一版本

应用由多个 module 构成，而不同地方引用的包，需要做到全局的统一时，可以创建一个 xxx.gradle 的文件（这里的 xxx，自行取一个表明含义的内容即可），然后在使用的地方时，统一调用定义的版本即可，使用步骤如下

1. 创建 xxx.gradle 文件（一般放在项目的根目录，和顶级 build.gradle 文件在同一层级），并添加如下内容，可根据自身需要调整

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126

   ext { android = [ compileSdkVersion: 29, buildToolsVersion: "29.0.2", minSdkVersion : 19, targetSdkVersion : 29, versionCode : 2020010102, versionName : "0.1.0" ] version = [ androidSupportSdkVersion: "29.0.0", retrofitSdkVersion : "2.6.3", okhttpSdkVersion : "4.3.0", dagger2SdkVersion : "2.22.1", glideSdkVersion : "4.9.0", butterknifeSdkVersion : "10.2.1", rxlifecycle2SdkVersion : "2.2.1", espressoSdkVersion : "3.0.2", canarySdkVersion : "1.5.4" ] // Android support 与 AndroidX support 对比 // https://developer.android.google.cn/jetpack/androidx/migrate // support 库说明 // https://developer.android.com/topic/libraries/support-library/features?hl=zh-cn dependencies = [ // support "appcompat" : "androidx.appcompat:appcompat:1.1.0", "annotations" : "androidx.annotation:annotation:1.0.0", "cardview-v7" : "androidx.cardview:cardview:1.0.0", "constraint-layout" : "androidx.constraintlayout:constraintlayout:1.1.3", "swiperefreshlayout" : "androidx.swiperefreshlayout:swiperefreshlayout:1.0.0", "material" : "com.google.android.material:material:1.1.0", "viewpager" : "androidx.viewpager:viewpager:1.0.0", "recyclerview" : "androidx.recyclerview:recyclerview:1.1.0", "vectordrawable" : "androidx.vectordrawable:vectordrawable:1.1.0", "support-v4" : "androidx.legacy:legacy-support-v4:1.0.0", // network "retrofit" : "com.squareup.retrofit2:retrofit:${version["retrofitSdkVersion"]}", "retrofit-converter-gson" : "com.squareup.retrofit2:converter-gson:${version["retrofitSdkVersion"]}", "retrofit-converter-simplexml": "com.squareup.retrofit2:converter-simplexml:${version["retrofitSdkVersion"]}", "retrofit-adapter-rxjava2" : "com.squareup.retrofit2:adapter-rxjava2:${version["retrofitSdkVersion"]}", "okhttp3" : "com.squareup.okhttp3:okhttp:${version["okhttpSdkVersion"]}", "okhttp3-logging-interceptor" : "com.squareup.okhttp3:logging-interceptor:${version["okhttpSdkVersion"]}", "mockwebserver" : "com.squareup.okhttp3:mockwebserver:${version["okhttpSdkVersion"]}", "glide" : "com.github.bumptech.glide:glide:${version["glideSdkVersion"]}", // （annotationProcessor） "glide-compiler" : "com.github.bumptech.glide:compiler:${version["glideSdkVersion"]}", "glide-loader-okhttp3" : "com.github.bumptech.glide:okhttp3-integration:${version["glideSdkVersion"]}", // view "butterknife" : "com.jakewharton:butterknife:${version["butterknifeSdkVersion"]}", "butterknife-compiler" : "com.jakewharton:butterknife-compiler:${version["butterknifeSdkVersion"]}", "brvah" : "com.github.CymChad:BaseRecyclerViewAdapterHelper:2.9.49-androidx", "psid" : "com.oushangfeng:PinnedSectionItemDecoration:1.3.2-androidx", "material-dialogs" : "com.afollestad.material-dialogs:core:2.8.1", "material-input" : "com.afollestad.material-dialogs:input:2.8.1", "material-files" : "com.afollestad.material-dialogs:files:2.8.1", "material-color" : "com.afollestad.material-dialogs:color:2.8.1", "material-datetime" : "com.afollestad.material-dialogs:datetime:2.8.1", "pickerview" : "com.contrarywind:Android-PickerView:4.1.8", "photoview" : "com.github.chrisbanes.photoview:library:2.0.0", "lottie" : "com.airbnb.android:lottie:3.0.1", "badge-view" : "q.rorbin:badgeview:1.1.3", // rx2 "rxandroid2" : "io.reactivex.rxjava2:rxandroid:2.1.1", "rxjava2" : "io.reactivex.rxjava2:rxjava:2.2.16", // https://github.com/VictorAlbertos/RxCache "rxcache2" : "com.github.VictorAlbertos.RxCache:runtime:1.8.3-2.x", // https://github.com/tbruyelle/RxPermissions "rxpermissions2" : "com.github.tbruyelle:rxpermissions:0.10.2", // tools（implementation） "dagger2" : "com.google.dagger:dagger:${version["dagger2SdkVersion"]}", "dagger2-android" : "com.google.dagger:dagger-android:${version["dagger2SdkVersion"]}", "dagger2-android-support" : "com.google.dagger:dagger-android-support:${version["dagger2SdkVersion"]}", "eventbus" : "org.greenrobot:eventbus:3.1.1", "gson" : "com.google.code.gson:gson:2.8.5", // https://projectlombok.org/setup/android "lombok" : "org.projectlombok:lombok:1.18.8", "multidex" : "com.android.support:multidex:1.0.3", "arouter-api" : "com.alibaba:arouter-api:1.4.1", "arouter-compiler" : "com.alibaba:arouter-compiler:1.2.2", //（annotationProcessor） "dagger2-compiler" : "com.google.dagger:dagger-compiler:${version["dagger2SdkVersion"]}", "dagger2-android-processor" : "com.google.dagger:dagger-android-processor:${version["dagger2SdkVersion"]}", // test "junit" : "junit:junit:4.12", "androidJUnitRunner" : "androidx.test.runner.AndroidJUnitRunner", "runner" : "androidx.test:runner:1.1.1", "espresso-core" : "androidx.test.espresso:espresso-core:3.2.0", "espresso-contrib" : "androidx.test.espresso:espresso-contrib:3.2.0", "espresso-intents" : "androidx.test.espresso:espresso-intents:3.3.0", "canary-debug" : "com.squareup.leakcanary:leakcanary-android:${version["canarySdkVersion"]}", "canary-release" : "com.squareup.leakcanary:leakcanary-android-no-op:${version["canarySdkVersion"]}", "umeng-analytics" : "com.umeng.analytics:analytics:6.0.1", // util // https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/README-CN.md "utilcode" : "com.blankj:utilcode:1.23.7", // help "logger" : "com.orhanobut:logger:2.2.0", // https://www.pgyer.com/doc/view/new_sdk_android_guide "pgy" : "com.pgyersdk:sdk:3.0.3", // SDK 包 // https://bugly.qq.com/docs/release-notes/release-android-bugly/?v=20180709165613 // https://jcenter.bintray.com/com/tencent/bugly/crashreport/ "crashreport" : "com.tencent.bugly:crashreport:3.1.0", // 升级 SDK 包 // https://bugly.qq.com/docs/release-notes/release-android-bugly/?v=20180709165613 // https://jcenter.bintray.com/com/tencent/bugly/crashreport_upgrade/ "bugly-crash-upgrade" : "com.tencent.bugly:crashreport_upgrade:1.4.2", // NDK 动态库 // https://bugly.qq.com/docs/release-notes/release-android-ndk/?v=20180709165613 // https://jcenter.bintray.com/com/tencent/bugly/nativecrashreport/ "bugly-ndk" : "com.tencent.bugly:nativecrashreport:3.7.1", ] }

2. 在顶级的 build.gradle 文件底部，表明添加对 xxx.gradle 的使用

   1	apply from: "xxx.gradle"

3. 在 module 级别的 build.gradle 文件中，修改哪些固定写死的依赖版本

   1 2 3 4

   // 之前固定的版本 minSdkVersion 19 // 修改通过 xxx.gradle 中定义的版本 minSdkVersion rootProject.ext.android["minSdkVersion"]

参考

1. Android Gradle 插件版本说明
2. 配置构建
3. 配置构建变体

• Gradle official：https://gradle.org
• Gradle docs：https://docs.gradle.org
• Gradle plugins：https://plugins.gradle.org

Gradle 特点

1. Gradle 基于 JVM 的构建工具
2. 兼容支持 Maven，Ant 等
3. 支持基于 Groovy 的构建脚本
4. 编译构建执行效率更高
5. 支持多种语言等
6. 易于迁移

Gradle 安装配置

• Gradle 官方：https://services.gradle.org/distributions/
• Tencent 镜像：https://mirrors.cloud.tencent.com/gradle/

Tencent Gradle 镜像同步有一定的延迟，需要注意

下载

下载需要的版本即可，推荐最新版，这里以最新稳定版 6.7.1 为例，每个正式版本包含如下文件，我们选择 xxx-bin.zip（二进制版，只包含了二进制文件（可执行文件），没有文档和源代码） 或 xxx-all.zip（完整版，包含了各种二进制文件，源代码文件，和离线的文档）的文件即可，进行手动安装

1
2
3
4
5
6
7
8
9
10

gradle-6.7.1
    ├── gradle-6.7.1-wrapper.jar.sha256     # wrapper.jar hash 校验文件 
    ├── gradle-6.7.1-docs.zip               # gradle 文档压缩文件
    ├── gradle-6.7.1-docs.zip.sha256        # gradle 文档 hash 校验文件
    ├── gradle-6.7.1-src.zip                # gradle 源码版，只包含了 Gradle 源代码，不能用来编译你的工程
    ├── gradle-6.7.1-src.zip.sha256         # gradle 源码版 hash 校验文件
    ├── gradle-6.7.1-bin.zip                # gradle 核心压缩文件
    ├── gradle-6.7.1-bin.zip.sha256         # gradle 核心 hash 校验文件
    ├── gradle-6.7.1-all.zip                # gradle 全部资源压缩文件
    └── gradle-6.7.1-all.zip.sha256         # gradle 全部资源 hash 校验文件

当然如果你使用的 macOS 系统，且也已经安装了 homebrew 包管理工具，那么同样你也可以使用 brew 命令来安装 Gradle，那么你将不需要再去手动配置 Gradle 的环境，它的安装默认路径在 /usr/local/bin/gradle，安装完成后你就可以使用 gradle 的相关命令

1
2
3
4
5
6

# gradle 安装
brew install gradle
# gradle 升级
brew upgrade gradle
# 检查是否安装成功
gradle -v

配置

手动下载解压的文件进行安装，则需要配置 Gradle 的环境，这样方便我们在任何地方都可以调用 Gradle 的命令，对于 macOS 上手动安装配置 Gradle 环境的操作，可以参考 MacBook Pro 初始化 这篇文章 Gradle 配置

对于 Windows 系统，按照如下步骤进行添加环境变量，我这里 Windows 上为了和项目中 Gradle 版本有所区分，配置的是 6.7 版本


配置完成后，老规矩我们需要验证下我们的配置是否生效，在命令行中输入 gradle -v 命令，查看有 Gradle 相关的版本信息提示，我们的配置就已成功

GRADLE_HOME

GRADLE_HOME 这个环境变量，它主要是我们手动配置指定 GRADLE 使用的命令环境

GRADLE_USER_HOME

GRADLE_USER_HOME 指配置 Gradle 的安装下载的路径。默认 /Users/<PC NAME>/.gradle 路径，如果你在系统环境中设置了 GRADLE_USER_HOME 的环境变量，那么下载的路径就变成了你自定义设置的路径

Gradle 基础

刚刚在上面我们配置时，使用了 gradlew 命令，那这个又是啥呢，这里简单解释下，gradlew 是 gradle wrapper 的简写，对于 Gradle 构建的项目，用于解决 Gradle 安装，部署以及统一项目的 Gradle 的构建版本等一系列问题。

Gradle 有两个基本的概念：project 和 task，Gradle 里面的所有东西基于这两个概念

• project：通常指一个项目
• task：指构建过程中的任务

一次构建可以有 1 到 n 个 project，而每个 project 有 1 到 n 个 task

Gradle 项目

Android 项目工程一开始就默认使用 Gradle 来构建，在 Android 领域里使用花样也是比较多，更好体现了 Gradle 的灵活性，对于后端 Spring 系列项目，现在也是越来越多的开始使用 Gradle 来构建了，在 Spring Boot 2.3.0.M1 版本官方已开始在生产环境开始使用 Gradle 代替 Maven 进行构建，测试，发布项目。这从侧面也印证了 Gradle 对于复杂庞大的系统更加友好和高效。

对于使用 Gradle 构建的 Android 项目也好，Java 项目也好，还是 SpringBoot 项目也罢，它们都有共同的特点。在结构上有下面的相同点

1
2
3
4
5
6
7
8
9
10
11

project
    ├── ……
    ├── .gradle/                            # 项目使用 gradle 编译生成的临时文件存放位置
    ├── gradle/wrapper
    │    │── gradle-wrapper.jar             # gradlew 核心执行文件
    │    └── gradle-wrapper.properties      # gradle 运行环境配置文件
    ├── build.gradle                        # 项目依赖配置，脚本配置文件
    ├── gradlew                             # Linux or macOS 下可执行脚本
    ├── gradlew.bat                         # Windows 下可执行脚本
    ├── settings.gradle                     # 配置构建应用时应将哪些模块包含在内
    └── ……

gradle-wrapper.properties

• gradle-wrapper.jar 文件是项目中执行 gradlew 相关命令的具体实现，感兴趣的可以查看其中的具体源码实现
• gradle-wrapper.properties 是 Gradle 项目版本管理的核心
  • distributionBase=GRADLE_USER_HOME：指定了 wrapper 保存下载的 Gradle 的主路径
  • distributionPath=wrapper/dists：指定了 wrapper 保存下载的 Gradle 的子路径
  • zipStoreBase=GRADLE_USER_HOME：指定了 wrapper 保存下载 gradle-6.7.1-bin.zip 文件的主路径
  • zipStorePath=wrapper/dists：指定了 gradle-6.7.1-bin.zip 文件的子路径
  • distributionUrl=https://services.gradle.org/distributions/gradle-6.7.1-bin.zip：gradle 文件下载的源地址

对应 Gradle 的下载及解压目录这里还需要注意下

build.gradle 及 settings.gradle

对于build.gradle 及 settings.gradle 文件在 Android 应用和 SpringBoot 应用是不一样，因此关于他两介绍请移步 Gradle（二）Android，Gradle（三）SpringBoot 文章进行查看

Gradle 依赖

用于声明依赖关系的配置

核心需要掌握的是 api，implementation，compileOnly，runtimeOnly 这4种依赖方式

对于你可能看到依赖方式，compile（api），provided（compileOnly），apk（runtimeOnly） 这些方式是比较旧的依赖方式，在 gradle plugin 3.0 开始已废弃，请使用新的依赖方式

本地依赖

本地依赖 module lib

通过这种方式依赖的弊端是每次都需要构建 module，但 module 比较多时构建非常耗时，建议控制 module 的依赖数量，避免构建耗时

1
2

// module 需要在项目根目录下的 settings.gradle 中通过 include 引入
implementation project(':libname')  

本地二进制 lib 依赖

本地的 jar 或者 aar 需要放在 module 的 libs 文件夹下，通过这种方式依赖

依赖 jar

1
2
3
4
5

// 方式一：可以一次性依赖 libs 下的所有 jar
implementation fileTree(dir: 'libs', include: ['*.jar'])

// 方式二：可以指定依赖一个或几个 jar
implementation files('libs/xxxx1.jar', 'libs/xxxx2.jar')

依赖 aar

1
2
3
4
5
6
7
8
9
10
11
12

// 在 module 的 build.gradle 中添加目录指定
repositories {
    flatDir {
        dirs 'libs'
    }
}

// 在 dependencies 中加入对 aar 的引入
// 方式一：可以一次性依赖 libs 下所有的 aar
implementation fileTree(dir: 'libs', include: ['*.aar'])
// 方式二：可以指定依赖某一个aar
implementation files(name: 'aar-lib-name', ext: 'aar')

远程二进制 lib 依赖

1
2
3
4
5

// 依赖明确的版本，标明 group、name 和 version
implementation group: 'org.mybatis.spring.boot', name: 'mybatis-spring-boot-starter', version: '2.1.1'

// 常用的简写方式引用
implementation 'org.mybatis.spring.boot:mybatis-spring-boot-starter:2.1.1'

Gradle 命令

在项目中推荐使用 gradlew 命令来进行执行，这样本质是使用项目所依赖的 Gradle 版本进行执行。当然如果你本地配置了 Gradle 的环境变量，你可以将 gradlew 命令更改成 gradle 来执行

• gradlew clean: 清除 build 文件夹
• gradlew check: 执行 lint 检查
• gradlew assemble: 编译并打包你的代码，但并不运行单元测试
• gradlew build: 编译和测试你的代码，并生成一个包含所有类与资源的文件
• gradlew dependencies: 查看所有依赖库
  • gradlew dependencies -configuration runtime: 查看运行时依赖库

总结

1. 对于 Gradle 我们不需要配置 GRADLE_USER_HOME 的环境，原因是项目中已对使用 Gradle 的版本做出了统一，我们仅需要根据自身的网络需要（如果从默认地址下载很慢，则需要配置好项目依赖镜像源）做出合适的配置。而如果你需要在任何地方使用 gradle 相关的命令，则配置 GRADLE_HOME 即可
2. 依赖方式，我们选择 implementation 方式，这样可屏蔽掉不同应用之间因为引用了同一 lib 而不同版本造成的麻烦问题等

参考

• gradle-wrapper.properties中各属性的含义
• Dependency management in Gradle
• The Java Library Plugin
• The Distribution Plugin

故宫博物院出品，奥秘之家设计制作（曾推出线下实景地铁逃脱游戏，2018联合《唐人街探案 2》推出《侦探笔记》的互动解密游戏，以及配合电影开发Crimaster），到手快一年了还没有完全解锁线上的关卡，倒不是玩不下去，而是懒，刷 B 站多香，动啥脑子，哈哈哈。言归正传，本篇记录自己解锁线上关卡的步骤，持续更新

进度

0. 初 ------------------ 100%
   • ✅ 梦入紫禁
   • ✅ 太和异象
   • ✅ 十八棵槐
1. 壹 ------------------ 23%
   • 万寿盛筵
   • 殿前观礼
   • 礼乐度量
   • 一等画师
   • 腰牌买卖
   • 慈宁画样
2. 贰 ------------------ 0%
   • 宫女禾心
   • 嘉祉初遇
   • 淑芳听戏
   • 戏里玄机
   • 上元之约
3. 叁 ------------------ 0%
   • 结伴寻宝
   • 皇十五子
   • 档房探秘
   • 一路狂奔
   • 逢凶化吉
   • 五行八卦
   • 夜探御园
4. 肆 ------------------ 0%
   • 琳琅宝藏
   • 花叶之谜
   • 宫中怪人
   • 图籍作者
   • 祸不单行
   • 五蕴皆空
5. 伍 ------------------ 0%
   • 将破未破
   • 孤注一掷
6. 隐 ------------------ 0%
   • 多年以后
7. 众 ------------------ 0%
   • 众筹专属

初

梦入紫禁

太和异象

十八棵槐

壹

万寿盛筵

殿前观礼

礼乐度量

一等画师

腰牌买卖

慈宁画样

贰

宫女禾心

嘉祉初遇

淑芳听戏

戏里玄机

上元之约

叁

结伴寻宝

皇十五子

档房探秘

一路狂奔

逢凶化吉

五行八卦

夜探御园

肆

琳琅宝藏

花叶之谜

宫中怪人

图籍作者

祸不单行

五蕴皆空

伍

将破未破

孤注一掷

隐

多年以后

众

众筹专属

附录

1. 奥秘之家官网：http://www.itaotuo.com/
2. 《唐人街探案 2》之《侦探笔记》：https://www.zhihu.com/question/267341464
3. 《唐人街探案 3》之《侦探笔记》：https://zhongchou.modian.com/item/90315.html

公司原装配置电脑磁盘性能太差，实在是不能满足我的日常骚操作，然后就自己买了一个 m.2 接口的 SSD 硬盘，毕竟电脑之前已经有系统了，而且也已经安装好了开发环境，如果现在在新的 SSD 上直接安装新的系统，那么需要将之前的开发环境再折腾一遍，实在是伤不起。那么有没有别的方式。你别说哦，还真的有，方法是用一些工具对现有系统进行 clone 到新的 SSD 磁盘上。这都很好办，比如：傲梅分区助手，DiskGenius 都有系统迁移功能，可参考文章下方的参考地址，内有视频教程

注意：要设置好设置默认系统启动引导为新的磁盘

问题

一开始，我觉得这么简单的操作能有什么问题，迁移完系统，并设置好系统引导，然而我发现并不能按照预期使用 SSD 来启动，试了好几遍，调整了 BIOS 的启动选项，依旧不能解决。后来我将原系统的磁盘拆下来，只留 SSD 磁盘，开机就能按照预期启动了，正常后在把原系统磁盘再装回去，同时记得检查下系统引导，确保还依旧是使用 SSD 系统盘

参考

1. SSD系统迁移工具：轻松迁移系统到SSD
2. 使用分区助手快速将Windows系统迁移到新磁盘

对于 Base64 ，开发者或多或少都有听过，严格意义上讲 Base64 不是加密方式，它只是一种编码方式，本篇文章就来详细的聊一聊 Base64 这个熟悉又陌生的朋友

什么是 Base64

Base64 的原理

常见的 Base64

解决实际问题

参考

1. 密码学 | 庐山真面！你认为 Base64 是加密算法吗？
2. 什么是Base64？
3. Base64编码原理分析
4. Base64编码
5. Base64算法不一致可能会导致的坑

在软件开发中通常有两种情况我们需要考虑软件的开源协议或者使用协议

1. 我们需要使用到业界的一些优秀的软件包来提高我们开发的效率，避免了重复早轮子，所选择的这些软件包我们不但考虑功能的同时，也要考虑软件包的授权协议
2. 我们需要将自己的经验或者软件产品需要开源时，为了保护自己的权益，我们也需要选择一个合适的开源协议

我这里还是引用比较经典 阮一峰 文章中所绘制关于如何选择开源协议的图

图中已经很清楚的表示了如何去选择 LGPL, Mozilla, GPL, BSD, MIT, Apache 这 6 种协议

常用协议

这里我们通过表格的形式介绍下这 6 种协议，当然除了表中列出的这些协议之外还有很多协议，我们就挨个来简单对他们有一个了解和认识

其他协议

BY-NC-SA

你会发现每篇文章下面都有申明版权，这里使用的是 BY-NC-SA 4.0 的协议，他们的含义如下

• ：知识共享（CreativeCommons）
• NC：非商业性使用（NonCommercial），您不得将本作品用于商业目的
• SA：相同方式共享（ShareAlike），如果您再混合、转换或者基于本作品进行创作，您必须基于与原先许可协议相同的许可协议 分发您贡献的作品

使用此协议，您可以自由地

1. 共享 — 在任何媒介以任何形式复制、发行本作品
2. 演绎 — 修改、转换或以本作品为基础进行创作

只要你遵守许可协议条款，许可人就无法收回你的这些权利

选择

上面说了那么多，有些协议并没有展开来说可能并不适用你当前的所需要选择的协议，那么你可以根据实际情况去筛选，可通过 https://choosealicense.com, https://kaiyuanshe.cn/license-tool 这两个网站按照步骤去选择，最终确定协议即可

参考

1. 开源许可证选择器
2. Choose an open source license
3. 博云违反 Apache 2.0 开源协议被要求整改，开源协议到底应该如何遵守？
4. 开源协议是什么？有哪些？如何选择？
5. 如何为你的代码选择一个开源协议
6. 开源指北 Gitee

博客升级

每次对于 NexT 的升级或多或少都会遇到些问题，这次也不例外，首先是对于不同版本的管理，由于一些历史原因有三个组织仓库分别对应不同的版本域，升级是需要注意下，本次我是从 7.8.0 版本升级到 8.0.x 版本，以后跟随官方，每月更新 NexT

npm 改成 yarn（可选）

yarn 的安装，请自行根据你的系统去安装，我这里 macOS 使用命令即可 brew install yarn

1. 删除根目录的 package-lock.json，并在根目录执行 hexo clean && rm -rf node_modules/
2. 根目录下执行 yarn install

更改 NexT 主题仓库

1. 删除当前主题，在根目录下执行 rm -rf themes/
2. 安装新的主题，
   • 方案一：在根目录下执行命令添加主题

   1	git clone https://github.com/next-theme/hexo-theme-next themes/next

   • 方案二：通过 yarn 来管理主题

   1	yarn add hexo-theme-next

修改配置

之前为了使主题更新不受影响，在项目的根目录 source/_data 路径下有一个 next.yml 文件来进行对 NexT 的自定义设置，那么在 8.0 版本开始，在项目根目录 _config.{theme}.yml 文件来代替之前在 source/_data 路径下的 next.yml 文件

问题

node --trace-warnings

异常信息

由于 NexT 需要 Hexo5.0+，在升级到 NexT 8.0.x 版本警告信息如下

1
2
3
4
5
6
7

(node:17336) Warning: Accessing non-existent property 'lineno' of module exports inside circular dependency
(Use `node --trace-warnings ...` to show where the warning was created)
(node:17336) Warning: Accessing non-existent property 'column' of module exports inside circular dependency
(node:17336) Warning: Accessing non-existent property 'filename' of module exports inside circular dependency
(node:17336) Warning: Accessing non-existent property 'lineno' of module exports inside circular dependency
(node:17336) Warning: Accessing non-existent property 'column' of module exports inside circular dependency
(node:17336) Warning: Accessing non-existent property 'filename' of module exports inside circular dependency

原因分析

是由于 Hexo 项目嵌套依赖了 stylus 包，而对于 0.54.5 版本在 Node 14+ 版本存在问题，比如这里 hexo-renderer-stylus 包的依赖

1
2
3
4
5
6
7

……
│ │
├─┬ hexo-renderer-stylus@2.0.1
│ ├─┬ nib@1.1.2
│ │ └─┬ stylus@0.54.5
│ │   │ 
……

解决方法

1. 可以降低你的 Node 版本到 12 版本

   1 2 3

   brew uninstall node brew install node@12 brew link --overwrite --force node@12

2. 推荐，更改替换 stylus 版本，在你的 package.json 文件中，添加如下配置

   1 2 3

   "resolutions": { "stylus": "^0.54.8" }

总结

🌀 pull-2538
🐞 issues-2534
🛠 solve-Accessing non-existent property

hexo-douban

之前用了 hexo-douban 插件来进行对 books 和 movies 进行管理，在升级到 Node 14+版本上，当前的插件也停止工作了，异常日志如下

1
2
3

INFO  0 books have been loaded in 1130 ms, because you are offline or your network is bad
INFO  0 movies have been loaded in 1329 ms, because you are offline or your network is bad
INFO  0 games have been loaded in 1004 ms, because you are offline or your network is bad

作者在🐞 issues-2534 做了回复，暂时没有替代方案，故在新版中，我停止了 hexo-douban 插件的使用，挖个坑，等自己有时间或者有人修复此问题再或者有替代插件后再重新启用

1. 移除 hexo-douban 插件

   1 2 3 4

   # yarn yarn remove hexo-douban # npm npm uninstall hexo-douban

2. 移除 _config.yml 配置文件中，douban 的相关的配置
3. 移除 _config.{theme}.yml 配置文件中，menu 配置的站点入口设置

博客评论

在 NexT version 8.1.0 版本，由于安全问题，Valine被移除，暂时我并未迁移 Valine 的评论

博客已启用 utterances 评论支持，配置也比较简单，如下

1
2
3
4
5
6
7

utterances:
  enable: true
  repo: BladeCode/BladeCode.github.io # Github repository name
  # Available values: pathname | url | title | og:title
  issue_term: title
  # Available values: github-light | github-dark | preferred-color-scheme | github-dark-orange | icy-dark | dark-blue | photon-dark | boxy-light
  theme: github-light

文章加密

对于 NexT 的文章，有时需要进行加密访问，那么该怎么去处理呢，其实这一点在 NexT 的生态里已经有了这样的插件，我们可以直接在使用在我们的 NexT 里面，只需要简单的配置

1
2
3
4

# npm 
npm i hexo-blog-encrypt --save
# yarn
yarn add hexo-blog-encrypt

加密优先级：文章信息头 > 按标签加密

站点配置（_config.yml）

简单配置

1
2
3

# 文章密码访问 hexo-blog-encrypt
encrypt:
  enable: true

更多配置

可以对一类（标签）来进行统一的密码设置

1
2
3
4
5
6
7
8
9
10

# 文章密码访问 hexo-blog-encrypt
encrypt: 
  abstract: 有东西被加密了, 请输入密码查看.
  message: 您好, 这里需要密码.
  tags:
  - {name: tagNameA, password: 密码A}
  - {name: tagNameB, password: 密码B}
  template: <div id="hexo-blog-encrypt" data-wpm="{{hbeWrongPassMessage}}" data-whm="{{hbeWrongHashMessage}}"><div class="hbe-input-container"><input type="password" id="hbePass" placeholder="{{hbeMessage}}" /><label>{{hbeMessage}}</label><div class="bottom-line"></div></div><script id="hbeData" type="hbeData" data-hmacdigest="{{hbeHmacDigest}}">{{hbeEncryptedData}}</script></div>
  wrong_pass_message: 抱歉, 这个密码看着不太对, 请再试试.
  wrong_hash_message: 抱歉, 这个文章不能被校验, 不过您还是能看看解密后的内容.

单文章配置

在你需要加密的文章前面，根据需要添加对应的参数，这里仅是一个示例

1
2
3
4
5
6
7
8
9
10
11

---
title: Hello World
tags:
- 加密文章tag
date: 2020-11-20 18:18:18
password: helloworld
abstract: 该文章已加密, 请输入密码查看。
message: 该文章已加密, 请输入密码查看。
wrong_pass_message: 密码不正确，请重新输入！
wrong_hash_message: 文章不能被校验, 不过您还是能看看解密后的内容！
---

各参数说明

• password：文章密码
• abstract：文章摘要，会显示在博客的列表页
• message：文章查看时，密码输入框上面的描述性文字
• wrong_pass_message：校验失败提示
• wrong_hash_message：hash 验证失败

多语言

对于多语言，根据自身需要添加，默认，修改博客项目根目录 _connfig.yml 文件 language 属性即可

1. 对于单语言：language: xxx（具体语言可查看下方的官方说明）
2. 对于多语言：
   • 语言添加

     1 2 3

     language: - zh-CN - en

   • 更改语言切换，_config.{theme}.yml 文件，language_switcher设置为 true
3. 字段定义，如果一些字段的翻译不是你想要的，你可以自行修改
   • 在根目录的 source/_data 文件夹下，创建 languages.yml 文件
   • 在文件中，修改对应语言的字段

     1 2 3 4 5 6 7 8 9

     zh-CN: # items post: copyright: # the translation you perfer author: 本文博主 en: menu: schedule: Calendar

多语言配置

GitHub Action

Hexo PWA

由于暂未支持 Hexo5.0+版本，先占坑

参考

• 更新说明及常见问题
• 将 Hexo 升级到 v5.0.0
• 用 GitHub Actions 来自动部署 Hexo
• Hexo博客部署PWA
• 博客完美支持 PWA
• 三步，让 Hexo 轻松支持 PWA
• Pwabuilder
• Hexo 相关问题和优化

macOS Big Sur

在 2020.11.13 正式推送了 macOS Big Sur version 11.0.1 版本，这一个版本是改动比较大的版本，这里关于它的新特性就不做介绍了，有兴趣的请查看官方网站介绍 Big Sur

Glance 失效

Glance 是一个快速预览增强，可以对一些文件进行快速预览，大大提高我们的日常效率，但该应用在 Big Sur 版本中不兼容，由于作者已入职 Apple，且对项目做了归档，不在维护，因此该问题依旧没有解决，可以使用一个付费的应用iPreView来满足当前需要

Glance 在 Big Sur 系统中失效

AirPods 异常

在 AirPods 使用过程中，发现有时候耳机并不能正常工作。通常情况下，我会断开与 macOS 的连接，重新连接，如果还是不能正常工作，在 macOS 的系统蓝牙设置里面，移除连接的耳机设备，将耳机放入 AirPods 盒子里面，先盖上盒子，然后再打开盒子，此时并按住 AirPods 盒子背后的按钮，直到前面呼吸灯变成白色，然后再 macOS 的蓝牙里面找到新的设备，并连接配对。同时也可参考官方指引步骤 连接并使用 AirPods 和 AirPods Pro

单耳工作

换一个连接设备，检查耳机是否正常，如果是正常，那说明耳机没有问题，问题就出在 macOS 声音管理上面，打开系统设置 -> 声音 -> 输出模式 ->设置为居中的平衡模式（既双耳工作）

本篇文章主要讲一讲在构建分布式微服务应用时，经常遇到的问题以及对于同类型组件选择，以及在开发过程中相关问题的思考，对于在整个应用开发过程中，开发人员应该怎么去配合等等，那第一个问题是面对我们的业务场景该如何去做技术选型，我们先看 Spring 官方经典的微服务架构图

微服务的核心组件由：网关，服务注册发现，服务配置，熔断限流等组成

选型

• 编程语言：Oracle JDK 8
• 构建工具：Gradle
• 网关路由：Spring Cloud Gateway
• 服务通信：Dubbo
• 消息管理：RockerMQ
• 分布式事务：Seata
• 注册中心及配置中心：Nacos
• 限流，熔断，降级：Sentinel
• 文档管理：SpringFox + Knife4j + Dubbo-Api-Docs
• 部署发布：Docker + Nexus Repository OSS
• 运维监控：Prometheus + Grafana

SpringCloud VS SpringCloud Alibaba

这里我汇总到表格中，方便查看比较

相关问题

JDK

OpenJDK

Java 最早由 SUN（Sun Microsystems，发起于美国斯坦福大学，SUN 是 Stanford University Network 的缩写）发明，2006 年 SUN 公司将 Java 开源，此时的 JDK 即为 OpenJDK

OpenJDK 是 Java SE 的开源实现，由 SUN 和 Java 社区提供支持，2009 年 Oracle 收购了 SUN 公司，自此 Java 的维护方之一的 SUN 也就变成了 Oracle

大多数 JDK 都是在 OpenJDK 的基础上编写实现的，比如 IBM J9，Azul Zulu，Azul Zing 和 Oracle JDK。几乎所有的 JDK 都派生自 OpenJDK，他们之间不同的是授权许可证。常见的 OpenJDK 发行商

TLS：long-term support，长期支持（LTS）是一种产品生命周期管理策略，在该策略中，与标准版相比，计算机软件的稳定版本可以维持更长的时间。该术语通常保留给开源软件，它描述的软件版本比该软件的标准版本支持数月或数年的支持。
TCK：Technology Compatibility Kit，技术兼容性套件（TCK）是一套测试套件，至少名义上检查Java规范请求（JSR）的特定声称实施是否符合要求

OralceJDK

显而易见 OracleJDK 是在 Oracle 收购 SUN 公司之后，基于 OpenJDK 源码构建的 JDK 被命名了 OracleJDK，两则之间没有重大的技术差异

两者的区别

问题

有人会说了，这有啥好说的，我们在公司开发都是用 OracleJDK 的。曾经我也以为这两个区别不是很大，看公司的使用情况了，直到我使用了 CentOS 7 系统默认带的 OpenJDK 来编译 Gradle 项目，死活是编译不过，总是提醒我找不到 tools.jar 包。有图有真相

一开始，我把以为是环境配置的问题，但是经过一番折腾，卸载了自带的 OpenJDK，然后再用 yum install java 命令去安装 OpenJDK，发现并不是环境的问题，而是系统自带的这个 OpenJDK 是 JRE，所以并没有包含 tools.jar 文件。所以这个问题就是你系统 JDK 的问题了。建议卸载 JRE，重新安装 JDK

1
2
3
4

# 可以先查找 JDK，下面命令是我查找 java-1.8 的相关应用
yum search java-1.8 | grep -i --color JDK
# 也可以直接安装 JDK，比如我这里提供的 java-1.8.0-openjdk-devel.x86_64
yum install java-1.8.0-openjdk-devel.x86_64

Gradle or Maven

关于如何使用 Gradle 构建项目，以及使用 Gradle 配置符合企业敏捷开发需求，可查看我的 Gradle 系列的文章

jar 与 bootJar

之前在《SpringBoot（二） 启动分析JarLauncher》文章中进行对 SpringBoot 应用启动做了分析，提到了 jar 规范，做了简单的介绍，那么本篇在此基础上进一步的完善这个知识点

这里以 rc-microservices-alibaba 项目的 microservices-alibaba-gateway 模块的编译为例

jar

jar（Java Archive）可以看做是特殊文件压缩的一种，通常用于聚合大量的 Java 类文件，相关的元数据和资源文件到一个文件，以便分发 Java 平台应用软件或库。jar 文件是一种归档文件，以 ZIP 格式构建，以 .jar 为文件扩展名。包含一个可选的 META-INF 目录，可以通过命令行 jar 工具或使用 Java 平台中的 java.util.jar API 创建 jar 文件

可以看到，我们打包成 jar 的文件，仅仅是源码+资源文件，以及生成的 META_INF 文件

1
2
3
4
5
6
7
8
9
10