asio_samples-master_Boost.Asio高质量例子程序_源码

# Asio samples [](https://github.com/mabrarov/asio_samples/releases/latest) [](https://github.com/mabrarov/asio_samples/tree/master/LICENSE) Branch | Linux | Windows | Coverage | Coverity Scan -------|-------|---------|----------|-------------- [master](https://github.com/mabrarov/asio_samples/tree/master) | [](https://travis-ci.com/mabrarov/asio_samples) | [](https://ci.appveyor.com/project/mabrarov/asio-samples) | [](https://codecov.io/gh/mabrarov/asio_samples/branch/master) | [](https://scan.coverity.com/projects/mabrarov-asio_samples) [develop](https://github.com/mabrarov/asio_samples/tree/develop) | [](https://travis-ci.com/mabrarov/asio_samples) | [](https://ci.appveyor.com/project/mabrarov/asio-samples) | [](https://codecov.io/gh/mabrarov/asio_samples/branch/develop) | | Extended examples for [Boost.Asio](http://www.boost.org/doc/libs/release/doc/html/boost_asio.html). ## Building with Docker container Refer to [docker/builder/README.md](docker/builder/README.md) for instruction on how to build Linux version with existing Docker images. ## Build manual ### Prerequisites * C++ toolchain (one of): * MinGW with MSYS make MinGW-W64 4.9+ * Visual Studio (Visual C++) 2008, 2010, 2012, 2013, 2015, 2017, 2019 are tested versions * GCC with make 4.6+ * Clang with make 3.6+ * [CMake](https://cmake.org/) 3.1+, consider using the latest version of CMake because it supports recent versions of libraries * [Boost](https://www.boost.org) 1.47+, the latest tested version is 1.74 * [Google Test](https://github.com/google/googletest) Optional, copy of 1.7.0 version is shipped with this project and is used if no other instance is found * [Qt](https://www.qt.io) Optional, 4.0+, both 4.x and 5.x are supported with default preference to 5.x * [ICU](http://site.icu-project.org/home) Optional, required if static Qt 5.x is used, version should match Qt requirements / version which was used to build static Qt ### Assumptions * `%...%` syntax is used for Windows Command Prompt and `${...}` syntax is used for *nix shell * Windows Command Prompt with configured Windows SDK environment is used on Windows * Directory with generated project files and with built binaries is specified in `asio_samples_build_dir` environment variable * This repository is cloned into directory specified in `asio_samples_home_dir` environment variable * ICU is located at directory specified by `icu_home_dir` environment variable * Header files of Boost are located at directory specified by `boost_headers_dir` environment variable * Binary files of Boost are located at directory specified by `boost_libs_dir` environment variable * Qt 5.x is located at directory specified by `qt5_home_dir` environment variable * Qt 4.x is located at directory specified by `qt4_home_dir` environment variable * Google Test is located at directory specified by `gtest_home_dir` environment variable * [build type](https://cmake.org/cmake/help/latest/variable/CMAKE_BUILD_TYPE.html) is specified in `build_type` environment variable and is one of: * Debug * Release * RelWithDebInfo * MinSizeRel * `cmake_generator` environment variable is [CMake generator](https://cmake.org/cmake/help/latest/manual/cmake-generators.7.html) * `Visual Studio 14 2015` - Visual Studio 2015 * `Visual Studio 15 2017` - Visual Studio 2017 * `Visual Studio 16 2019` - Visual Studio 2019 * `Visual Studio 12 2013` - Visual Studio 2013 * `Visual Studio 10 2010` - Visual Studio 2010 * `Visual Studio 9 2008` - Visual Studio 2008 * `NMake Makefiles` - NMake * `MinGW Makefiles` - MinGW makefiles * `Unix Makefiles` - *nix makefiles * `cmake_platform` environment variable is [CMAKE_GENERATOR_PLATFORM](https://cmake.org/cmake/help/latest/variable/CMAKE_GENERATOR_PLATFORM.html) * `Win32` - x86 platform when using Visual Studio * `x64` - amd64 (x64) platform when using Visual Studio Building of CMake project is usually performed in 2 steps: 1. [Generation of project for build system](#generation-of-project-for-build-system) 1. [Building generated project with build system](#building-generated-project-with-build-system) ### Generation of project for build system Assuming current directory is `asio_samples_build_dir`. Windows Command Prompt, Visual Studio CMake generator: ```cmd cmake ... -G "%cmake_generator%" -A "%cmake_platform%" "%asio_samples_home_dir%" ``` Windows Command Prompt, NMake / MinGW makefiles CMake generator ```cmd cmake ... -G "%cmake_generator%" "%asio_samples_home_dir%" ``` *nix shell ```bash cmake ... -G "${cmake_generator}" "${asio_samples_home_dir}" ``` where `...` are optional parameters which are described below. Use `MA_TESTS` CMake variable to exclude tests from build (tests are included by default): ``` cmake -D MA_TESTS=OFF ... ``` CMake project uses CMake find modules, so most of parameters comes from these CMake modules: * [FindBoost CMake module](http://www.cmake.org/cmake/help/latest/module/FindBoost.html?highlight=findboost) CMake variables which can be specified in command line to locate and configure Boost: * `BOOST_INCLUDEDIR` - Boost headers directory Windows Command Prompt: ``` -D BOOST_INCLUDEDIR="%boost_headers_dir%" ``` *nix shell ``` -D BOOST_INCLUDEDIR="${boost_headers_dir}" ``` * `BOOST_LIBRARYDIR` - Boost libraries directory Windows Command Prompt: ``` -D BOOST_LIBRARYDIR="%boost_libs_dir%" ``` *nix shell ``` -D BOOST_LIBRARYDIR="${boost_libs_dir}" ``` * `Boost_USE_STATIC_LIBS` - force usage of static Boost, possible values are `ON` (use static libraries) and `OFF` (linkage type depends on platform) * `Boost_NO_SYSTEM_PATHS` - do not search for Boost in default system locations * [cmake-qt CMake module](http://www.cmake.org/cmake/help/latest/manual/cmake-qt.7.html) (refer to [Qt cmake manual](http://doc.qt.io/qt-5/cmake-manual.html) also) CMake variables which can be specified in command line to locate Qt 5.x: * `Qt5Core_DIR` Windows Command Prompt: ``` -D Qt5Core_DIR="%qt5_home_dir%/lib/cmake/Qt5Core" ``` *nix shell ``` -D Qt5Core_DIR="${qt5_home_dir}/lib/cmake/Qt5Core" ``` * `Qt5Gui_DIR` Windows Command Prompt: ``` -D Qt5Gui_DIR="%qt5_home_dir%/lib/cmake/Qt5Gui" ``` *nix shell ``` -D Qt5Gui_DIR="${qt5_home_dir}/lib/cmake/Qt5Gui" ``` * `Qt5Widgets_DIR` Windows Command Prompt: ``` -D Qt5Widgets_DIR="%qt5_home_dir%/lib/cmake/Qt5Widgets" ``` *nix shell ``` -D Qt5Widgets_DIR="${qt5_home_dir}/lib/cmake/Qt5Widgets" ``` CMake variables which can be specified in command line to locate Qt 4.x: * `QT_QMAKE_EXECUTABLE` - path to `qmake` executable Windows Command Prompt: ``` -D QT_QMAKE_EXECUTABLE="%qt4_home_dir%/bin/qmake.exe" ``` *nix shell ``` -D QT_QMAKE_EXECUTABLE="${qt4_home_dir}/bin/qmake.exe" ``` `MA_QT` CMake variable can be used to avoid usage of Qt and to skip examples using Qt. Possible values are: * `ON` (default) - search for (require) and us