Updated Wiki content

SoftFever
2025-10-29 12:56:30 +00:00
parent 6ad9e54be0
commit 7aec927837
3 changed files with 39 additions and 6 deletions

@@ -152,6 +152,7 @@ OrcaSlicer is a powerful open source slicer for FFF (FDM) 3D Printers. This wiki
![im_code](https://github.com/SoftFever/OrcaSlicer/blob/main/resources/images/im_code.svg?raw=true) This is a documentation from someone exploring the code and is by no means complete or even completely accurate. Please edit the parts you might find inaccurate. This is probably going to be helpful nonetheless. ![im_code](https://github.com/SoftFever/OrcaSlicer/blob/main/resources/images/im_code.svg?raw=true) This is a documentation from someone exploring the code and is by no means complete or even completely accurate. Please edit the parts you might find inaccurate. This is probably going to be helpful nonetheless.
- [How to build OrcaSlicer](How-to-build) - [How to build OrcaSlicer](How-to-build)
- [How to run tests](How-to-test)
- [Localization and translation guide](Localization_guide) - [Localization and translation guide](Localization_guide)
- [How to create profiles](How-to-create-profiles) - [How to create profiles](How-to-create-profiles)
- [How to contribute to the wiki](How-to-wiki) - [How to contribute to the wiki](How-to-wiki)

@@ -279,9 +279,9 @@ The build system supports multiple Linux distributions including Ubuntu/Debian a
./build_linux.sh -d ./build_linux.sh -d
``` ```
3. **Build OrcaSlicer:** 3. **Build OrcaSlicer with tests:**
```shell ```shell
./build_linux.sh -s ./build_linux.sh -st
``` ```
4. **Build AppImage (optional):** 4. **Build AppImage (optional):**
@@ -291,14 +291,15 @@ The build system supports multiple Linux distributions including Ubuntu/Debian a
5. **All-in-one build (recommended):** 5. **All-in-one build (recommended):**
```shell ```shell
./build_linux.sh -dsi ./build_linux.sh -dsti
``` ```
**Additional build options:** **Additional build options:**
- `-b`: Build in debug mode - `-b`: Build in debug mode (mostly broken at runtime for a long time; avoid unless you want to be fixing failed assertions)
- `-c`: Force a clean build - `-c`: Force a clean build
- `-C`: Enable ANSI-colored compile output (GNU/Clang only) - `-C`: Enable ANSI-colored compile output (GNU/Clang only)
- `-e`: Build RelWithDebInfo (release + symbols)
- `-j N`: Limit builds to N cores (useful for low-memory systems) - `-j N`: Limit builds to N cores (useful for low-memory systems)
- `-1`: Limit builds to one core - `-1`: Limit builds to one core
- `-l`: Use Clang instead of GCC - `-l`: Use Clang instead of GCC
@@ -309,10 +310,14 @@ The build system supports multiple Linux distributions including Ubuntu/Debian a
> The build script automatically detects your Linux distribution and uses the appropriate package manager (apt, pacman) to install dependencies. > The build script automatically detects your Linux distribution and uses the appropriate package manager (apt, pacman) to install dependencies.
> [!TIP] > [!TIP]
> For first-time builds, use `./build_linux.sh -u` to install dependencies, then `./build_linux.sh -dsi` to build everything. > For first-time builds, use `./build_linux.sh -u` to install dependencies, then `./build_linux.sh -dsti` to build everything.
> [!WARNING] > [!WARNING]
> If you encounter memory issues during compilation, use `-j 1` or `-1` to limit parallel compilation, or `-r` to skip memory checks. > If you encounter memory issues during compilation, use `-j 1` or `-1` to limit parallel compilation and `-r` to skip memory checks.
#### Unit Testing
See [How to Test](How-to-test) for more details.
--- ---

@@ -0,0 +1,27 @@
# How to Test
This wiki page describes how to build and run tests on Linux. It should eventually provide guidance on how to add tests for a new feature.
## Build Tests
Can be built when you are building Orca Slicer binary by including the `-t` flag for `build_linux.sh`:
```
build_linux.sh -st
```
Test binaries will then appear under `build/tests`. As of this writing, not all tests will be built.
## Run Unit Tests
### Run All
```
ctest --test-dir build/tests
```
### Run a Specific Set
```
ctest --test-dir build/tests/slic3rutils
```