0cd2cd9024 | ||
---|---|---|
build_all | ||
c-utility@19d1a4ebab | ||
configs | ||
devdoc/requirement_docs | ||
inc/azure_umqtt_c | ||
jenkins | ||
samples | ||
src | ||
tests | ||
tools | ||
.gitignore | ||
.gitmodules | ||
CMakeLists.txt | ||
LICENSE | ||
dependencies-test.cmake | ||
dependencies.cmake | ||
readme.md |
readme.md
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
Microsoft Azure MQTT
azure-umqtt-c is a general purpose library build for MQTT protocol
Dependencies
azure-mqtt client use the azure-c-shared-utility, which is a C library provisioning common functionality for basic tasks (like string, list manipulation, IO, etc.). azure-c-shared-utility is available here: https://github.com/Azure/azure-c-shared-utility. azure-c-shared-utility needs to be built before building azure-mqtt-c.
Setup
Build
- Clone azure-umqtt-c by:
git clone --recursive https://github.com/Azure/azure-umqtt-c.git
-
Create a folder cmake under azure-umqtt-c
-
Switch to the cmake folder and run
cmake ..
- Build
cmake --build .
Installation and Use
Optionally, you may choose to install azure-umqtt-c on your machine:
-
Switch to the cmake folder and run
cmake -Duse_installed=ON ../
cmake --build . --target install
or install using the follow commands for each platform:
On Linux:
sudo make install
On Windows:
msbuild /m INSTALL.vcxproj
-
Use it in your project (if installed)
find_package(umqtt REQUIRED CONFIG) target_link_library(yourlib umqtt)
This requires that azure-c-shared-utility is installed (through CMake) on your machine.
If running tests, this requires that umock-c, azure-ctest, and azure-c-testrunnerswitcher are installed (through CMake) on your machine.
Building the tests
In order to build the tests use:
cmake .. -Drun_unittests:bool=ON