mirror of
https://github.com/ankitects/anki.git
synced 2026-01-07 02:53:54 -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