инструмент vcpkg

Вкпкг: Обзор

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

Vcpkg помогает вам управлять библиотеками C и C++ в Windows, Linux и MacOS. Этот инструмент и экосистема постоянно развиваются, и мы всегда ценим вклад!

Пожалуйста, посетите основной репозиторий https://github.com/microsoft/vcpkg для обсуждения всех функций, отслеживания проблем и внесения изменений в доступные библиотеки.

Инструмент Vcpkg: Обзор

Этот репозиторий содержит содержимое, ранее находившееся по адресу https://github.com/microsoft/vcpkg в дереве «toolsrc», а также поддержку сборки.

vcpkg-артефакты

vcpkg-artifacts в настоящее время находится в «предварительной версии» — наверняка будут изменения между настоящим моментом и моментом «выпуска» инструмента на основе отзывов.

Вы можете использовать его, но имейте в виду, что мы можем изменить форматы, команды и т. д.

Думайте об этом как о конфигурации желаемого состояния, управляемой манифестом, для проектов C/C++.

Это

• интегрируется в вашу оболочку (PowerShell, CMD, bash/zsh)
• может восстанавливать артефакты в соответствии с манифестом, который соответствует вашему коду
• предоставляет интерфейсы обнаружения

Установка

Хотя использование vcpkg-artifacts одинаково на всех платформах, установка/загрузка/удаление немного отличается в зависимости от используемой вами платформы.

vcpkg-artifacts не сохраняют никаких изменений в среде и не добавляются автоматически в среду запуска. Если вы хотите, чтобы он загружался в окне, вы можете просто выполнить скрипт. Если вы вручную добавите это в свой профиль, оно будет загружаться в каждом новом окне.

---

Установить/Использовать/Удалить

ОС	Установить	Использовать	Удалять
PowerShell/Пвш	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 оболочка	curl -LO https://aka.ms/vcpkg-init.cmd && .vcpkg-init.cmd	%USERPROFILE%.vcpkgvcpkg-init.cmd	rmdir /s /q %USERPROFILE%.vcpkg

Глоссарий

Срок	Описание
artifact	Архив (.zip или .tar.gz), двоичный файл пакета (.nupkg, .vsix), внутри которого хранятся инструменты сборки или их компоненты.
artifact metadata	Описание местоположений одного или нескольких артефактов, описывающих правила, для которых они развернуты, с учетом выбора архитектуры хоста, целевой архитектуры или других свойств.
artifact identity	Короткая строка, которая уникальным образом описывает прозвище, по которому можно ссылаться на данный артефакт (и его метаданные). Они могут иметь одну из следующих форм: full/identity/path — полный идентификатор артефакта, находящегося во встроенном источнике артефакта. sourcename:full/identity/path — полный идентификатор артефакта, находящегося в источнике артефакта, указанном префиксом имени источника. shortname — сокращенное уникальное имя артефакта, находящегося во встроенном источнике артефакта. sourcename:shortname — сокращенное уникальное имя артефакта, находящегося в источнике артефакта, указанном префиксом sourcename. Сокращенные имена генерируются на основе кратчайшего уникального пути идентификации в данном источнике.
artifact source	Также известен как «корм». Источник артефакта — это место, в котором хранятся метаданные для поиска артефактов. ( На данный момент существует только один источник )
activation	Процесс, посредством которого определенный набор артефактов приобретается и разрешается использовать в вызывающей командной программе.
versions	Номера версий указываются в формате Semver. Если версия для конкретной операции не указана, предполагается диапазон последней версии ( * ). Версию или диапазон версий можно указать с помощью синтаксиса сопоставления npm semver. Когда версия сохраняется, ее можно сохранить, используя указанный диапазон версий, пробел, а затем найденную версию. (т.е. первая версия — это то, что было запрошено, вторая — то, что было установлено. Нет необходимости в отдельном файле блокировки.)

Содействие

Пожалуйста, обратитесь к разделу «Содействие» основного README.md .

В этом проекте принят Кодекс поведения Microsoft с открытым исходным кодом. Для получения дополнительной информации см. часто задаваемые вопросы о Кодексе поведения или отправьте электронное письмо по адресу [email protected], если у вас возникнут дополнительные вопросы или комментарии.

Предварительные требования для участия в Windows

• Установите Visual Studio и рабочую нагрузку C++.
• Установите Node.JS, загрузив копию 16.x с https://nodejs.org/en/.
• npm install -g @microsoft/rush

Ubuntu 22.04 Предварительные условия для участия

 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

Лицензия

Код продукта в этом репозитории лицензируется по лицензии MIT. Тесты содержат сторонний код, как описано в NOTICE.txt .

Товарные знаки

Этот проект может содержать товарные знаки или логотипы проектов, продуктов или услуг. Разрешенное использование товарных знаков и логотипов Microsoft регулируется и должно соответствовать Руководству Microsoft по товарным знакам и брендам. Использование товарных знаков или логотипов Microsoft в измененных версиях этого проекта не должно вызывать путаницу или подразумевать спонсорство Microsoft. Любое использование товарных знаков или логотипов третьих лиц регулируется политикой этих третьих сторон.

Телеметрия

vcpkg собирает данные об использовании, чтобы помочь нам улучшить ваш опыт. Данные, собираемые Microsoft, являются анонимными. Вы можете отказаться от телеметрии, перезапустив сценарий bootstrap-vcpkg с параметром -disableMetrics, передав параметр --disable-metrics в vcpkg в командной строке или установив переменную среды VCPKG_DISABLE_METRICS.

Дополнительную информацию о телеметрии vcpkg можно найти по адресу https://learn.microsoft.com/vcpkg/about/privacy в основном репозитории.