mirror of
https://github.com/ankitects/anki.git
synced 2026-01-11 04:53:55 -05:00
Add Windows quick start guide for new contributors
This commit is contained in:
parent
2d4de33cf3
commit
586183f327
1 changed files with 129 additions and 0 deletions
129
docs/windows_quick_start.md
Normal file
129
docs/windows_quick_start.md
Normal file
|
|
@ -0,0 +1,129 @@
|
||||||
|
# Windows Quick Start Guide
|
||||||
|
|
||||||
|
> A simplified and beginner-friendly version of Anki’s official Windows documentation.
|
||||||
|
> Ideal for first-time contributors building Anki on Windows.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Minimum Requirements
|
||||||
|
|
||||||
|
- **64-bit Windows 10** (version 1703 or newer)
|
||||||
|
- Administrator access to install software
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Step 1 – Install Rust (rustup)
|
||||||
|
|
||||||
|
Anki uses the **Rust programming language** for parts of its codebase.
|
||||||
|
|
||||||
|
1. Visit the official Rust website
|
||||||
|
2. Download and install **rustup**
|
||||||
|
3. During installation, accept the default options
|
||||||
|
|
||||||
|
> **Windows ARM users**
|
||||||
|
> After installing rustup, run the following command in a terminal, inside the project folder:
|
||||||
|
>
|
||||||
|
> ```bash
|
||||||
|
> rustup target add x86_64-pc-windows-msvc
|
||||||
|
> ```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Step 2 – Install Visual Studio
|
||||||
|
|
||||||
|
1. Download **Visual Studio Community Edition**
|
||||||
|
2. Open the installer
|
||||||
|
3. Select:
|
||||||
|
- **Desktop Development with C++**
|
||||||
|
4. Leave the advanced options unchanged
|
||||||
|
|
||||||
|
> **Note**
|
||||||
|
> This step is required to compile native parts of the project.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Step 3 – Install MSYS2
|
||||||
|
|
||||||
|
1. Visit the [MSYS2](https://www.msys2.org/) website
|
||||||
|
2. Install it in the default location
|
||||||
|
3. After installation, open the MSYS2 terminal
|
||||||
|
4. Run the following command:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pacman -S git rsync
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Step 4 – Configure the PATH Environment Variable
|
||||||
|
|
||||||
|
1. Open **Windows Environment Variables**
|
||||||
|
2. Edit the **PATH** variable
|
||||||
|
3. Add the following path:
|
||||||
|
|
||||||
|
```text
|
||||||
|
C:\msys64\usr\bin
|
||||||
|
```
|
||||||
|
|
||||||
|
4. Reboot your computer
|
||||||
|
|
||||||
|
> **Important note**
|
||||||
|
> If you already use **Git for Windows** (for example, [posh-git](https://github.com/dahlbyk/posh-git) in PowerShell), it may conflict with the MSYS2 Git.
|
||||||
|
>
|
||||||
|
> - Prefer using [Git for Windows](https://gitforwindows.org/)
|
||||||
|
> - Ensure the `rsync` command is available
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Step 5 – Choose a Good Source Code Location
|
||||||
|
|
||||||
|
To avoid build issues:
|
||||||
|
|
||||||
|
- Avoid long directory paths
|
||||||
|
- Avoid spaces in folder names
|
||||||
|
|
||||||
|
**Recommended**:
|
||||||
|
```text
|
||||||
|
C:\anki
|
||||||
|
```
|
||||||
|
|
||||||
|
**Problematic**:
|
||||||
|
```text
|
||||||
|
C:\Users\Your Name\Documents\Projects\Anki Source Code
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Audio Support (Optional)
|
||||||
|
|
||||||
|
To play and record audio during development, ensure the following executables are available in your **PATH**:
|
||||||
|
|
||||||
|
- `mpv.exe`
|
||||||
|
- `lame.exe`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Common Problems
|
||||||
|
|
||||||
|
### Build errors
|
||||||
|
- Make sure Visual Studio was installed with **Desktop Development with C++**
|
||||||
|
|
||||||
|
### `git` command not found
|
||||||
|
- Verify that the PATH variable is configured correctly
|
||||||
|
|
||||||
|
### Issues caused by spaces in paths
|
||||||
|
- Move the project to a shorter path, such as `C:\anki`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Next Steps
|
||||||
|
|
||||||
|
For advanced topics such as running tests or building wheels, see:
|
||||||
|
|
||||||
|
- `development.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
> **Note**
|
||||||
|
> This guide does not replace the official documentation. It is intended to make the first steps easier for new Anki contributors on Windows.
|
||||||
|
|
||||||
Loading…
Reference in a new issue