Exploring Sustainable Open Source: Insights from Scott Hanselman and Sean Walker
- OpenSource
- DotNetNuke
- Sustainability
- TechCommunity
- SoftwareDevelopment
- BusinessModel
- HanselmanToday
Created 13-Dec-2024 2024-W50
Read Blog
Updating Third-Party Components in Oqtane Modules and Themes
With the rapid speed of releases for third-party Blazor components, this guide aims to help you upgrade your solutions efficiently. By providing these instructions, we can focus on updating the Template packages only during major upgrades, allowing more time to create templates for other high-quality third-party components.
Upgrading a Module
- Open your module solution and select the Client Project.
- Navigate to the Packages section and update the third-party component to the latest version.
- Select the Server Project and navigate to its Packages section.
- Update the third-party component to the latest version in the Server Project as well.
- In the Server project, navigate to the
wwwrootfolder and expand the"_content\Third-Party Component Name]"folder. - Delete all contents within the third-party component folder.
- Perform the same deletion in the Oqtane.Server
wwwrootfolder, under the"_content$$Third-Party Component Name]"folder. - Right-click on the third-party component package icon and select "Open Folder in File Explorer" from the context menu.
- In File Explorer, open the folder named "staticwebassets".
- Copy all contents from "staticwebassets" into the
"_content\Third-Party Component Name]"folder. - Build your module.
Upgrading a Theme
- Open your theme solution and navigate to the Packages section.
- Update the third-party component to the latest version.
- Navigate to the
wwwrootfolder and expand the"_content\Third-Party Component Name]"folder. - Delete all contents within the third-party component folder.
- Perform the same deletion in the Oqtane.Server
wwwrootfolder, under the"_content\Third-Party Component Name]"folder. - Right-click on the third-party component package icon and select "Open Folder in File Explorer" from the context menu.
- In File Explorer, open the folder named "staticwebassets".
- Copy all contents from "staticwebassets" into the
"_content\Third-Party Component Name]"folder. - Build your theme.
Troubleshooting
- If you encounter the error: "Conflicting assets with the same target path '_content/[Third-Party Component Name]/ ....'", follow these steps:Open your
.csprojfile. - Add the following
ItemGroup:
xml
<ItemGroup>
<Content Remove="wwwroot\_content\**\*.*" />
<None Include="wwwroot\_content\**\*.*" />
</ItemGroup>
- Save the project file and recompile.
Final Steps
After completing the upgrade process for either modules or themes, make sure to thoroughly test all functionality to ensure everything works as expected. By following this guide, you can keep your Oqtane modules and themes up-to-date with the latest third-party Blazor components, ensuring optimal performance and compatibility.