Merge pull request #36 from ExMingYan/master

翻译WSL安装指南
This commit is contained in:
RoamerX 2025-04-28 10:18:54 +08:00 committed by GitHub
commit 2c632a39ff
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 119 additions and 3 deletions

View File

@ -3,7 +3,7 @@
每个支持的操作系统的安装说明可在 `docs/install/` 目录下的对应子目录中找到。
各个系统的链接列在各自的标题下。
本文件仅包含对每个支持系统的简要介绍。
如果遇到问题,请在 Discord 上寻求帮助(见 [README.md](README.md))。
如果遇到问题,请在 Discord 上寻求帮助(见 [README_ZH.md](README_ZH.md))。
完成对应操作系统的安装说明后,继续阅读 [构建 pokeemerald-expansion](#构建-pokeemerald-expansion)。
@ -20,7 +20,7 @@
**注意**:仅推荐使用 WSL 系统。
[WSL 安装说明](docs/install/windows/WSL.md)
[WSL 安装说明](docs/install/windows/WSL_ZH.md)
[Msys2 安装说明](docs/install/windows/MSYS2.md)

View File

@ -45,7 +45,7 @@ pokeemerald-expansion是基于pret的[pokeemerald](https://github.com/pret/pokee
***重要提示***不要使用GitHub的“Download Zip”选项。使用这个选项将无法下载更新你的扩展版本或合并其他功能分支所需的提交历史。相反请阅读[此指南](https://github.com/Pawkkie/Team-Aquas-Asset-Repo/wiki/The-Basics-of-GitHub)以了解如何分叉存储库并从那里本地克隆。
请按照`INSTALL.md`中的说明在你的机器上设置pokeemerald-expansion。
请按照[`INSTALL_ZH.md`](INSTALL_ZH.md)中的说明在你的机器上设置pokeemerald-expansion。
### 如果我已经有一个基于原版pokeemerald的项目我可以使用pokeemerald-expansion吗

View File

@ -0,0 +1,116 @@
# Windows WSL指南
## 选择WSL版本
- 如果你想将项目存放在Windows系统中优先选择WSL1。
- 如果你想获得最佳性能并尽量减少 Windows 干扰项目编译的问题,请使用 WSL2 并将项目存放在 Linux 文件系统中(位于 ~/ 目录下)。
## 安装 WSL
1. 以管理员模式打开 [Windows Powershell](https://i.imgur.com/QKmVbP9.png) 执行下面的命令 (鼠标右键或按下Shift+Insert以粘贴到Powershell)。
- WSL1
```powershell
wsl --install -d Ubuntu --enable-wsl1
```
- WSL2
```powershell
wsl --install -d Ubuntu
```
2. 等待命令完成后重启你的电脑
### WSL1
3. 重启后以管理员模式打开Powershell 执行下面的命令将Ubuntu版本设置为WSL1。
```powershell
wsl --set-version Ubuntu 1
```
### WSL2
3. 重启后以管理员模式打开Powershell 执行下面的命令将Ubuntu版本设置为WSL2。
```powershell
wsl --set-version Ubuntu 2
```
<details>
<summary><i>注意...</i></summary>
> 重启后WSL可能会自动启动但这并不会影响什么。
</details>
### 查看WSL版本
4. 以管理员模式打开Powershell执行下面的命令
```powershell
wsl --list -v
```
## 安装依赖项
注意事项:
- WSL中复制/粘贴方法
- **鼠标右键** (选中后右键单击复制,未选中内容时右键单击粘贴)
- **Ctrl+Shift+C/Ctrl+Shift+V** (右键单击标题栏,确认已勾选"使用Ctrl+Shift+C/V作为复制/粘贴快捷键")。
- 执行部分命令时需要输入WSL用户密码或手动确认。在需要确认时根据提示输入WSL用户密码或yes/y即可
1. 启动**Ubuntu** 比如在搜索中启动)。
2. 第一次启动WSL/Ubuntu时将会自动完成安装。等待WSL/Ubuntu安装结束后需要设置用户名和密码
<details>
<summary><i>Note...</i></summary>
> 输入密码时WSL不会显示输入的内容但它仍在正常获取输入的字符。
</details>
3. 通过下面的命令更新WSL这可能需要一段时间
```bash
sudo apt update && sudo apt upgrade
```
4. 执行下面的命令以安装编译pokeemerald-expansion的依赖项
```bash
sudo apt install build-essential binutils-arm-none-eabi gcc-arm-none-eabi libnewlib-arm-none-eabi git libpng-dev python3
```
## 在WSL1中设置源码存放位置
Windows不能直接访问WSL的文件但WSL可以直接访问Windows文件。因此可以将文件存放在Windows系统中。
假设你想将pokeemerald Expansion存放在**C:\Users\\_\<user>_\Desktop\decomps**目录。首先确认这个文件夹存在。然后输入下面的命令进入该文件夹(**\<user>**指Windows系统用户名
```bash
cd /mnt/c/Users/<user>/Desktop/decomps
```
<details>
<summary><i>注意……</i></summary>
> 1: Windows C:\ 盘在WSL中对应/mnt/c/。
> 2: 如果路径中包含空格,则必须用"将整个路径包围起来,例如`"/mnt/c/users/<user>/Desktop/decomp folder"`
> 3: Windows路径是大小写不敏感的所以无需注意大小写问题。
</details>
## 在WSL2中设置源码存放位置
Windows不能直接访问WSL的文件但WSL可以直接访问Windows文件。但在WSL2中访问Windows文件速度很慢因此最好将文件存放在WSL2中。
要从 Windows 访问 WSL中的文件你需要在文件资源管理器中将 WSL 文件系统作为网络附加存储打开它应该位于左侧边栏的底部显示为“Linux”。
在WSL中运行下面的命令以创建一个文件夹用于存放pokeemerald-expansion如果这个文件夹不存在
```bash
cd ~/
mkdir decomps
```
运行下面的命令进入存放pokeemerald-expansion的文件夹
```bash
cd ~/decomps
```