Creating project versions

You can create and manage versions of a project package to track changes and updates.

Before you begin

Before you create a new version, make sure that your project and user meet the following requirements.

  • The Project uses an external Git repository.
  • You have the required permissions to modify the project repository.
  • The working branch is in the correct state.
  • The new version follows semantic versioning in the MAJOR.MINOR.PATCH format.

About this task

You can create and manage versions of a project package directly from the Packages page, without manually editing the package manifest in Git.

Procedure

  1. From the navigation menu, go to Projects and select a project.
  2. Click a project card for which you want to view the project package details.
    Note: For projects that support versioning, the current version is displayed on the project card.
  3. Click Packages.
  4. On the Packages page, click the package that you want to update.
  5. In Git branch/tag, select a particular branch or tag of the repository to use as the source for the package.
  6. From the Git branch/tag drop-down menu, select a particular branch or tag of the repository to use as the source for the package, and click Pull to retrieve the most recent changes from the repository.
  7. For Version, click Add.
  8. In the Create a new release version dialog, enter the new version number in the semantic format, and click Next.
    For example, 1.0.1.
  9. Select the option to either include or exclude the uncommitted changes.
  10. Click Create.
    A new release branch and a new version are created. The manifest file is also updated.