From 79e403b15ca66b0d689f20e4d6ee8f119bcfd06a Mon Sep 17 00:00:00 2001 From: Sergiu Deitsch Date: Sat, 13 Aug 2022 16:31:53 +0200 Subject: [PATCH] Expand vcpkg installation instructions Change-Id: Iad83869b1411b126beb26cfbbf5f6e9f717ff591 --- docs/source/installation.rst | 47 +++++++++++++++++++++++++++++++++--- 1 file changed, 44 insertions(+), 3 deletions(-) diff --git a/docs/source/installation.rst b/docs/source/installation.rst index d6bae75be..d9e338fdf 100644 --- a/docs/source/installation.rst +++ b/docs/source/installation.rst @@ -304,9 +304,50 @@ We are now ready to build, test, and install Ceres. Windows ======= -`Vckpg `_ is the homebrew -equivalent on Microsoft Windows and can be used to install Ceres -Solver. +Using a Library Manager +----------------------- + +`vcpkg `_ is a library manager for Microsoft +Windows that can be used to install Ceres Solver and all its dependencies. + +#. Install the library manager into a top-level directory ``vcpkg/`` on Windows + following the `guide + `_, e.g., using + Visual Studio 2022 community edition, or simply run + + .. code:: bat + + git clone https://github.com/Microsoft/vcpkg.git + cd vcpkg + .\bootstrap-vcpkg.bat + .\vcpkg integrate install + +#. Use vcpkg to install and build Ceres and all its dependencies, e.g., for 64 + bit Windows + + .. code:: bat + + vcpkg\vcpkg.exe install ceres:x64-windows + + Or with optional components, e.g., SuiteSparse, using + + .. code:: bat + + vcpkg\vcpkg.exe install ceres[suitesparse]:x64-windows + +#. Integrate vcpkg packages with Visual Studio to allow it to automatically + find all the libraries installed by vcpkg. + + .. code:: bat + + vcpkg\vcpkg.exe integrate install + +#. To use Ceres in a CMake project, follow our :ref:`instructions + `. + + +Building from Source +-------------------- Ceres Solver can also be built from source. For this purpose, we support Visual Studio 2019 and newer.