mirror of
https://github.com/86Box/docs.git
synced 2026-02-22 01:25:34 -07:00
43 lines
2.4 KiB
ReStructuredText
43 lines
2.4 KiB
ReStructuredText
Advanced builds
|
|
===============
|
|
|
|
The `86Box Jenkins <https://ci.86box.net/job/86Box/>`_ provides all kinds of pre-release testing builds for advanced users. These are linked to the `86Box git repository on GitHub <https://github.com/86Box/86Box>`_; a new build is produced with the latest source code every time the repository is updated.
|
|
|
|
.. important:: Testing builds are development snapshots which may contain bugs, unfinished features or other issues. These should only be used if you know what you're doing.
|
|
|
|
Variants
|
|
--------
|
|
|
|
86Box builds are available in a number of variants. Use the guide below to select a variant:
|
|
|
|
* The **Old Recompiler** is recommended. The **New Recompiler** is in beta; you may experience bugs and performance loss with it.
|
|
|
|
* The Old Recompiler is not available for the ARM architecture. You must select the New Recompiler for running 86Box on ARM Linux systems such as the Raspberry Pi.
|
|
|
|
* On **Windows**, **x86 (32-bit)** is recommended even if you have a 64-bit system.
|
|
|
|
* x64 (64-bit) allows for emulating more than 2 GB of RAM on some later machines and using larger soundfonts with FluidSynth, at a slight performance loss.
|
|
|
|
* On **Linux**, select the correct architecture for your system, as most distributions lack x64-to-x86 and ARM64-to-ARM32 backwards compatibility by default.
|
|
|
|
* On **macOS**, **Universal** supports both Intel and Apple Silicon Macs.
|
|
|
|
* The New Recompiler is always used on Apple Silicon due to its ARM architecture, even if the Old Recompiler is selected.
|
|
|
|
Discontinued variants
|
|
^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
These variants are no longer built by Jenkins and can only be :doc:`compiled from source <buildguide>`.
|
|
|
|
* Debug variants (**86Box-Debug**) as of April 2nd 2023.
|
|
|
|
* These variants were compiled with debug symbols and reduced optimizations to help with running the emulator under ``gdb`` or other debuggers. They were eliminated as the setup process for debugging grew closer to just compiling from source instead.
|
|
|
|
* Dev variants (**86Box-Dev** and **86Box-DevODR**) as of November 18th 2021.
|
|
|
|
* These variants contained incomplete and experimental features subject to change at any time, with the -Dev variant also containing the New Recompiler beta.
|
|
|
|
* Optimized variants (**86Box-Optimized**) as of March 18th 2021.
|
|
|
|
* These variants' aggressive microarchitecture-specific optimizations provided very little performance improvement (within margin of error on modern CPUs) while introducing bugs and other incorrect behavior.
|