mirror of
https://github.com/italicsjenga/agb.git
synced 2024-12-23 00:01:34 +11:00
added windows instructions for setup
This commit is contained in:
parent
38f3dfd339
commit
74e1ca879a
|
@ -5,7 +5,7 @@
|
|||
- [Running an example](./setup/getting_started.md)
|
||||
- [Environment setup](./setup/setup.md)
|
||||
- [Linux setup](./setup/linux.md)
|
||||
- [Windows setup]()
|
||||
- [Windows setup](./setup/windows.md)
|
||||
- [Mac OS setup](./setup/mac.md)
|
||||
- [Building the template](./setup/building.md)
|
||||
- [Learn agb part I - pong](./pong/01_introduction.md)
|
||||
|
|
37
book/src/setup/windows.md
Normal file
37
book/src/setup/windows.md
Normal file
|
@ -0,0 +1,37 @@
|
|||
# Windows setup
|
||||
|
||||
This guide has been tested on Windows 11 using PowerShell with elevated rights _(dont use cmd)_.
|
||||
|
||||
# 1. Install a recent version of rust
|
||||
|
||||
To use agb, you'll need to use nightly rust since it requires a few nightly features.
|
||||
Firstly, ensure that you have **rustup** installed which you can do by following the instructions on the [rust website](https://www.rust-lang.org/tools/install)
|
||||
|
||||
If you have installed rustup, you can update it with `rustup update`.
|
||||
If the `rustup`-command fails, you'll most probably add the cargo/bin folder to the Path-environment variable.
|
||||
|
||||
|
||||
# 2. git
|
||||
|
||||
The source code for the game is hosted on github, so you will need to install git.
|
||||
|
||||
You'd need to follow this official github git [guide](https://github.com/git-guides/install-git).
|
||||
|
||||
# 3. mGBA
|
||||
|
||||
We recommend using the mGBA emulator which you can download for Mac [here](https://mgba.io/downloads.html).
|
||||
|
||||
After installing, you can add the binary to your Path-environment variable and create an alias for the agb run command to use.
|
||||
|
||||
Creating link for mgba-qt:
|
||||
```PS
|
||||
New-Item -itemtype hardlink -path "C:\Program Files\mGBA\mgba-qt.exe" -value "C:\Program Files\mGBA\mGBA.exe"
|
||||
```
|
||||
|
||||
# 4. gbafix
|
||||
|
||||
In order to be able to play games made with agb on real hardware or on some emulators, you will need to install 'agb-gbafix'.
|
||||
Agb's implementation can be installed very easily using `cargo install agb-gbafix`.
|
||||
|
||||
That is all you need to get started!
|
||||
You can now move on to 'building the game'.
|
Loading…
Reference in a new issue