mirror of
https://github.com/MeexReay/bRAC.git
synced 2025-06-24 02:42:57 +03:00
85 lines
2.7 KiB
Markdown
85 lines
2.7 KiB
Markdown
# How to compile it
|
|
|
|
## Windows
|
|
|
|
1. Install [rustup](https://rustup.rs/)
|
|
2. Install [MSVC](https://visualstudio.microsoft.com/visual-cpp-build-tools/) and run `rustup default stable-msvc`
|
|
3. Extract [GTK4 from gvsbuild](https://github.com/wingtk/gvsbuild/releases/latest) to `C:\gtk`
|
|
4. Update environment variables:
|
|
- Go to Start, search for 'Advanced system settings' (or click on Properties of My Computer in the Explorer, then you'll find 'Advanced system settings')
|
|
- Click 'Environment Variables...'
|
|
- Add `C:\gtk\lib\pkgconfig` to the PKG_CONFIG_PATH variable (or create one if doesnt exist)
|
|
- Add `C:\gtk\bin` to the PATH variable (or create one if doesnt exist)
|
|
- Add `C:\gtk\lib` to the Lib variable (or create one if doesnt exist)
|
|
- Apply and close the window (maybe restart PC)
|
|
5. Open the repository directory in console (download it from github or with `git clone https://github.com/MeexReay/bRAC.git`)
|
|
6. Run `cargo build -r -F winapi,notify-rust`
|
|
7. Done! Your finished binary is in the `target/release` folder.
|
|
|
|
## Linux / MacOS
|
|
|
|
1. Install `rust`, `openssl-dev`, `gtk4-dev` with your package manager
|
|
2. Open the repository directory in console (download it from github or with `git clone https://github.com/MeexReay/bRAC.git`)
|
|
3. Run `cargo build -r`
|
|
4. Done! Your finished binary is in the `target/release` folder.
|
|
|
|
# Troubleshooting
|
|
|
|
## Windows
|
|
|
|
### Black frame around the window
|
|
|
|
Black frame appears on connecting to the server or when bRAC just freezes. Be patient.
|
|
|
|
## MacOS
|
|
|
|
### Notifications dont work
|
|
|
|
There are two solutions:
|
|
|
|
- Switch to `libnotify`:
|
|
|
|
Add the feature `libnotify` to cargo: `cargo build -r -F libnotify`
|
|
|
|
- Switch to `notify-rust`:
|
|
|
|
Add the feature `notify-rust` to cargo: `cargo build -r -F notify-rust`
|
|
|
|
## Linux
|
|
|
|
### Notifications dont work
|
|
|
|
There are two solutions:
|
|
|
|
- Switch to `libnotify`:
|
|
|
|
Just add the new feature to cargo: `cargo build -r -F libnotify` \
|
|
Libnotify sucks in many situations, but it always work
|
|
|
|
- Make a desktop file:
|
|
|
|
Enter the repository folder and run: `./misc/create-desktop.sh` \
|
|
You'll get a desktop file contents, just edit paths here and write it to a new file in the `~/.local/share/applications` or `/usr/share/applications`\
|
|
All of these, with adding icons and other, makes this command: `make install` (using `gnumake` package) \
|
|
But make sure, that you have `.local/bin` in the `PATH` variable, otherwise it won't work. \
|
|
Now, if you'll run with the desktop file, GNotifications will work perfectly.
|
|
|
|
# Cross-compiling
|
|
|
|
## From Linux to Windows
|
|
|
|
```bash
|
|
./misc/build.sh
|
|
```
|
|
|
|
## From NixOS to Windows
|
|
|
|
```bash
|
|
nix-shell -p rustup gcc cargo-cross
|
|
rustup toolchain install stable
|
|
./misc/build.sh
|
|
```
|
|
|
|
## From Windows to Linux
|
|
|
|
That's your problem |