Feat/build with cmake

[thewh1teagle]

Add CMake configuration and CI
It's best to squash the commits when merging (in the merge button in Github UI there's option)

CI (Success): https://github.com/thewh1teagle/pcaudiolib/actions/runs/12961423582

Build successfully on macOS (arm/amd64), Linux(arm,amd64), Windows (amd64)
Backends: Alsa, PulseAudio, CoreAudio, OSS
Linking with espeak: Linux (dynamic), macOS (static,dynamic), Windows (static,dynamic)

Related:

• Add CMake thewh1teagle/pcaudiolib#1
• GitHub Action to build the code #31
• Build Errors in xaudio2.cpp on Windows? #22
• CMake usage microsoft/DirectXTK#524
• https://stackoverflow.com/a/1492189/13393388 (very important on macOS)

Build instructions with espeak-ng for all platforms

macOS

# Build shared pcaudiolib
git clone https://github.com/thewh1teagle/pcaudiolib -b feat/build-with-cmake
cd pcaudiolib
cmake -B build -DCMAKE_INSTALL_PREFIX=_install -DBUILD_SHARED_LIBS=ON -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release
cmake --install build
ls -R _install
export PCAUDIO_PATH=$(pwd)/_install

# Dynamic link pcaudiolib
git clone https://github.com/espeak-ng/espeak-ng -b 1.52.0
cd espeak-ng
cmake -B build -DCMAKE_INSTALL_PREFIX=_install -DBUILD_SHARED_LIBS=OFF -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=$PCAUDIO_PATH
cmake --build build --config Release
cmake --install build
ls -R _install
cp $PCAUDIO_PATH/lib/*.dylib _install/lib     
./_install/bin/espeak-ng hello # speaking works

Windows

git clone https://github.com/thewh1teagle/pcaudiolib -b feat/build-with-cmake
cd pcaudiolib
cmake -B build -DCMAKE_INSTALL_PREFIX=_install -DBUILD_SHARED_LIBS=OFF -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE="C:/vcpkg/scripts/buildsystems/vcpkg.cmake"
cmake --build build --config Release
cmake --install build
ls -R _install
$env:PCAUDIO_PATH="$pwd\_install"

# Static link pcaudiolib
git clone https://github.com/espeak-ng/espeak-ng -b 1.52.0
cd espeak-ng
ls $env:PCAUDIO_PATH
cmake -B build -DCMAKE_INSTALL_PREFIX=_install -DBUILD_SHARED_LIBS=OFF -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH="$env:PCAUDIO_PATH" # Or absolute path
cmake --build build --config Release
cmake --install build
./_install/bin/espeak-ng hello # speaking works

Linux

# Build shared pcaudiolib
sudo apt-get install libpulse-dev -y
git clone https://github.com/thewh1teagle/pcaudiolib -b feat/build-with-cmake
cd pcaudiolib
rm -rf build _install
cmake -B build -DCMAKE_INSTALL_PREFIX=_install -DBUILD_SHARED_LIBS=ON -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release
cmake --install build
ldd _install/lib/*.so
ls -R _install
export PCAUDIO_PATH=$(pwd)/_install

# Dynamic link pcaudiolib
git clone https://github.com/espeak-ng/espeak-ng -b 1.52.0
cd espeak-ng
rm -rf build _install
cmake -B build -DCMAKE_INSTALL_PREFIX=_install -DBUILD_SHARED_LIBS=OFF -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH="$PCAUDIO_PATH"
cmake --build build --config Release
cmake --install build
ls -R _install
cp $PCAUDIO_PATH/lib/*.so _install/lib     
./_install/bin/espeak-ng hello # speaking works

Notes:

To build espeak-ng on macOS and link it statically, these changes are required in espeak-ng near each add_executable call:

target_link_libraries(espeak-ng-bin PRIVATE "-framework CoreAudio" "-framework AudioToolbox" "-framework AudioUnit") # src/CMakeLists.txt
target_link_libraries(test_${_test_name} PRIVATE "-framework CoreAudio" "-framework AudioToolbox" "-framework AudioUnit") # ...

Optional improvements in espeak:

• https://stackoverflow.com/questions/66017579/static-linking-of-linux-audio-libraries
• https://gitlab.freedesktop.org/pulseaudio/pulseaudio/-/issues/1089