SCORE Versioning

Owned by Pavel Veller (Unlicensed)
Last updated: May 12, 2016 by Former user (Deleted)
3 min read

Strategy

  • SCORE and SCORE Bootstrap UI are versioning using MAJOR.MINOR.BUILD.REVISION schema. For example, 1.2.215 is SCORE 1.2 build 215. The build number is the artifact of our CI process and we do release frequently. We have started working on version 1.2 in the beginning of 2014 with the plan to release it on Sitecore Symposium North America and that explains the high build number.  
  • SCORE and SCORE Bootstrap UI are always built against a specific Sitecore release. For example, Sitecore 7.2 initial release and Sitecore 7.2 Update 2 are two different releases. We are doing so to ensure full Sitecore API compliance and to provide better guarantees that SCORE has been tested and is fully functional in a target Sitecore environment. 

  • SCORE and SCORE Bootstrap UI version is the same for all builds in a release. For example, SCORE 1.2.215 for Sitecore 7.2 Update 2 and SCORE 1.2.215 for Sitecore 7.5 Initial Release represent exactly the same* SCORE codebase built against two different Sitecore versions. 

    When we say "exactly the same codebase" we mean exactly the same state of the code (think the same commit). There are certain differences between Sitecore releases that we have to account for. For example, Sitecore 7.2 introduced a new pipeline to publish "related" items and it made certain SCORE extension obsolete and no longer needed. We don't include that extension into our builds for Sitecore 7.2 and newer but we do include it into our builds for Sitecore 7.1 and lower.

  • SCORE and SCORE Bootstrap UI are versioned independently. As of the time of this writing the latest SCORE 1.2 release is 1.2.214 and the latest SCORE Bootstrap UI release is 1.2.42 There's very little API dependency between the two (SCORE Bootstrap UI is using very few SCORE APIs directly and those APIs are very stable). There are certain dependencies on Sitecore items (e.g. base data templates) but SCORE 1.2 has been sealed when it comes to data templates changes. The latest SCORE Bootstrap UI will work just fine with the latest SCORE build and SCORE 1.2.174 , for example. The two products are innovated on fairly independently.

SCORE and SCORE Bootstrap UI are distributed in two forms:

  • A NuGet package for development environment(s). NuGet packages comes bundled with the Sitecore .update packages that carry SCORE and SCORE Bootstrap UI Sitecore definition items and a powershell automation script to automate local install.
  • A release package (a zip file) with three different production configuration (PROD-Single, PROD-CM, and PROD-CD) for deployment into a target production environment. Read more about SCORE build profiles and configuration patches.

NuGet Packages

SCORE and SCORE Bootstrap UI packages have Sitecore version "baked" into their names. Example (SCORE and SCORE Bootstrap UI releases for 7.2 Update 2 and 7.1 Update 1):

.update packages bundled with the NuGet package are always built in PROD-Single assuming local Sitecore sandboxes are vanilla Sitecore installation and need both Content Management and Content Delivery configurations. If you need to set up separate CM and CD for your local environment you will need to use PROD-CM and PROD-CD packages from the release distribution (read below).

Release Packages

Release Packages follow a very similar naming convention and have both the product version and the Sitecore version in the name. Example (SCORE release packages for 7.2 Update 2 and 7.1 Update 1):

DLL Version Info

SCORE and SCORE Bootstrap UI DLLs have version info that carries the same information you saw on the release package and the NuGet package:

Assembly Version attribute for SCORE 1.2 is 1.2.0.0. File Version attribute carries the specific build version. Here's how a reference to a SCORE assembly will look like after a NuGet package install (or restore):

Runtime Version Info

You can always tell what version of SCORE, SCORE UI and SCORE Bootstrap UI is running in a given Sitecore environment by accessing the following URLs:

/score/about/version
/scoreui/about/version
/scorebootstrapui/about/version

About controller responds with a JSON:

   

  • Pavel Veller (Unlicensed) extend version info with the information about what Sitecore version this particular Score build was released against