{"id":17325,"date":"2017-10-23T17:32:17","date_gmt":"2017-10-24T00:32:17","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/vcblog\/?p=17325"},"modified":"2019-02-18T17:48:15","modified_gmt":"2019-02-18T17:48:15","slug":"vcpkg-using-multiple-enlistments","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/cppblog\/vcpkg-using-multiple-enlistments\/","title":{"rendered":"Vcpkg: Using multiple enlistments to handle multiple versions of a library"},"content":{"rendered":"

Vcpkg allows you to acquire and build 3rd<\/sup> party libraries on Windows<\/a>. Once cloned, the vcpkg directory (enlistment) provides a stable set of libraries that are all compatible and based on the latest published version of these libraries. Occasionally, you may need different versions of the same library. By design, you can\u2019t have two different versions of the same library in the same enlistment; instead, you need to create and work with multiple enlistments.<\/p>\n

Creating multiple enlistments<\/h4>\n
1) Clone the git repository<\/h6>\n

To create multiple enlistments, just reclone the GitHub repo on a different location on your machine:<\/p>\n

git clone https:\/\/github.com\/Microsoft\/vcpkg.git<\/font><\/p>\n

By default, the master branch of vcpkg presents the latest version of libraries. If you need an older version, browse the file history of the library to see if the version you are looking for is available. The control file should display the version history.<\/p>\n

2) Find a specific version<\/h6>\n

For example, imagine you want to use OpenCV, but not the 3.3.0.4, but instead the 3.2.0 version:<\/p>\n

\"clip_image002\"<\/a><\/p>\n

Once you have identified the version, use the <> button to navigate the repo at this point in time. <\/p>\n

\"clip_image004\"<\/a><\/p>\n

3) Clone the repo for a specific label\/hash<\/h6>\n

You\u2019re now ready to clone the repo for OpenCV version 3.2.0 from February 8th<\/sup>, 2017. Note: it is important that all the libraries you are going to use came from the same label\/hash. By cloning the entire repo from that label\/hash the dependents libraries will be compatible with the version of the lib you selected.<\/p>\n

\"clip_image006\"<\/a><\/p>\n

Click on the commit hash, and then copy the \u201ccomplete\u201d commit hash:<\/p>\n

\"clip_image008\"<\/a><\/p>\n

This is the one to use for your new enlistment, via the git checkout command:<\/p>\n

\"clip_image010\"<\/a><\/p>\n

4) build vcpkg for a specific label\/hash<\/h6>\n

Don\u2019t forget to build vcpkg via the bootstrap file running:<\/p>\n

bootstrap-vcpkg.bat<\/font><\/p>\n

You\u2019re now ready to build OpenCV 3.2.0 with the dependencies corresponding to this version. <\/p>\n

Using multiple enlistments<\/h4>\n

Now you\u2019re ready to use your new\/specific version of your libraries. To switch between enlistments for your project, we provide two approaches:<\/p>\n

\u00b7 Reference the enlistment via the integrate project command<\/p>\n

\u00b7 Use the Export command to package the libraries in a NuGet Package (or in a raw or zip format)<\/p>\n

a) Run the vcpkg integrate project command:<\/h6>\n

\"clip_image012\"<\/a><\/p>\n

As mentioned in the comment, go to your project and add a reference to this NuGet Package. The NuGet Package contains only a \u201clink<\/u><\/strong><\/strong><\/b>\u201d to your new enlistment. Your project is now linked with the libraries present in the second enlistment. <\/p>\n

b) Run vcpkg export <mylibs> –nuget<\/h6>\n

\"clip_image014\"<\/a><\/p>\n

Once again, the command specifies how to use the NuGet generated package. In this second case, the NuGet Package contains the binary of the library, the .lib, the .h and the .pdb<\/u><\/strong><\/b>. Of course, it also contains all the dependencies needed by the library.<\/p>\n

We really value your feedback as an essential source of improvement. Please let us know if you have issues with this tool or usage scenario by opening an issue on GitHub or sending us an email at vcpkg@microsoft.com<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"

Vcpkg allows you to acquire and build 3rd party libraries on Windows. Once cloned, the vcpkg directory (enlistment) provides a stable set of libraries that are all compatible and based on the latest published version of these libraries. Occasionally, you may need different versions of the same library. By design, you can\u2019t have two different […]<\/p>\n","protected":false},"author":316,"featured_media":35994,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[272],"tags":[271,273],"class_list":["post-17325","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-vcpkg","tag-cpp","tag-vcpkg"],"acf":[],"blog_post_summary":"

Vcpkg allows you to acquire and build 3rd party libraries on Windows. Once cloned, the vcpkg directory (enlistment) provides a stable set of libraries that are all compatible and based on the latest published version of these libraries. Occasionally, you may need different versions of the same library. By design, you can\u2019t have two different […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/17325","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/users\/316"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/comments?post=17325"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/17325\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media\/35994"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media?parent=17325"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/categories?post=17325"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/tags?post=17325"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}