machinepal

MachinePal appears to be a project that provides a build environment and tooling setup via vcpkg for C++ dependencies, with guidance centered around installing dependencies and preparing a cmake build. To use it, start by setting up the required C++ toolchain and the vcpkg package manager, then install the necessary libraries (folly, wangle, proxygen) as described. Once dependencies are in place, configure the build with cmake using a vcpkg toolchain file and the appropriate manifest flag to enable manifests. The resulting build should produce the MachinePal components that integrate with your environment for further development or testing.

Prerequisites:

• Git
• A C/C++ compiler toolchain (e.g., gcc/clang and build system)
• CMake
• Network access to fetch dependencies via vcpkg

Step-by-step:

1. Install and bootstrap vcpkg: git clone https://github.com/microsoft/vcpkg.git cd vcpkg ./bootstrap-vcpkg.sh

2. Install required libraries via vcpkg: ./vcpkg install folly wangle proxygen

3. Configure the build with CMake using the vcpkg toolchain and manifests feature enabled: cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_TOOLCHAIN_FILE=external/vcpkg/scripts/buildsystems/vcpkg.cmake -DVCPKG_FEATURE_FLAGS=manifests

4. Build the project with your preferred build system (e.g., make or ninja) once configuration completes.

Notes:

• Ensure network access is allowed for vcpkg to fetch dependencies.
• If the project requires additional flags or a specific generator, adjust the cmake invocation accordingly.

Tips and common issues:

• If vcpkg cannot fetch dependencies due to network restrictions, try configuring a proxy or offline host cache for vcpkg.
• When enabling manifests, ensure your vcpkg.json (manifest file) is correctly placed in the project root and lists folly, wangle, and proxygen as dependencies.
• On Windows, ensure you have the appropriate Visual Studio toolchain installed; on Linux/macOS, ensure you have the build-essential tools and a compatible compiler.
• If you encounter build errors related to missing headers or symbols, verify that the installed library versions match the project requirements and that the correct triplet is being used by vcpkg.