1 Star 10 Fork 3

JackBoosY / vcpkg-tool

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MIT

Vcpkg: Overview

中文总览 Español 한국어 Français

Vcpkg helps you manage C and C++ libraries on Windows, Linux and MacOS. This tool and ecosystem are constantly evolving, and we always appreciate contributions!

Please see the main repository https://github.com/microsoft/vcpkg for all feature discussion, issue tracking, and edits to which libraries are available.

Vcpkg-tool: Overview

This repository contains the contents formerly at https://github.com/microsoft/vcpkg in the "toolsrc" tree, and build support.

vcpkg-artifacts

vcpkg-artifacts are currently in 'preview' -- there will most certainly be changes between now and when the tool is 'released' based on feedback.

You can use it, but be forewarned that we may change formats, commands, etc.

Think of it as a manifest-driven desired state configuration for C/C++ projects.

It

  • integrates itself into your shell (PowerShell, CMD, bash/zsh)
  • can restore artifacts according to a manifest that follows one’s code
  • provides discoverability interfaces

Installation

While the usage of vcpkg-artifacts is the same on all platforms, the installation/loading/removal is slightly different depending on the platform you're using.

vcpkg-artifacts don't persist any changes to the environment, nor do they automatically add themselves to the start-up environment. If you wish to make it load in a window, you can just execute the script. Manually adding that in your profile will load it in every new window.


Install/Use/Remove

OS Install Use Remove
PowerShell/Pwsh iex (iwr -useb https://aka.ms/vcpkg-init.ps1) . ~/.vcpkg/vcpkg-init.ps1 rmdir -recurse -force ~/.vcpkg
Linux/OSX . <(curl https://aka.ms/vcpkg-init.sh -L) . ~/.vcpkg/vcpkg-init rm -rf ~/.vcpkg
CMD Shell curl -LO https://aka.ms/vcpkg-init.cmd && .\vcpkg-init.cmd %USERPROFILE%\.vcpkg\vcpkg-init.cmd rmdir /s /q %USERPROFILE%\.vcpkg

Glossary

Term Description
artifact An archive (.zip or .tar.gz-like), package (.nupkg, .vsix) binary inside which build tools or components thereof are stored.
artifact metadata A description of the locations one or more artifacts describing rules for which ones are deployed given selection of a host architecture, target architecture, or other properties
artifact identity A short string that uniquely describes a moniker that a given artifact (and its metadata) can be referenced by. They can have one of the following forms:
full/identity/path - the full identity of an artifact that is in the built-in artifact source
sourcename:full/identity/path - the full identity of an artifact that is in the artifact source specified by the sourcename prefix
shortname - the shortened unique name of an artifact that is in the built-in artifact source
sourcename:shortname - the shortened unique name of an artifact that is in the artifact source specified by the sourcename prefix
Shortened names are generated based off the shortest unique identity path in the given source.
artifact source Also known as a “feed”. An Artifact Source is a location that hosts metadata to locate artifacts. (There is only one source currently)
activation The process by which a particular set of artifacts are acquired and enabled for use in a calling command program.
versions Version numbers are specified using the Semver format. If a version for a particular operation isn't specified, a range for the latest version ( * ) is assumed. A version or version range can be specified using the npm semver matching syntax. When a version is stored, it can be stored using the version range specified, a space and then the version found. (ie, the first version is what was asked for, the second is what was installed. No need for a separate lock file.)

Contributing

Please refer to the "contributing" section of the main README.md.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or email opencode@microsoft.com with any additional questions or comments.

Windows Contributing Prerequisites

  • Install Visual Studio and the C++ workload
  • Install Node.JS by downloading a 16.x copy from https://nodejs.org/en/
  • npm install -g @microsoft/rush

Ubuntu 22.04 Contributing Prerequisites

curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt update
sudo apt install nodejs cmake ninja-build gcc build-essential git zip unzip
sudo npm install -g @microsoft/rush

License

The product code in this repository is licensed under the MIT License. The tests contain 3rd party code as documented in NOTICE.txt.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.

Telemetry

vcpkg collects usage data in order to help us improve your experience. The data collected by Microsoft is anonymous. You can opt-out of telemetry by re-running the bootstrap-vcpkg script with -disableMetrics, passing --disable-metrics to vcpkg on the command line, or by setting the VCPKG_DISABLE_METRICS environment variable.

Read more about vcpkg telemetry at https://learn.microsoft.com/vcpkg/about/privacy in the main repository

Copyright (c) Microsoft Corporation All rights reserved. MIT License Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

vcpkg二进制组件 展开 收起
MIT
取消

发行版 (23)

全部

贡献者

全部

近期动态

加载更多
不能加载更多了
C++
1
https://gitee.com/jackboosy/vcpkg-tool.git
git@gitee.com:jackboosy/vcpkg-tool.git
jackboosy
vcpkg-tool
vcpkg-tool
main

搜索帮助

14c37bed 8189591 565d56ea 8189591