Media Transport Library compilation and build Guide on Windows OS (MSYS2)

Media Transport Library compilation and build Guide on Windows OS (MSYS2)#

1. Introduction#

This document contains instructions for installing and configuring the Media Transport Library for Windows Operation System in MSYS2 environment.

2. Prerequisites#

  • Windows 10 / Windows Server 2019 64-bit or higher

3. Install MSYS2 environment#

  • Download and install MSYS2 from https://www.msys2.org/.

  • Open an MSYS2 MINGW64/UCRT64 shell, all commands in this doc will be run in this shell.

  • Update packages:

pacman -Syuu

4. Install dependencies#

  • Install build tools and dependencies:

pacman -S git base-devel unzip pactoys
pacboy -S gcc:p meson:p pkgconf:p openssl:p json-c:p libpcap:p dlfcn:p SDL2:p SDL2_ttf:p gtest:p

4. Install tools#

wget https://nmap.org/npcap/dist/npcap-sdk-1.12.zip
unzip -d npcap-sdk npcap-sdk-1.12.zip
cp npcap-sdk/Lib/x64/* $MSYSTEM_PREFIX/lib/

  • Install mman (mmap for Windows):

git clone https://github.com/alitrack/mman-win32
cd mman-win32
./configure --prefix=$MSYSTEM_PREFIX
make && make install

5. Build DPDK#

  • Clone the MTL repository if not:

git clone https://github.com/OpenVisualCloud/Media-Transport-Library.git
export mtl_source_code=${PWD}/Media-Transport-Library

  • Convert symlink patch files to real file:

cd $mtl_source_code/patches/dpdk/23.11
ls *.patch | xargs -I{} bash -c 'if [[ $(sed -n '1p' "{}") =~ ^../.*\.patch$ ]]; then cp "$(cat "{}")" "{}"; fi'
cd windows
ls *.patch | xargs -I{} bash -c 'if [[ $(sed -n '1p' "{}") =~ ^../.*\.patch$ ]]; then cp "$(cat "{}")" "{}"; fi'

  • Clone the DPDK repository and apply patches:

cd $mtl_source_code
git clone https://github.com/DPDK/dpdk.git
cd dpdk
git checkout v23.11
git switch -c v23.11

git config user.name "Your Name"        # config if not
git config user.email "you@example.com" # config if not
git am $mtl_source_code/patches/dpdk/23.11/*.patch
git am $mtl_source_code/patches/dpdk/23.11/windows/*.patch

  • Build and install DPDK:

meson setup build
meson install -C build

6. Build Media Transport Library and app#

cd $mtl_source_code
./build.sh

7. Add MSYS2 binary PATH to system environment variables (Optional)#

The MSYS2 path is not in Windows system environment variables by default, if you want to run MTL apps in PowerShell/CMD, you need to add the paths first. For example, MSYS2 is installed in C:\msys64.

  • (optional)Add MSYS2 common toolchain path: C:\msys64\usr\bin

  • If the environment is MinGW64, add: C:\msys64\mingw64\bin

  • If the environment is UCRT64, add: C:\msys64\ucrt64\bin