{"id":2650,"date":"2019-12-24T15:40:37","date_gmt":"2019-12-24T07:40:37","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/iotdev\/?p=2650"},"modified":"2019-12-24T15:40:37","modified_gmt":"2019-12-24T07:40:37","slug":"standalone-azure-iot-edgehub-dev-tool-iotedgehubdev-introduction","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/iotdev\/standalone-azure-iot-edgehub-dev-tool-iotedgehubdev-introduction\/","title":{"rendered":"Standalone Azure IoT EdgeHub Dev Tool (iotedgehubdev) Introduction"},"content":{"rendered":"<p>As an IoT developer, when you work with Azure IoT Edge project, one of the issues you might have is that you would like to debug your Edge modules locally before actually deploy them to the production environment. This can be done by <a href=\"https:\/\/github.com\/Azure\/iotedgehubdev\">Azure IoT EdgeHub Dev Tool (iotedgehubdev)<\/a>, which provides a local development experience for creating, testing, running and debugging Azure IoT Edge modules and solutions. Using Azure IoT EdgeHub Dev Tool, you do not need to install IoT Edge Runtime on your local machine, and all you need is to install Azure IoT EdgeHub Dev Tool and Docker, which greatly smooth the development of Azure IoT Edge projects. For more details about Azure IoT EdgeHub Dev Tool, please visit <a href=\"https:\/\/github.com\/Azure\/iotedgehubdev\/issues\/244\">iotedgehubdev repo<\/a>.<\/p>\n<p>However, we found that install Azure IoT EdgeHub Dev Tool is not that smooth for most of the Azure IoT Edge developers on Windows platform. A lot of users would have troubles when installing this tool. From our investigation, we found some clues:<\/p>\n<ul>\n<li>IoT Edge Dev Tool is built on Python, and this required Python environment on developer\u2019s dev machine, so some users who do not have Python installed on their machine would have trouble to install the tool.<\/li>\n<li>Some developers have python environment, however, the version of Python is not compatible with IoT Edge Dev Tool which would also cause installation failure.<\/li>\n<li>Although some developers have compatible Python installed, however, some libraries conflict might also lead to installation failure.<\/li>\n<\/ul>\n<p>Take all these into consideration, by using technology of <a href=\"https:\/\/github.com\/pyinstaller\/pyinstaller\">PyInstaller<\/a>, we have shipped a standalone Azure IoT EdgeHub Dev Tool so that developers who use Windows as development environment no longer need to install Python, and we also integrated it in the latest release of <a href=\"https:\/\/github.com\/microsoft\/vscode-azure-iot-edge\">Azure IoT Edge VSCode<\/a> \/ <a href=\"https:\/\/github.com\/microsoft\/vs-azure-iot-edge-docs\">Visual Studio extension<\/a>, all this changes are transparent and dramatically increase installation success rate for Windows Azure IoT Edge developers.<\/p>\n<p>Now let\u2019s walk through how to use standalone Azure IoT Edge Dev Tool for Windows developers:<\/p>\n<p>&nbsp;<\/p>\n<h3>For Azure IoT Edge VSCode extension users<\/h3>\n<p>Since Azure IoT Edge VSCode extension 0.19.0 has already integrated the standalone Azure IoT Dev Tool, all you need is to install the latest extension:<\/p>\n<ol>\n<li>Install latest Azure IoT Edge VSCode extension (&gt;= 0.19.0), and the extension can be found <a href=\"https:\/\/marketplace.visualstudio.com\/items?itemName=vsciot-vscode.azure-iot-edge\">here<\/a><\/li>\n<li>Open or Create an Edge project, you would see a progress window showing \u201cDownloading and installing Azure IoT EdgeHub Dev tool (iotedgehubdev)\u2026\u201d<img decoding=\"async\" width=\"1313\" height=\"748\" class=\"wp-image-2651\" style=\"font-size: 1rem;\" src=\"https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image.png\" srcset=\"https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image.png 1313w, https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image-300x171.png 300w, https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image-1024x583.png 1024w, https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image-768x438.png 768w\" sizes=\"(max-width: 1313px) 100vw, 1313px\" \/><\/li>\n<li>when the progress windows disappeared, you are done with the installation of standalone Azure IoT Dev Tool, you can develop and debug Azure IoT Edge project now.<\/li>\n<\/ol>\n<h3>For Azure IoT Tools Visual Studio extension users<\/h3>\n<p>Azure IoT Edge Tools (version &gt;= 1.4.0) for Visual Studio also integrated the standalone Azure IoT Dev Tool, you can follow the steps below to use it:<\/p>\n<ol>\n<li>Install latest Azure IoT Tools:\n<ul>\n<li>For Visual Studio 2017, you can download the extension <a href=\"https:\/\/marketplace.visualstudio.com\/items?itemName=vsc-iot.vsiotedgetools\">here<\/a><\/li>\n<li>For Visual Studio 2019, you can download the extension <a href=\"https:\/\/marketplace.visualstudio.com\/items?itemName=vsc-iot.vs16iotedgetools\">here<\/a><\/li>\n<\/ul>\n<\/li>\n<li>Open or Create an Azure IoT Edge project, you would see \u201cStart downloading and installing Azure IoT Edge simulator\u2026 \u201c from the output window<img decoding=\"async\" width=\"1307\" height=\"125\" class=\"wp-image-2652\" style=\"font-size: 1rem;\" src=\"https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image-1.png\" srcset=\"https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image-1.png 1307w, https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image-1-300x29.png 300w, https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image-1-1024x98.png 1024w, https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image-1-768x73.png 768w\" sizes=\"(max-width: 1307px) 100vw, 1307px\" \/><\/li>\n<li>If everything works fine, you would see \u201cDownload and install Azure IoT Edge simulator successfully!\u201d message in the output window, now you\u2019re ready to develop and debug Edge project using Visual Studio<\/li>\n<\/ol>\n<h3>For command line users<\/h3>\n<p>If you want to use standalone Azure IoT EdgeHub Dev Tool directly from command line, you can follow the steps below:<\/p>\n<ol>\n<li>Go to <a href=\"https:\/\/github.com\/Azure\/iotedgehubdev\/releases\">Azure IoT EdgeHub Dev Tool releases page<\/a> and download the latest binaries:<img decoding=\"async\" width=\"1239\" height=\"508\" class=\"wp-image-2653\" style=\"font-size: 1rem;\" src=\"https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image-2.png\" srcset=\"https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image-2.png 1239w, https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image-2-300x123.png 300w, https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image-2-1024x420.png 1024w, https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image-2-768x315.png 768w\" sizes=\"(max-width: 1239px) 100vw, 1239px\" \/><\/li>\n<li>Unzip the binaries to a folder, such as \u201cC:\\iotedgehubdev\u201c<\/li>\n<li>Edit system environment variables, and add the folder to the system PATH<img decoding=\"async\" width=\"602\" height=\"664\" class=\"wp-image-2654\" style=\"font-size: 1rem;\" src=\"https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image-3.png\" srcset=\"https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image-3.png 602w, https:\/\/devblogs.microsoft.com\/iotdev\/wp-content\/uploads\/sites\/24\/2019\/12\/word-image-3-272x300.png 272w\" sizes=\"(max-width: 602px) 100vw, 602px\" \/><\/li>\n<li>Now you are done, you can invoke Azure IoT EdgeHub Dev Tool through command line<\/li>\n<\/ol>\n<h3>Conclusion<\/h3>\n<p>With the release of standalone Azure IoT EdgeHub Dev Tool, now Windows developers do not need to have Python environment to use this tool. Azure IoT Edge extensions for VSCode and Visual Studio also integrate it, which help users automatically install the tool. To learn more about how to develop and debug Azure IoT Edge projects, please visit our <a href=\"https:\/\/docs.microsoft.com\/en-us\/azure\/iot-edge\/about-iot-edge\">documents<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>As an IoT developer, when you work with Azure IoT Edge project, one of the issues you might have is that you would like to debug your Edge modules locally before actually deploy them to the production environment. This can be done by Azure IoT EdgeHub Dev Tool (iotedgehubdev), which provides a local development experience [&hellip;]<\/p>\n","protected":false},"author":1253,"featured_media":1836,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-2650","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-iot-dev"],"acf":[],"blog_post_summary":"<p>As an IoT developer, when you work with Azure IoT Edge project, one of the issues you might have is that you would like to debug your Edge modules locally before actually deploy them to the production environment. This can be done by Azure IoT EdgeHub Dev Tool (iotedgehubdev), which provides a local development experience [&hellip;]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/iotdev\/wp-json\/wp\/v2\/posts\/2650","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/iotdev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/iotdev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/iotdev\/wp-json\/wp\/v2\/users\/1253"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/iotdev\/wp-json\/wp\/v2\/comments?post=2650"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/iotdev\/wp-json\/wp\/v2\/posts\/2650\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/iotdev\/wp-json\/wp\/v2\/media\/1836"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/iotdev\/wp-json\/wp\/v2\/media?parent=2650"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/iotdev\/wp-json\/wp\/v2\/categories?post=2650"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/iotdev\/wp-json\/wp\/v2\/tags?post=2650"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}