Table of Contents

🧭 Upgrade OpenSettings v1.1 ➡ v1.2

⚠️ This page outlines the steps required to upgrade from version 1.1.* to 1.2.* of OpenSettings.

📦 Affected Packages

Ensure you update the following NuGet packages:

  • OpenSettings → 1.2.*
  • OpenSettings.AspNetCore → 1.2.*
  • OpenSettings.AspNetCore.Spa → 1.2.*

You can update via CLI:

dotnet add package OpenSettings --version 1.2.*
dotnet add package OpenSettings.AspNetCore --version 1.2.*
dotnet add package OpenSettings.AspNetCore.Spa --version 1.2.*

🎢 Generate Migration

If your application acts as a provider and persists data using the included OpenSettingsDbContext, you'll need to apply a database migration

Run the following command from your executable project directory:

dotnet ef migrations add OpenSettingsDbMigration_v1_2 -c OpenSettingsDbContext -o Data/Migrations/OpenSettings/OpenSettingsDb

✅ Verify: After executing the command, you should see:

  • ..._OpenSettingsDbMigration_v1.2.cs
  • ..._OpenSettingsDbMigration_v1.2.Designer.cs

Inside:

Data/Migrations/OpenSettings/OpenSettingsDb/
Important

For EF tools setup and guidance, refer to our Migration Guide.

🛠 Troubleshooting

If you run into any errors during the upgrade process, please check out the Troubleshooting page for common issues and solutions.

✨ OpenSettings makes settings management simple and efficient! 🚀

Edit this page