diff --git a/content/en/docs/concepts/lifecycle_management/velocitas_cli.md b/content/en/docs/concepts/lifecycle_management/velocitas_cli.md index e31b341d..6f9056c6 100644 --- a/content/en/docs/concepts/lifecycle_management/velocitas_cli.md +++ b/content/en/docs/concepts/lifecycle_management/velocitas_cli.md @@ -43,7 +43,7 @@ Config 'src' for interface 'vehicle-signal-interface': URI or path to VSS json ( ### velocitas init -Download packages configured in your `.velocitas.json` to [VELOCITAS_HOME](https://github.com/eclipse-velocitas/cli/blob/main/README.md#changing-default-velocitas_home-directory) +#### Download packages configured in your `.velocitas.json` to [VELOCITAS_HOME](https://github.com/eclipse-velocitas/cli/blob/main/README.md#changing-default-velocitas_home-directory) ```bash vscode ➜ /workspaces/vehicle-app-python-template (main) $ velocitas init @@ -57,6 +57,19 @@ Running 'install-deps' ... ``` +#### Single Package Init + +Single packages can also easily be initialized or re-initialized using the _package parameter_ `-p / --package` and the _specifier parameter_ `-s / --specifier`. The _specifier parameter_ can be either a git tag or a git hash. If the _specifier parameter_ is omitted either the version defined in `.velocitas.json` resp. the latest version of the specified package will be used automatically. After initialisation the package and it's resolved version will be written to `.velocitas.json`. If the package already exists in `.velocitas.json`, however the versions differ it will be automatically updated to the specified version. If no components from the specified package are added to `.velocitas.json` all components from this package are automatically written to it. + +```bash +vscode ➜ /workspaces/vehicle-app-python-template (main) $ velocitas init -p devenv-runtimes -s v3.0.0 +Initializing Velocitas packages ... +... Package 'devenv-runtimes:v3.0.0' added to .velocitas.json +... Downloading package: 'devenv-runtimes:v3.0.0' +... > Running post init hook for ... +... +``` + ### velocitas sync If any package provides files they will be synchronized into your repository.