MAME Build Tools

Table of Contents

• Introduction
• Installation and building
  • Downloads
  • Installation
  • Building
• Updating build tools
• Alternative Shells for advanced usage
• Optional additional packages
  • 32-bit tools
  • GNU Debugger (gdb)
  • QT5
  • QT4
  • CCache
  • CMake
  • Clang

Introduction

The MAME development environment for Windows consists of the GCC compiler (by way of MinGW), and the MSYS2 (POSIX/Unix compatability layer), plus various utilities such as Python and Git. It is available as a prepackaged installer, or can be assembled from upstream components.

Source control is handled by github (https://github.com/mamedev/mame.git), so you'll need to check out a copy. Various modules are disabled by default, but can be enabled through arguments when building and may require additional MSYS2 packages to be installed.

Installation and building

Downloads

• 64-bit - msys64-2022-01-12.exe (Only 64-bit tools and libraries are included. To build 32-bit binaries, install the 32-bit MinGW tools, and switch between environments using config32.bat and config64.bat)

Installation

If you are installing it in a location other than the default (C:\Users\Public\msys64), after you unpack double-click : autorebase.bat

To open a non-POSIX shell there is a batch file: win32env.bat for regular Windows console.

Important thing is to setup your git environment first

git config --global core.autocrlf true

And if you are a contributor:

git config --global user.email [email protected]
git config --global user.name "Firstname Lastname"

Building

Then, to download the MAME source under your Msys2 user's homedir:

git clone https://github.com/mamedev/mame.git

Alternatively, locate your existing source tree (drives are mapped to hidden dirs /c etc. under the virtual root):

cd /c/Projects/mame

And finally to build:

make

Updating build tools

Similar to package managers on Linux like apt-get, yum etc. MSYS2 can automatically update packages for fixes, security updates etc. To update all installed packages to current, from the regular Windows console run the following:

pacman -Sy
pacman -S bash pacman msys2-runtime --noconfirm --needed

Next, exit the console and restart Msys2.

Finally, once back at the console, execute:

pacman -Su --noconfirm

Alternative Shells for advanced usage

For a simple MSYS32 terminal use mingw64.exe to start or (or mingw32.exe for a 32-bit environment).

For more information about MSYS2, see MSYS2 Introduction.

Optional additional packages

32-bit tools

If you wish to build 32-bit binaries:

pacman -S mingw-w64-i686-gcc mingw-w64-i686-libc++ mingw-w64-i686-lld mingw-w64-i686-python mingw-w64-i686-SDL2 mingw-w64-i686-SDL2_ttf

GNU Debugger (gdb)

If you wish to debug with gdb:

For MSYS2 x64

pacman -S gdb

For MinGW x64

pacman -S mingw-w64-x86_64-gdb

For MinGW x86

pacman -S mingw-w64-i686-gdb

QT5

If you wish to build with the QT5 debugger:

For x64

pacman -S mingw-w64-x86_64-qt5

For x86

pacman -S mingw-w64-i686-qt5

QT4

If you with to build the QMC2 frontend or similar:

For x64

pacman -S mingw-w64-x86_64-qt4

For x86

pacman -S mingw-w64-i686-qt4

CCache

To be able to use ccache to speed-up (re)compilation

For x64

pacman -S mingw-w64-x86_64-ccache

For x86

pacman -S mingw-w64-i686-ccache

CMake

Used as build system for some other project that can be handy

For x64

pacman -S mingw-w64-x86_64-cmake

For x86

pacman -S mingw-w64-i686-cmake

To build in Windows environment use from build folder:

cmake -G "MinGW Makefiles" .. -DCMAKE_MAKE_PROGRAM=c:\msys64\win32\make.exe

To build in MSYS environment use from build folder:

cmake -G "MSYS Makefiles" ..

Clang

If you wish to compile/link with the alternative Clang, go ahead and download:

For x64

pacman -S mingw-w64-x86_64-clang mingw-w64-x86_64-clang-analyzer mingw-w64-x86_64-clang-tools-extra

For x86

pacman -S mingw-w64-i686-clang mingw-w64-i686-clang-analyzer mingw-w64-i686-clang-tools-extra