joncampbell123/dosbox-x
1
0
Fork 0
mirror of https://github.com/joncampbell123/dosbox-x.git synced 2025-05-09 03:41:10 +08:00
Code Issues Packages Projects Releases Wiki Activity

Update INSTALL.md

Browse Source
This commit is contained in:
Wengier 2022-01-01 01:49:31 -05:00 committed by GitHub
parent 31a9cb16eb
commit 28f55adf8a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 24 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
INSTALL.md
View File

@ -3,9 +3,9 @@ DOSBox-X Installation and Released Packages
DOSBox-X is a cross-platform DOS emulator based on DOSBox, with the eventual goal of being a complete DOS emulation package. New versions of DOSBox-X are released periodically, typically on the last day of a month or the first day of the next month. Since DOSBox-X is cross-platform, all major host operating systems are officially supported including Windows (XP or later), Linux (with X11), macOS (10.12 or later) and DOS operating systems.
The current version of DOSBox-X at this time is DOSBox-X 0.83.20, which was released on November 30, 2021. Pre-compiled Windows binaries (both 32-bit and 64-bit), Linux Flatpak and RPM packages (64-bit), macOS packages (64-bit) and the special HX-DOS packages (for real DOS environments) are officially available, as well as the Windows installers and source code packages. You will find DOSBox-X versions that have been released so far (ZIP or RPM packages) and change logs for these versions in the [Releases](https://github.com/joncampbell123/dosbox-x/releases) page.
The current version of DOSBox-X at this time is DOSBox-X 0.83.21, which was released on December 31, 2021. Pre-compiled Windows binaries (both 32-bit and 64-bit), Linux Flatpak and RPM packages (64-bit), macOS packages (64-bit) and the special HX-DOS packages (for real DOS environments) are officially available, as well as the Windows installers and source code packages. You will find DOSBox-X versions that have been released so far (ZIP or RPM packages) and change logs for these versions in the [Releases](https://github.com/joncampbell123/dosbox-x/releases) page.
See also: [DOSBox-X 0.83.20 Release Notes](https://dosbox-x.com/release-0.83.20.html)
See also: [DOSBox-X 0.83.21 Release Notes](https://dosbox-x.com/release-0.83.21.html)
For most packages there are both SDL1 and SDL2 builds of DOSBox-X, and most features are the same for both builds. While SDL1 builds may be the default one to use, you may want to try SDL2 builds if you want certain features specific to SDL2 builds (such as the raw mouse input option) or you encounter specific issue(s) with SDL1 builds (such as incorrect keys in some international keyboard layouts).
@ -21,23 +21,23 @@ Once you get DOSBox-X installed and running, you probably want to look at the DO
## Windows Packages (Installer or Portable)
You probably want to use the all-in-one Windows installation packages for the ease of installation, which are especially recommended for new and non-expert users. With the installer the installation process will be automated while allowing you to change the install folder and the default build to run if you prefer (and the option to install all builds to subdirectories), so that you will be able to start DOSBox-X as soon as the installation ends. A quick start guide is also included in the package, and shell context menus can be automatically added for a fast launch of DOSBox-X from the Windows Explorer. The Windows installers for the current DOSBox-X version 0.83.20 are available from:
You probably want to use the all-in-one Windows installation packages for the ease of installation, which are especially recommended for new and non-expert users. With the installer the installation process will be automated while allowing you to change the install folder and the default build to run if you prefer (and the option to install all builds to subdirectories), so that you will be able to start DOSBox-X as soon as the installation ends. A quick start guide is also included in the package, and shell context menus can be automatically added for a fast launch of DOSBox-X from the Windows Explorer. The Windows installers for the current DOSBox-X version 0.83.21 are available from:
* [dosbox-x-win32-0.83.20-setup.exe](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.20/dosbox-x-win32-0.83.20-setup.exe) (32-bit Windows builds; Windows XP or later)
* [dosbox-x-win64-0.83.20-setup.exe](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.20/dosbox-x-win64-0.83.20-setup.exe) (64-bit Windows builds; Windows Vista or later)
* [dosbox-x-win32-0.83.21-setup.exe](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.21/dosbox-x-win32-0.83.21-setup.exe) (32-bit Windows builds; Windows XP or later)
* [dosbox-x-win64-0.83.21-setup.exe](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.21/dosbox-x-win64-0.83.21-setup.exe) (64-bit Windows builds; Windows Vista or later)
If you see the message ```Windows Defender SmartScreen prevented an unrecognized app from starting``` when running an installer, you can solve it by clicking the link "More info" in the dialog and then "Run anyway".
You can easily upgrade from a previous version of DOSBox-X to the new version with the Windows installer. The Windows installer in fact offers an option to automatically upgrade the config file (dosbox-x.conf) to the new version format while keeping all the user-customized settings already made. When you select this (recommended), the config file will include all options of the latest DOSBox-X version and also will keep all the changes already done previously by the user.
Apart from the Windows installers, you can find six zip packages (three before 0.83.13) for each DOSBox-X version for the Windows platform in the [Releases](https://github.com/joncampbell123/dosbox-x/releases) page as an alternative way to install DOSBox-X. These zip files are portable packages containing binaries built with Visual Studio 2019 (Win32, Win64, ARM32, ARM64 respectively), MinGW (Win32 and Win64 respectively). For the current DOSBox-X version 0.83.20, these portable builds are separately available from:
Apart from the Windows installers, you can find six zip packages (three before 0.83.13) for each DOSBox-X version for the Windows platform in the [Releases](https://github.com/joncampbell123/dosbox-x/releases) page as an alternative way to install DOSBox-X. These zip files are portable packages containing binaries built with Visual Studio 2019 (Win32, Win64, ARM32, ARM64 respectively), MinGW (Win32 and Win64 respectively). For the current DOSBox-X version 0.83.21, these portable builds are separately available from:
* [dosbox-x-vsbuild-win32-20211130230328.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.20/dosbox-x-vsbuild-win32-20211130230328.zip) (Visual Studio Win32 builds)
* [dosbox-x-vsbuild-win64-20211130230328.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.20/dosbox-x-vsbuild-win64-20211130230328.zip) (Visual Studio Win64 builds)
* [dosbox-x-vsbuild-arm32-20211130230328.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.20/dosbox-x-vsbuild-arm32-20211130230328.zip) (Visual Studio ARM32 builds)
* [dosbox-x-vsbuild-arm64-20211130230328.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.20/dosbox-x-vsbuild-arm64-20211130230328.zip) (Visual Studio ARM64 builds)
* [dosbox-x-mingw-win32-20211201234567.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.20/dosbox-x-mingw-win32-20211201234567.zip) (MinGW Win32 builds)
* [dosbox-x-mingw-win64-20211201234567.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.20/dosbox-x-mingw-win64-20211201234567.zip) (MinGW Win64 builds)
* [dosbox-x-vsbuild-win32-20211231200702.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.21/dosbox-x-vsbuild-win32-20211231200702.zip) (Visual Studio Win32 builds)
* [dosbox-x-vsbuild-win64-20211231200702.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.21/dosbox-x-vsbuild-win64-20211231200702.zip) (Visual Studio Win64 builds)
* [dosbox-x-vsbuild-arm32-20211231200702.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.21/dosbox-x-vsbuild-arm32-20211231200702.zip) (Visual Studio ARM32 builds)
* [dosbox-x-vsbuild-arm64-20211231200702.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.21/dosbox-x-vsbuild-arm64-20211231200702.zip) (Visual Studio ARM64 builds)
* [dosbox-x-mingw-win32-20211231123456.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.21/dosbox-x-mingw-win32-20211231123456.zip) (MinGW Win32 builds)
* [dosbox-x-mingw-win64-20211231123456.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.21/dosbox-x-mingw-win64-20211231123456.zip) (MinGW Win64 builds)
The Visual Studio builds are the default Windows builds to use, which include the debugger. On the other hand, standard MinGW builds of DOSBox-X versions support the Slirp backend for the NE2000 networking, but as of recent versions they won't run on Windows XP except for the lowend builds. You may also want to use one of the MinGW builds if you encounter specific problem(s) with the Visual Studio builds (such as floating point precision issues). In addition, while the SDL1 version is the default version, which uses the native Windows menus, the SDL2 version may be preferred over the SDL1 version for certain features (particularly related to input handling) such as better international keyboard support.
@ -112,10 +112,13 @@ But please note that this package is not built or updated by the DOSBox-X Team.
## macOS Packages (Portable)
If you use macOS as your operating system, we also release portable packages for the macOS (64-bit) platform. For the current DOSBox-X version 0.83.20, the official macOS packages are available as zip packages:
If you use macOS as your operating system, we also release portable packages for the macOS (64-bit) platform. For the current DOSBox-X version 0.83.21, the official macOS packages are available as zip packages:
For 64-bit Intel-based macOS:
* [dosbox-x-macosx-x86_64-20211130202141.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.20/dosbox-x-macosx-x86_64-20211130202141.zip)
* [dosbox-x-macosx-x86_64-20211231180318.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.21/dosbox-x-macosx-x86_64-20211231180318.zip)
For 64-bit ARM-based macOS:
* [dosbox-x-macosx-arm64-20211231180318.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.21/dosbox-x-macosx-arm64-20211231180318.zip)
The macOS package requires 64-bit Intel or ARM-based macOS operating system. It should run natively on the recent versions of macOS such as macOS Catalina (10.15) and Big Sur (11.0). Both SDL1 and SDL2 binaries (in .app format) are provided in the macOS package, in the directories named ```dosbox-x``` and ```dosbox-x-sdl2``` respectively inside the zip file. While the SDL1 version is the default version, the SDL2 version may be preferred over the SDL1 version for certain features (particularly related to input handling) such as touchscreen input support. You can select either SDL1 or SDL2 version according to your preference, or just run the SDL1 version if you are not sure.
@ -133,7 +136,7 @@ As of DOSBox-X version 0.83.16, the regular macOS builds listed above will run o
If you have an older macOS version such as macOS High Sierra (10.13) and Mojave (10.14), or you use a newer macOS version but do not need any additional features provided by external libraries such as libslirp or libfluidsynth, you can use the alternative macOS builds below instead, which include both SDL1 and SDL2 versions of the DOSBox-X (named ``dosbox-x-sdl1`` and ``dosbox-x-sdl2`` respectively in the package). These are intended to be builds for "low-end" systems with no need for external libraries to run them in your macOS:
* [dosbox-x-macosx-0.83.20-high-sierra.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.20/dosbox-x-macosx-0.83.20-high-sierra.zip)
* [dosbox-x-macosx-0.83.21-high-sierra.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.21/dosbox-x-macosx-0.83.21-high-sierra.zip)
If you see the message ```"dosbox-x" is damaged and can't be opened``` when trying to run the above builds, you should be able to solve the problem by executing the following command (once) in the Terminal and you are in the directory in which the zip package is extracted (where you can find two files including ```dosbox-x-sdl1``` and ```dosbox-x-sdl2```):
@ -151,9 +154,9 @@ macOS versions earlier than 10.12 (Sierra) are not officially supported. If you
Besides Windows, Linux and macOS packages, there are also packages released for the DOS operating system. Yes, DOSBox-X can officially run on DOS systems as well, as some DOS users seem to prefer to run DOS applications and games through a DOS emulator. With DOSBox-X running in DOS you are able to emulate another DOS system with a different PC configuration (such as different machine types, video and sound cards etc) that works better for the purpose of the users. But please note that due to the limitations of this environment not all features of DOSBox-X that are available in other platforms can be supported in the DOS version.
The official HX-DOS package for the current DOSBox-X version 0.83.20 is available in the following zip package:
The official HX-DOS package for the current DOSBox-X version 0.83.21 is available in the following zip package:
* [dosbox-x-mingw-hx-dos-20211201234567.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.20/dosbox-x-mingw-hx-dos-20211201234567.zip)
* [dosbox-x-mingw-hx-dos-20211231201323.zip](https://github.com/joncampbell123/dosbox-x/releases/download/dosbox-x-v0.83.21/dosbox-x-mingw-hx-dos-20211231201323.zip)
The HX-DOS package allows you to run DOSBox-X in a real DOS system (MS-DOS 5.0+ or compatible) with the help of the freely-available [HX DOS Extender](https://github.com/Baron-von-Riedesel/HX), which is already included in the recent DOS release packages. Once you unzip the package you can directly type ```DOSBOX-X``` to run in DOS. See the README.TXT file inside the DOS package for more information.
@ -167,11 +170,11 @@ Note: You may not see DOS packages for some DOSBox-X versions. For example, the
## Source Code Packages (zip or tar.gz)
Full source code packages of DOSBox-X are also available in both zip and tar.gz formats. Both contain the full source code, but you probably want to download the source code in zip format if you are using Windows, and the source code in tar.gz format if you are using Linux. For the current DOSBox-X version 0.83.20, the source code packages are:
Full source code packages of DOSBox-X are also available in both zip and tar.gz formats. Both contain the full source code, but you probably want to download the source code in zip format if you are using Windows, and the source code in tar.gz format if you are using Linux. For the current DOSBox-X version 0.83.21, the source code packages are:
* [dosbox-x-v0.83.20.zip](https://github.com/joncampbell123/dosbox-x/archive/refs/tags/dosbox-x-v0.83.20.zip)
* [dosbox-x-v0.83.20.tar.gz](https://github.com/joncampbell123/dosbox-x/archive/refs/tags/dosbox-x-v0.83.20.tar.gz)
* [dosbox-x-v0.83.21.zip](https://github.com/joncampbell123/dosbox-x/archive/refs/tags/dosbox-x-v0.83.21.zip)
* [dosbox-x-v0.83.21.tar.gz](https://github.com/joncampbell123/dosbox-x/archive/refs/tags/dosbox-x-v0.83.21.tar.gz)
If you prefer you can compile DOSBox-X from the source code by yourself. The source code packages as listed in the [Releases](https://github.com/joncampbell123/dosbox-x/releases) page contain the source code for that released version, and in this example the current DOSBox-X 0.83.20 version. On the other hand, if you are looking for the latest source code of DOSBox-X (including the most recent development changes in the source code), you may want to use the source code in the repository instead, or you can browse the latest source code using [Doxygen](https://dosbox-x.com/doxygen/html/index.html).
If you prefer you can compile DOSBox-X from the source code by yourself. The source code packages as listed in the [Releases](https://github.com/joncampbell123/dosbox-x/releases) page contain the source code for that released version, and in this example the current DOSBox-X 0.83.21 version. On the other hand, if you are looking for the latest source code of DOSBox-X (including the most recent development changes in the source code), you may want to use the source code in the repository instead, or you can browse the latest source code using [Doxygen](https://dosbox-x.com/doxygen/html/index.html).
You could use either the released source code package or the latest source code according to your needs, and the source code may be compiled to run on the above-mentioned platforms (Windows, Linux, macOS and DOS) and possibly other operating systems too. Please see the [BUILD](BUILD.md) page for detailed instructions on building the DOSBox-X source code. Further descriptions of the source code can be found in the [DOSBox-X source code description](README.source-code-description) file.