mirror of
https://github.com/alterware/alterware-launcher.git
synced 2025-12-04 07:17:50 +00:00
add CONTRIBUTING.md
This commit is contained in:
45
CONTRIBUTING.md
Normal file
45
CONTRIBUTING.md
Normal file
@@ -0,0 +1,45 @@
|
|||||||
|
# Contributing to AlterWare Launcher
|
||||||
|
|
||||||
|
We welcome contributions to the AlterWare Launcher! Here are some guidelines to follow:
|
||||||
|
|
||||||
|
> [!NOTE]
|
||||||
|
> Always run `cargo fmt` and `cargo clippy` to ensure your code is formatted correctly and passes lint checks.
|
||||||
|
|
||||||
|
### Prerequisites
|
||||||
|
|
||||||
|
- [Rust](https://rustup.rs/) - Install the latest stable version
|
||||||
|
- [Git](https://git-scm.com/) - For cloning the repository
|
||||||
|
- [Perl](https://www.perl.org/get.html) - [Linux only] Required for OpenSSL
|
||||||
|
|
||||||
|
### Build Steps
|
||||||
|
|
||||||
|
1. Clone the repository:
|
||||||
|
```bash
|
||||||
|
git clone https://github.com/mxve/alterware-launcher.git
|
||||||
|
cd alterware-launcher
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Build the project:
|
||||||
|
```bash
|
||||||
|
cargo build --release
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Find the executable:
|
||||||
|
The compiled binary will be located at `target/release/alterware-launcher(.exe)`
|
||||||
|
|
||||||
|
### Additional Notes
|
||||||
|
|
||||||
|
- Structs generally go in `src/structs.rs`
|
||||||
|
- Try to follow the existing coding style, make use of `cargo fmt` and `cargo clippy` to ensure consistency
|
||||||
|
- Use existing formatting, printing and helper functions when possible (see `src/misc.rs` and `src/extend.rs`)
|
||||||
|
- Unit tests go in `src/tests.rs`
|
||||||
|
- Make sure your code compiles on Windows and Unix targets
|
||||||
|
- The GitHub Actions currently only run on Linux
|
||||||
|
- You can use these to check for errors on unix platforms
|
||||||
|
- You have to verify your code on Windows manually
|
||||||
|
- For debugging, you can use `cargo build` without the `--release` flag. The debug build will be slower but includes additional debugging information.
|
||||||
|
- To run tests, use `cargo test`
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
By contributing to AlterWare Launcher, you agree that your contributions will be licensed under the [GPLv3 license](LICENSE).
|
||||||
27
README.md
27
README.md
@@ -173,32 +173,7 @@ alterware-launcher.exe iw4x --bonus -u --path "C:\Games\IW4x" --pass "-console"
|
|||||||
|
|
||||||
## 🔨 Building from Source
|
## 🔨 Building from Source
|
||||||
|
|
||||||
### Prerequisites
|
See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
|
||||||
|
|
||||||
- [Rust](https://rustup.rs/) - Install the latest stable version
|
|
||||||
- [Git](https://git-scm.com/) - For cloning the repository
|
|
||||||
- [Perl](https://www.perl.org/get.html) - [Linux only] Required for OpenSSL
|
|
||||||
|
|
||||||
### Build Steps
|
|
||||||
|
|
||||||
1. Clone the repository:
|
|
||||||
```bash
|
|
||||||
git clone https://github.com/mxve/alterware-launcher.git
|
|
||||||
cd alterware-launcher
|
|
||||||
```
|
|
||||||
|
|
||||||
2. Build the project:
|
|
||||||
```bash
|
|
||||||
cargo build --release
|
|
||||||
```
|
|
||||||
|
|
||||||
3. Find the executable:
|
|
||||||
The compiled binary will be located at `target/release/alterware-launcher(.exe)`
|
|
||||||
|
|
||||||
### Additional Notes
|
|
||||||
|
|
||||||
- For debugging, you can use `cargo build` without the `--release` flag. The debug build will be slower but includes additional debugging information.
|
|
||||||
- To run tests, use `cargo test`
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user