Upgrades
Upgrades
Brightspot Enterprise 4.5 Developer Upgrade Guide

Brightspot Dependency Version Upgrades Guide



Below are the relevant versions to be used for the Brightspot 4.5 Upgrade Guide

  • Brightspot: 4.5.22
  • Component-lib: 4.5.23
  • Brightspot-GO: Refer to below table
Current Version RangeUpgrade To Version
0.x0.18.0
1.x1.4.6


Update the Brightspot version number in the root build.gradle in accordance to the referenced versions above.

After updating this version, resolve any build errors. Refer to the troubleshooting guide below for more help.


Update the Component-Lib version number in the root build.gradle in accordance to the referenced versions above.

Note
Compiler errors here are unexpected, so please flag any failures for further analysis.


Update the Brightspot GO version number in the root build.gradle in accordance to the referenced versions above.

Note
Compiler errors here are unexpected, so flag any failures for further analysis.


Below are the known breaking changes for Brightspot upgrades and Component-lib.

Brightspot

ContentEditDrawerWriter interface removed

The interface ContentEditDrawerWriter has been removed and replaced with a different implementation.

Resolution:

Remove all implementations of ContentEditDrawerWriter. Historically, these have only existed on brightspot.core.page.OneOffPage , but check the entire code base.

New implementation: ContentEditDrawerItem


See Adding 4.5 Features to Your Project Guide (Shelf)

Caution
When removing the ContentEditDrawerWriter interface, make sure to remove implementation of writeContentEditDrawerHtml. This method does not need to be moved to a new location or replaced.


ToolRequest.localizeText was removed

In 4.5, the method ToolRequest.localizeText was removed, and will cause build errors after upgrading.

Resolution:

Replace usages of ToolRequest.localizeText with ToolLocalization.text.

Before:

ToolRequest.localizeText(this, "placeholder.required"); 


After:

ToolLocalization.text(this, "placeholder.required"); 


ListMergeStrategy interface relocation

After upgrading, you may run into an error such as:

brightspot.core.cascading.listmerge.ListMergeStrategy<NavigationLink> is not compatible with brightspot.listmerge.ListMergeStrategy<NavigationLink>
  where T is a type-variable:
  
error: getMergeStrategy() in ModuleTypeListValueOverrideAfter cannot override getMergeStrategy() in AbstractListValueOverride


Resolution:

You will need to change the import path of ListMergeStrategy to the relocated package.

Old: brightspot.core.cascading.listmerge.ListMergeStrategy

New: brightspot.listmerge.ListMergeStrategy

Previous Topic
Styleguide Upgrade Guide
Next Topic
Resolve Unsupported Dependencies Guide
Was this topic helpful?
Thanks for your feedback.

Browse All Docs

Everything you need to know when creating, managing, and administering content within Brightspot CMS.

Dashboards
Publishing
Workflows
Admin configurations
A guide for installing, supporting, extending, modifying and administering code on the Brightspot platform.

Field types
Content modeling
Rich-text elements
Images
A guide to configuring Brightspot's library of integrations, including pre-built options and developer-configured extensions.

Google Analytics
Shopify
Apple News
Brightspot is packaged with content types that get you up and running in a matter of days, including assets, modules and landing pages.

Assets
Modules
Landing pages
Our robust, flexible Design System provides hundreds of pre-built components you can use to build the presentation layer of your dreams.

Asset types
Module types
Page types