Enabling the GitHub dependency graph<\/h3>\n
Enabling the dependency graph for your repository is a requirement for vcpkg to be able to populate the dependencies for your repository. The dependency graph is enabled by default for public repositories on GitHub. If you want the dependency graph enabled for a private repository, you should follow the GitHub documentation to enable the dependency graph<\/a>.<\/p>\n If you are already using reusable actions in your GitHub Actions workflows and the dependency graph is enabled, there’s a good chance your repository’s dependency graph already has some dependencies listed. Check it out by selecting Insights<\/strong> for your repository and then selecting Dependency graph<\/strong>.<\/p>\n There are two ways that the dependency graph may get populated. For some package management systems that have a static list of dependencies that can be fully described in a manifest file, GitHub will automatically scan those manifests once they are pushed into your repository and will begin showing up in the dependency graph.<\/p>\n For package management systems that are more dynamic, the tools used to process the list of dependencies must be involved in determining the complete set of dependencies. The complete set of dependencies for C and C++ are usually highly dependent upon build configuration and target platform. For these ecosystems, GitHub has a dependency submission API<\/a> that tools can use to provide the dependency information, usually as a part of a GitHub Actions workflow job.<\/p>\n vcpkg integration with the GitHub dependency graph can be enabled by adding the value Once those changes have been made, and your workflow runs again, you should begin to see the dependencies in your vcpkg.json manifest listed in the Dependency graph<\/strong> section on GitHub.<\/p>\n See our documentation at GitHub integration – The GitHub dependency graph<\/a> for more information.<\/p>\n A live example template repository<\/a> is on GitHub if you want to try it out in a clean project. If you want to try it out on an existing project, see the workflow files defined below that shows the changes you need to make to enable the feature.<\/p>\n Both workflow examples below work with the vcpkg.json<\/strong><\/p>\n main.cpp<\/strong><\/p>\n Add the following files to test the vcpkg dependency graph integration when using CMake.<\/p>\n CMakeLists.txt<\/strong><\/p>\n .github\/workflows\/cmake.yml<\/strong><\/p>\n Add the following file to test the vcpkg dependency graph integration with workflows that call .github\/workflows\/build.yml<\/strong><\/p>\n We are gathering feedback from users to determine the improvements we need to make to consider this integration fully supported. This is the foundation for opening up really powerful, Enterprise-grade dependency management for our users, and we are excited to have you all try it out. You can find the feature and the latest bug fixes in the most recent commit to the vcpkg<\/a> default branch.<\/p>\n As usual, if you have feedback, leave us a comment below or contact us on Twitter (@VisualC<\/a>) or via email at visualcpp@microsoft.com<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":" Introducing vcpkg’s integration with the GitHub dependency graph<\/p>\n","protected":false},"author":85414,"featured_media":28096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3920,230,272],"tags":[],"class_list":["post-32491","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-github","category-new-feature","category-vcpkg"],"acf":[],"blog_post_summary":" Introducing vcpkg’s integration with the GitHub dependency graph<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/32491","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\/85414"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/comments?post=32491"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/32491\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media\/28096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media?parent=32491"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/categories?post=32491"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/tags?post=32491"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}![\"Screenshot](\"https:\/\/devblogs.microsoft.com\/cppblog\/wp-content\/uploads\/sites\/9\/2023\/06\/github-enable-dependencygraph.png\")
<\/p>\n![\"Screenshot](\"https:\/\/devblogs.microsoft.com\/cppblog\/wp-content\/uploads\/sites\/9\/2023\/06\/github-insights-dependencygraph.png\")
<\/p>\nTechniques for populating the dependency graph<\/h3>\n
Reporting dependencies with vcpkg<\/h2>\n
dependencygraph<\/code> to the VCPKG_FEATURE_FLAGS<\/code> environment variable within your GitHub Actions workflow file that runs vcpkg (either directly or indirectly via CMake). You must also modify your workflow file to set the GITHUB_TOKEN<\/code> environment variable with the value ${{ secrets.GITHUB_TOKEN }}<\/code> and request permission for the workflow job to write the dependency information into your repository’s metadata by including the following YAML snippet near the top of your workflow file.<\/p>\npermissions:\r\n contents: write<\/code><\/pre>\nExamples<\/h3>\n
vcpkg.json<\/code> and main.cpp<\/code> files listed here.<\/p>\n{\r\n \"name\": \"your-project\",\r\n \"version-string\": \"0.0.1\",\r\n \"dependencies\": [\r\n \"fmt\"\r\n ]\r\n}<\/code><\/pre>\n#define FMT_HEADER_ONLY\r\n#include \"fmt\/color.h\"\r\n\r\nint main(int argc, char** argv)\r\n{\r\n fmt::print(\r\n fg(fmt::color::light_salmon),\r\n \"\u00a1Hola, Mundo!\\n\"\r\n );\r\n}<\/code><\/pre>\nIndirectly through CMake integration<\/h4>\n
cmake_minimum_required(VERSION 3.15)\r\n\r\nproject(your-project CXX)\r\nfind_package(fmt REQUIRED)\r\nset(CMAKE_CXX_STANDARD 20)\r\n\r\nadd_executable(hola main.cpp)\r\n\r\ntarget_link_libraries(hola\r\n PRIVATE\r\n fmt::fmt)<\/code><\/pre>\nname: Example that uses CMake integration\r\n\r\non:\r\n workflow_dispatch:\r\n\r\n###############################################################################\r\n# Add this section to your workflow file does not already have it to enable\r\n# the job to write the dependency metadata.\r\n###############################################################################\r\npermissions:\r\n contents: write\r\n\r\n###############################################################################\r\n# Add these environment variables to your workflow to enable the vcpkg\r\n# dependency graph integration.\r\n###############################################################################\r\nenv:\r\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\r\n VCPKG_FEATURE_FLAGS: dependencygraph\r\n\r\njobs:\r\n cmake:\r\n runs-on: ubuntu-latest\r\n\r\n # These steps assume an appropriate version of vcpkg is listed as a\r\n # submodule in your git repo. If it is not, you must update this workflow\r\n # to obtain it.\r\n\r\n steps:\r\n - uses: actions\/checkout@v3\r\n with:\r\n submodules: 'recursive' \r\n\r\n - name: Bootstrap vcpkg\r\n run: ${{ github.workspace }}\/vcpkg\/bootstrap-vcpkg.sh\r\n\r\n - name: Configure with CMake\r\n run: |\r\n cmake -B build -S ${{ github.workspace }} \\\r\n -DCMAKE_TOOLCHAIN_FILE=${{ github.workspace }}\/vcpkg\/scripts\/buildsystems\/vcpkg.cmake\r\n\r\n - name: Build with CMake\r\n run: cmake --build build\r\n\r\n - name: Hola, amigos\r\n run: ${{ github.workspace }}\/build\/hola<\/code><\/pre>\nDirectly calling
vcpkg install<\/code><\/h4>\nvcpkg install<\/code> directly.<\/p>\nname: Example that directly invokes `vcpkg install`\r\n\r\non:\r\n push:\r\n branches: [ main ]\r\n workflow_dispatch:\r\n\r\n###############################################################################\r\n# Add this section to your workflow file does not already have it to enable\r\n# the job to write the dependency metadata.\r\n###############################################################################\r\npermissions:\r\n contents: write\r\n\r\n###############################################################################\r\n# Add these environment variables to your workflow to enable the vcpkg\r\n# dependency graph integration.\r\n###############################################################################\r\nenv:\r\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\r\n VCPKG_FEATURE_FLAGS: dependencygraph\r\n\r\njobs:\r\n build:\r\n runs-on: ubuntu-latest\r\n\r\n # These steps assume an appropriate version of vcpkg is listed as a\r\n # submodule in your git repo. If it is not, you must update this workflow\r\n # to obtain it.\r\n\r\n steps:\r\n - uses: actions\/checkout@v3\r\n with:\r\n submodules: 'recursive' \r\n\r\n - name: Bootstrap vcpkg\r\n run: ${{ github.workspace }}\/vcpkg\/bootstrap-vcpkg.sh\r\n\r\n - name: Directly invoke `vcpkg install`\r\n run: ${{ github.workspace }}\/vcpkg\/vcpkg install\r\n\r\n - name: Build with G++\r\n run: g++ -I${{ github.workspace }}\/vcpkg_installed\/x64-linux\/include -o hola main.cpp\r\n\r\n - name: Hola, amigos\r\n run: ${{ github.workspace }}\/hola<\/code><\/pre>\nCall to action<\/h2>\n