Skip to content

Commit f1bb719

Browse files
authored
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.
1 parent 86788bd commit f1bb719

File tree

2 files changed

+41
-7
lines changed

2 files changed

+41
-7
lines changed

blog/Start-SourceCode-Analysis-Start-Demo-for-Contributor.md

+16-1
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,9 @@ As a first-time developer in the `Shenyu` community, I encountered some "Pitfall
1313

1414
## Environmental Preparation
1515

16-
- Correct local installation of `JDK1.8+`
16+
- Correct local installation of `JDK17+`
1717
- Properly install `Git` locally
18+
- Correctly install Maven `3.6.3+`
1819
- Choose a development tool, this article uses `IDEA` as an example
1920

2021
## ShenYu Backend Startup Guide
@@ -91,6 +92,20 @@ Maven is a cross-platform project management tool . As the Apache organization's
9192
git config --global core.longpaths true
9293
```
9394

95+
Tips: If you encounter the following error or have network issues preventing you from pulling all the code:
96+
97+
``` tex
98+
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
99+
```
100+
101+
You can execute the following commands to first pull a single version of the code, then fetch the full code:
102+
103+
``` shell
104+
git clone https://github.com/apache/shenyu.git --depth 1
105+
cd ./shenyu
106+
git fetch --unshallow
107+
```
108+
94109
### ShenYu First Start
95110
96111
#### Preparation

i18n/zh/docusaurus-plugin-content-blog/Start-SourceCode-Analysis-Start-Demo-for-Contributor.md

+25-6
Original file line numberDiff line numberDiff line change
@@ -13,12 +13,15 @@ tags: [first-start,Apache ShenYu]
1313

1414
## 环境准备
1515

16-
- 本地正确安装 `JDK1.8+`
16+
- 本地正确安装 `JDK17` 或更高版本
1717
- 本地正确安装 `Git`
18+
- 本地正确安装`Maven3.63` 或更高版本
1819
- 选择一款开发工具,本文使用 `IDEA` 为例
1920

2021
## ShenYu 后端启动指南
2122

23+
24+
2225
### 安装并配置Maven
2326

2427
Maven是一个跨平台的项目管理工具。作为Apache组织顶级开源项目,其主要服务于基于Java平台的项目创建,依赖管理和项目信息管理。
@@ -50,21 +53,21 @@ Maven是一个跨平台的项目管理工具。作为Apache组织顶级开源项
5053
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
5154
<mirrorOf>central</mirrorOf>
5255
</mirror>
53-
56+
5457
<mirror>
5558
<id>alimaven</id>
5659
<mirrorOf>central</mirrorOf>
5760
<name>aliyun maven</name>
5861
<url>http://maven.aliyun.com/nexus/content/repositories/central/</url>
5962
</mirror>
60-
63+
6164
<mirror>
6265
<id>maven</id>
6366
<mirrorOf>central</mirrorOf>
6467
<name>name_</name>
6568
<url>http://repo1.maven.org/maven2</url>
6669
</mirror>
67-
70+
6871
<mirror>
6972
<id>junit</id>
7073
<mirrorOf>central</mirrorOf>
@@ -91,6 +94,22 @@ Maven是一个跨平台的项目管理工具。作为Apache组织顶级开源项
9194
git config --global core.longpaths true
9295
```
9396

97+
Tips: 如果提示如下错误或者网络不好无法拉取全部代码:
98+
99+
``` tex
100+
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
101+
```
102+
103+
可以执行以下命令先拉取一个版本的代码,然后在获取全量代码.
104+
105+
``` shell
106+
git clone https://github.com/apache/shenyu.git --depth 1
107+
cd ./shenyu
108+
git fetch --unshallow
109+
```
110+
111+
112+
94113
### ShenYu 初启动
95114
96115
#### 准备工作
@@ -162,11 +181,11 @@ Apache ShenYu提供了Http、Dubbo、SpringCloud等应用接入shenyu网关的
162181
1. 在[官网](https://nodejs.org/en)下载并安装Node.js ,选择 `LTS` 版本即可
163182
2. 安装时,除了设置安装路径,其他一直点 `Next` 即可
164183
3. 安装完成后,在命令行中进行验证:
165-
184+
166185
```shell
167186
C:\Users\pc>node -v
168187
v12.22.12
169-
188+
170189
C:\Users\pc>npm -v
171190
6.14.16
172191
```

0 commit comments

Comments
 (0)