vcpkg x-add-version
Note
This section covers an experimental feature of vcpkg which may change or be removed at any time.
vcpkg x-add-version [port-name] [options] [--all] [--overwrite-version] [--skip-formatting-check] [--skip-version-format-check] [--verbose]
The x-add-version
command updates the version database for vcpkg ports. By default, it operates on a specified port. With the appropriate switches, users can choose to process all ports or change the default behavior regarding formatting checks and version updates.
To use the command:
- After making changes to a port, navigate to the vcpkg directory.
- Run
vcpkg x-add-version <port-name>
, replacing<port-name>
with the name of the port you've edited.
This will add or update the version entry for your port in the version database.
All vcpkg commands support a set of common options.
Specifies the name of the port to be updated. If not provided, the user should use the --all
option to process all ports.
Processes all the ports in the built-in ports
directory.
Allows overwriting an existing version in the database.
Without this flag, vcpkg will refuse to overwrite existing versions.
Note
This option is designed for ongoing development when preparing a version for registry inclusion. For example, consider addressing an issue in the foo
port and executing vcpkg x-add-version foo
. For subsequent modifications to the port, utilize vcpkg x-add-version foo --overwrite-version
to refresh the version entry prior to registry inclusion.
Skips the check for proper formatting in the manifest file (vcpkg.json
) of the port. By default, proper formatting is checked and required.
Skips the version format check. By default, versions are checked to ensure they adhere to a specific format.
Provides verbose output, giving more details about the operations being carried out.
vcpkg feedback
vcpkg is an open source project. Select a link to provide feedback: