README 3.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104
  1. Building via IDE Project Files
  2. ==============================
  3. This document describes how to compile, build and install curl and libcurl
  4. from sources using an IDE based development tool such as Visual Studio.
  5. Project files are currently available for Visual C++ v6.0 to v12.0. The
  6. following directory structure has been used to cater for this:
  7. somedirectory\
  8. |_curl
  9. |_projects
  10. |_<platform>
  11. |_<ide>
  12. |_lib
  13. |_src
  14. This structure allows for side-by-side compilation of curl on the same
  15. machine using different versions of a given compiler (for example VC8, VC9
  16. and VC10) and allows for your own application or product to be compiled
  17. against those variants of libcurl for example.
  18. Note: Typically this side-by-side compilation is generally only required
  19. when a library is being compiled against dynamic runtime libraries.
  20. Dependencies
  21. ============
  22. The projects files also support build configurations that require third
  23. party dependencies such as openssl and ssh2. If you wish to support these,
  24. you will also need to download and compile those libraries as well.
  25. To support compilation of these libraries using different versions of
  26. compilers, the following directory structure has been used for both the
  27. output of curl and libcurl as well as these dependencies.
  28. somedirectory\
  29. |_curl
  30. | |_ build
  31. | |_<architecture>
  32. | |_<ide>
  33. | |_<configuration>
  34. | |_lib
  35. | |_src
  36. |
  37. |_openssl
  38. | |_ build
  39. | |_<architecture>
  40. | |_VC <version>
  41. | |_<configuration>
  42. |
  43. |_libssh2
  44. |_ build
  45. |_<architecture>
  46. |_VC <version>
  47. |_<configuration>
  48. As OpenSSL doesn't support side-by-side compilation when using different
  49. versions of Visual Studio a build helper batch file has been provided to
  50. assist with this. Please run "build-openssl -help" for usage details.
  51. Building with Visual C++
  52. ========================
  53. To build with VC++, you will of course have to first install VC++ which is
  54. part of Visual Studio.
  55. If you are building with VC6 then you will also need the February 2003
  56. Edition of the Platform SDK which can be downloaded from:
  57. http://www.microsoft.com/en-us/download/details.aspx?id=12261
  58. Once you have VC++ installed you should launch the application and open one
  59. of the solution or workspace files.
  60. Whilst files are provided for both libcurl and the curl command line tool as
  61. well as a configuration that includes both, it is recommend that you use the
  62. all-in-one configuration.
  63. Notes
  64. =====
  65. The following keywords have been used in the directory hierarchy:
  66. <platform> - The platform (For example: Windows)
  67. <ide> - The IDE (For example: VC6, VC10, BCC5)
  68. <architecture> - The platform architecture (For example: Win32, Win64)
  69. <configuration> - The target configuration (For example: DLL Debug,
  70. LIB Release - LIB OpenSSL)
  71. TODO
  72. ====
  73. These project files are a recent addition to the curl source code and as such
  74. are not 100% complete. This is a list of things that are still todo:
  75. * Support zlib
  76. * Support WinIDN
  77. * Use of static runtime libraries
  78. * Generate *.vcxproj.filters files for VC10, VC11 and VC12
  79. * Add the Test Suite components
  80. * Support for other development IDEs
  81. Any additional help would be appreciated ;-)