This is an automated email from the ASF dual-hosted git repository.
liuhongyu pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/shenyu-website.git
The following commit(s) were added to refs/heads/main by this push:
new f1bb719835 1. 修改文档中jdk标识错误:jdk最低版本版本为17,不是1.8 (#1056)
f1bb719835 is described below
commit f1bb7198356cab4e41ad643355af52e1c3fdb027
Author: JerryDtj <[email protected]>
AuthorDate: Thu Mar 13 15:13:23 2025 +0800
1. 修改文档中jdk标识错误:jdk最低版本版本为17,不是1.8 (#1056)
2. 添加maven最低版本限制
3. 添加弱网环境下git的操作流程
for english
1. Correct the JDK version indication error in the documentation: The
minimum required JDK version is 17, not 1.8.
2. Add the minimum version requirement for Maven.
3. Add the Git operation process for low - network - quality environments.
---
...urceCode-Analysis-Start-Demo-for-Contributor.md | 17 +++++++++++-
...urceCode-Analysis-Start-Demo-for-Contributor.md | 31 +++++++++++++++++-----
2 files changed, 41 insertions(+), 7 deletions(-)
diff --git a/blog/Start-SourceCode-Analysis-Start-Demo-for-Contributor.md
b/blog/Start-SourceCode-Analysis-Start-Demo-for-Contributor.md
index 05d4e7eb2d..4dd44278e2 100644
--- a/blog/Start-SourceCode-Analysis-Start-Demo-for-Contributor.md
+++ b/blog/Start-SourceCode-Analysis-Start-Demo-for-Contributor.md
@@ -13,8 +13,9 @@ As a first-time developer in the `Shenyu` community, I
encountered some "Pitfall
## Environmental Preparation
-- Correct local installation of `JDK1.8+`
+- Correct local installation of `JDK17+`
- Properly install `Git` locally
+- Correctly install Maven `3.6.3+`
- Choose a development tool, this article uses `IDEA` as an example
## ShenYu Backend Startup Guide
@@ -91,6 +92,20 @@ Maven is a cross-platform project management tool . As the
Apache organization's
git config --global core.longpaths true
```
+ Tips: If you encounter the following error or have network issues
preventing you from pulling all the code:
+
+ ``` tex
+ RPC failed; curl 92 HTTP/2 stream 5 was not closed cleanly: CANCEL (err 8)
2057 bytes of body are still expected fetch-pack: unexpected disconnect while
reading sideband packet early EOF fetch-pack: invalid index-pack output
+ ```
+
+ You can execute the following commands to first pull a single version of
the code, then fetch the full code:
+
+ ``` shell
+ git clone https://github.com/apache/shenyu.git --depth 1
+ cd ./shenyu
+ git fetch --unshallow
+ ```
+
### ShenYu First Start
#### Preparation
diff --git
a/i18n/zh/docusaurus-plugin-content-blog/Start-SourceCode-Analysis-Start-Demo-for-Contributor.md
b/i18n/zh/docusaurus-plugin-content-blog/Start-SourceCode-Analysis-Start-Demo-for-Contributor.md
index 0a9cad9543..9676c16390 100644
---
a/i18n/zh/docusaurus-plugin-content-blog/Start-SourceCode-Analysis-Start-Demo-for-Contributor.md
+++
b/i18n/zh/docusaurus-plugin-content-blog/Start-SourceCode-Analysis-Start-Demo-for-Contributor.md
@@ -13,12 +13,15 @@ tags: [first-start,Apache ShenYu]
## 环境准备
-- 本地正确安装 `JDK1.8+`
+- 本地正确安装 `JDK17` 或更高版本
- 本地正确安装 `Git`
+- 本地正确安装`Maven3.63` 或更高版本
- 选择一款开发工具，本文使用 `IDEA` 为例
## ShenYu 后端启动指南
+
+
### 安装并配置Maven
Maven是一个跨平台的项目管理工具。作为Apache组织顶级开源项目，其主要服务于基于Java平台的项目创建，依赖管理和项目信息管理。
@@ -50,21 +53,21 @@ Maven是一个跨平台的项目管理工具。作为Apache组织顶级开源项
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<mirrorOf>central</mirrorOf>
</mirror>
-
+
<mirror>
<id>alimaven</id>
<mirrorOf>central</mirrorOf>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/repositories/central/</url>
</mirror>
-
+
<mirror>
<id>maven</id>
<mirrorOf>central</mirrorOf>
<name>name_</name>
<url>http://repo1.maven.org/maven2</url>
</mirror>
-
+
<mirror>
<id>junit</id>
<mirrorOf>central</mirrorOf>
@@ -91,6 +94,22 @@ Maven是一个跨平台的项目管理工具。作为Apache组织顶级开源项
git config --global core.longpaths true
```
+ Tips: 如果提示如下错误或者网络不好无法拉取全部代码：
+
+ ``` tex
+ RPC failed; curl 92 HTTP/2 stream 5 was not closed cleanly: CANCEL (err
8) 2057 bytes of body are still expected fetch-pack: unexpected disconnect
while reading sideband packet early EOF fetch-pack: invalid index-pack output
+ ```
+
+ 可以执行以下命令先拉取一个版本的代码,然后在获取全量代码.
+
+ ``` shell
+ git clone https://github.com/apache/shenyu.git --depth 1
+ cd ./shenyu
+ git fetch --unshallow
+ ```
+
+
+
### ShenYu 初启动
#### 准备工作
@@ -162,11 +181,11 @@ Apache ShenYu提供了Http、Dubbo、SpringCloud等应用接入shenyu网关的
1. 在[官网](https://nodejs.org/en)下载并安装Node.js ，选择 `LTS` 版本即可
2. 安装时，除了设置安装路径，其他一直点 `Next` 即可
3. 安装完成后，在命令行中进行验证：
-
+
```shell
C:\Users\pc>node -v
v12.22.12
-
+
C:\Users\pc>npm -v
6.14.16
```
