Azure SDK Update

Table of Contents

Microsoft Azure IoT C SDK update

A snapshot of the Microsoft Azure IoT C SDK is bundled with this plugin in the directory source/third_party/azure-iot-pal-simplelink/sdk. The plugin has been validated against this version of the SDK, as documented in the release notes. While there is no guarantee that compatibility is always preserved, in some instances, the user may wish to update the SDK to a later release. One can do so by cloning the desired tag from the Microsoft Azure IoT C SDK GitHub repository into the subdirectory source/third_party/azure-iot-pal-simplelink/sdk and by rebuilding the libraries using the following procedure, which assumes you have Git installed on your computer:

1. Backup the source/third_party/azure-iot-pal-simplelink/sdk subdirectory by renaming it to source/third_party/azure-iot-pal-simplelink/sdk_backup.

2. Open a Windows Command Prompt (or a Linux Terminal window if you work under Linux). Verify that Git is on your system path.

3. If you are using Windows, enable long path support (you may need administrator rights):

   git config --system core.longpaths true

4. Clone the Microsoft Azure IoT C SDK and checkout the branch/tag of interest. Replace <AZURE_INSTALL_DIR> with the path to your Azure plugin installation, and <yyyy-mm-dd> with the release tag name desired. If necessary, refer to Set up a Windows development environment for most up-to-date details from Microsoft on cloning the SDK and release tags:

   cd <AZURE_INSTALL_DIR>/source/third_party/azure-iot-pal-simplelink
   git clone -b <yyyy-mm-dd> --recursive https://github.com/Azure/azure-iot-sdk-c.git sdk

5. Rebuild the Azure SDK libraries according to the procedure in the section “Building the Azure PAL and SDK libraries” of the Quick Start Guide.

If the new version of the Azure SDK is compatible with the plugin, you should be able to rebuild successfully. You may now go ahead and rebuild your application or example against these libraries.