{"id":8438,"date":"2023-09-28T14:15:58","date_gmt":"2023-09-28T21:15:58","guid":{"rendered":"https:\/\/visualgdb.com\/w\/?p=8438"},"modified":"2024-10-20T17:12:23","modified_gmt":"2024-10-21T00:12:23","slug":"managing-python-installations","status":"publish","type":"post","link":"https:\/\/visualgdb.com\/documentation\/python\/","title":{"rendered":"Managing Python Installations"},"content":{"rendered":"

Many project types (e.g. ESP-IDF, NRFConnect) require a Python installation with specific packages in order to build the projects. VisualGDB allows managing these Python installations via Tools->Options->VisualGDB->General->Python Directory<\/strong>.<\/p>\n

Starting from VisualGDB 6.0, you can select the individually select the Python versions for each project type that uses it, and a default version that will be used otherwise:\"\"<\/a><\/p>\n

Normally, we suggest leaving the explicit Python paths empty and have VisualGDB automatically install and use the Python version compatible with each project type. This way, VisualGDB will automatically install the pre-built Python installations to %LOCALAPPDATA%\\VisualGDB\\Python*<\/strong> and will select a compatible one for each project type based on the FrameworkCompatibility<\/strong> element in <Python directory>\\package.xml<\/strong>:<\/p>\n

<?xml version=\"1.0\"?>\r\n<InstalledAuxiliaryPackageSummary xmlns:xsd=\"http:\/\/www.w3.org\/2001\/XMLSchema\" xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\">\r\n  <PackageID>python<\/PackageID>\r\n  <PackageVersion>3.8.10<\/PackageVersion>\r\n  <PackageDescription>Python<\/PackageDescription>\r\n  <FrameworkCompatibility>mbed=*;NRFConnect=0-2.4;PicoSDK=*;ESPIDF=*;ESPADF=*;ESP8266RTOS=*<\/FrameworkCompatibility>\r\n<\/InstalledAuxiliaryPackageSummary><\/pre>\n
Installing and Uninstalling Python Packages Manually<\/h2>\n
You can manage the Python installations managed by VisualGDB via Tools->VisualGDB->Manage VisualGDB Packages->Auxiliary Tools:\"\"<\/a><\/strong><\/p>\n
If you would like to install older Python version via this window, make sure you check the “show old packages” checkbox.<\/p>\n
Troubleshooting Python issues<\/h2>\n
If you starting encountering strange Python errors (e.g. missing\/incompatible packages), follow the steps below to reset your environment to versions that were tested on our side:<\/p>\n
    \n
  1. Delete the %LOCALAPPDATA%\\VisualGDB\\Python*<\/strong> directories.<\/li>\n
  2. Clear the Python paths via Tools->Options->VisualGDB->General->Python Directory<\/strong>.<\/li>\n
  3. Restart Visual Studio.<\/li>\n
  4. Use the project wizard for your project type (e.g. ESP-IDF) to create a new project. This will automatically download a compatible Python version, and will setup the underlying tools.<\/li>\n<\/ol>\n
    You can also view the package installation log<\/a> to see if any of other packages were recently updated, and revert the updates.<\/p>\n","protected":false},"excerpt":{"rendered":"
    Many project types (e.g. ESP-IDF, NRFConnect) require a Python installation with specific packages in order to build the projects. VisualGDB<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[199],"tags":[],"_links":{"self":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/8438"}],"collection":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/comments?post=8438"}],"version-history":[{"count":4,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/8438\/revisions"}],"predecessor-version":[{"id":8893,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/8438\/revisions\/8893"}],"wp:attachment":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/media?parent=8438"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/categories?post=8438"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/tags?post=8438"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}