{"id":151,"date":"2017-06-30T09:39:31","date_gmt":"2017-06-30T16:39:31","guid":{"rendered":"http:\/\/visualgdb.com\/w\/?p=151"},"modified":"2017-06-30T13:56:39","modified_gmt":"2017-06-30T20:56:39","slug":"linux-libraries","status":"publish","type":"post","link":"https:\/\/visualgdb.com\/tutorials\/linux\/libraries\/","title":{"rendered":"Creating Linux Libraries with Visual Studio"},"content":{"rendered":"

This tutorial shows how create static and dynamic Linux libraries with Visual Studio and debug them with VisualGDB. We will create a simple Linux application with VisualGDB, add one static and one dynamic library to it and test both in the debugger.<\/p>\n

To proceed with the tutorial you will need a Windows machine and a Linux machine. You can use 2 physical computers, a Windows computer running Linux inside VirtualBox<\/a>\/VMWare<\/a> or vice versa.<\/p>\n

Before you begin, install VisualGDB<\/a> on your Windows machine.<\/p>\n

    \n
  1. Follow the Linux Application tutorial<\/a> to create a simple Linux app with Visual Studio. We will use LinuxApp<\/strong> as the project name. Build the app and ensure that you can debug it.\"05-debug\"<\/a><\/li>\n
  2. Right-click on the solution item in the Solution Explorer and select “Add->New Project”:\"05-newprj\"<\/a><\/li>\n
  3. We will now create a static library project. Ensure that VisualGDB wizard is selected, enter MyStaticLib <\/strong>as the project name and press OK:\"06-lib2\"<\/a><\/li>\n
  4. Select “Create a new project” ->”Static library” -> Use MSBuild”. Press on ‘Next’.\"07-static\"<\/a><\/li>\n
  5. On the next page select the remote Linux machine. Ensure that the machine is the same as for the application project.\"08-build\"<\/a><\/li>\n
  6. Finish with the default source transfer.\"09-upload\"<\/a><\/li>\n
  7. You have now created a new static library project. Modify the main source file of your application as follows:\n
    #include <iostream>\r\n#include \"MyStaticLib\/MyStaticLib.h\"\r\n\r\nusing namespace std;\r\n\r\nint main(int argc, char *argv[])\r\n{\r\n\u00a0\u00a0 \u00a0char sz[] = \"Hello, World!\";\u00a0\u00a0 \u00a0\/\/Hover mouse over \"sz\" while debugging to see its contents\r\n\u00a0\u00a0 \u00a0cout << sz << MyStaticLibTest() << endl;\u00a0\u00a0 \u00a0\/\/<================= Put a breakpoint here\r\n\u00a0\u00a0 \u00a0return 0;\r\n}<\/pre>\n<\/li>\n
  8. Before this code can compile, we need to add a reference from the application project to the library project:\"10-ref\"<\/a><\/li>\n
  9. Check the MyStaticLib checkbox in the Add Reference window:\"11-name\"<\/a><\/li>\n
  10. Build the solution:\"12-built\"<\/a><\/li>\n
  11. Put a breakpoint to MyStaticLibTest()<\/strong> and start debugging. The breakpoint will be hit. You can use call stack window to see the the static library function was called from main()<\/strong>:\"13-debug\"<\/a><\/li>\n
  12. Add a new dynamic library to the solution. Use the MyDynamicLib<\/strong> name and select “Shared Library” on the Project Type page.<\/li>\n
  13. Reference the dynamic library from the main project:\"14-ref2\"<\/a><\/li>\n
  14. Add a call to MyDynamicLibTest() to the applications’ main source file:\n
    #include <iostream>\r\n#include \"MyStaticLib\/MyStaticLib.h\"\r\n#include \"MyDynamicLib\/MyDynamicLib.h\"\r\n\r\nusing namespace std;\r\n\r\nint main(int argc, char *argv[])\r\n{\r\n\u00a0\u00a0 \u00a0char sz[] = \"Hello, World!\";\u00a0\u00a0 \u00a0\/\/Hover mouse over \"sz\" while debugging to see its contents\r\n\u00a0\u00a0 \u00a0cout << sz << MyStaticLibTest() << MyDynamicLibTest() << endl;\u00a0\u00a0 \u00a0\/\/<================= Put a breakpoint here\r\n\u00a0\u00a0 \u00a0return 0;\r\n}<\/pre>\n<\/li>\n
  15. Build the solution. Put a breakpoint to MyDynamicLibTest() and start debugging. When the breakpoint is hit you can use the Module window in Visual Studio to see your dynamic library among the loaded modules:\"15-bkpt\"<\/a><\/li>\n
  16. You can configure a VisualGDB-based library to “export” some build settings so that they are automatically added to all projects referencing it. Try adding “USING_MY_DYNAMIC_LIB” to the exported Preprocessor Definitions for the library project:\"16-export\"<\/a><\/li>\n
  17. Try checking the new macro with an #ifdef in the main project. Ensure that it builds:\"17-build\"<\/a><\/li>\n
  18. You can configure various VisualGDB-related settings for each project via right-click -> VisualGDB Project Properties: \"18-settings\"<\/a><\/li>\n<\/ol>\n
    If you prefer an environment where multiple libraries share the same common settings (e.g. deployment paths), try creating CMake-based projects instead by following this tutorial<\/a>. VisualGDB transparently integrates CMake into Visual Studio and will automatically edit CMakeLists.txt files in response to various changes in Solution Explorer.<\/p>\n
     <\/p>\n","protected":false},"excerpt":{"rendered":"
    This tutorial shows how create static and dynamic Linux libraries with Visual Studio and debug them with VisualGDB. We will<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10],"tags":[79,33,131],"_links":{"self":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/151"}],"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=151"}],"version-history":[{"count":2,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/151\/revisions"}],"predecessor-version":[{"id":2994,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/151\/revisions\/2994"}],"wp:attachment":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/media?parent=151"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/categories?post=151"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/tags?post=151"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}