mirror of
https://github.com/86Box/docs.git
synced 2026-02-22 01:25:34 -07:00
40 lines
2.6 KiB
ReStructuredText
40 lines
2.6 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. The Jenkins page will automatically detect the recommended variant for the system you're viewing it on, but if you're downloading builds for a different system (or you have disabled JavaScript), 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.
|
|
|
|
.. note:: Debug variants have been moved to a `special page on the 86Box website <//86box.net/debug.html>`_ as of July 18th 2022.
|
|
|
|
Discontinued variants
|
|
^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
* 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.
|
|
* Optimized binaries can still be produced by :doc:`compiling 86Box from source <buildguide>` with the ``--preset=optimized`` CMake flag, which enables optimizations for the build host's CPU microarchitecture. No support will be provided for those.
|