You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/release-information/update-to-version-3-1000/update-platform-and-modules-to-3-1000.md
+12-18Lines changed: 12 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -31,21 +31,21 @@ Stability is a cornerstone of this update. By leveraging the advancements in .NE
31
31
32
32
1.**Install .NET 10:** Begin by ensuring that you have .NET 10 installed on your system. Follow the official installation guidelines to set up the environment for the upgrade: https://dotnet.microsoft.com/en-us/download/dotnet/10.0
33
33
2.**Update Virto Commerce Platform to v3.1000 or later**
34
-
3.**Update Customer Module and XAPI to v3.1000 or later**
34
+
3.**Update [Customer](https://github.com/VirtoCommerce/vc-module-customer)and [XAPI](https://github.com/VirtoCommerce/vc-module-x-api) modules to v3.1000 or later**
35
35
4.**Update other Virto Commerce Modules to [Stable Release 12](https://docs.virtocommerce.org/platform/user-guide/1.0/versions/v3-2025-S12/) and later**.
36
36
37
-
> By default, Virto Commerce Platform on .NET10 are backward compatible with previous platform stable release on .NET8 (3.800+). However, it is recommended to update custom modules to the latest versions to leverage new features and improvements.
37
+
> By default, Virto Commerce Platform on .NET10 is backwards compatible with previous platform stable releases on .NET8 (3.800+). However, it is recommended to update custom modules to the latest versions to leverage new features and improvements.
38
38
39
39
## Known Limitations and Breaking Changes
40
40
41
-
If you find any new breaking changes, submit an question on [Virto Commerce Community](https://www.virtocommerce.org/c/support/12).
41
+
If you find any new breaking changes, submit a question on [Virto Commerce Community](https://www.virtocommerce.org/c/support/12).
42
42
43
43
### Pomelo.EntityFrameworkCore.MySql v9.0.0
44
44
Virto Commerce uses Pomelo.EntityFrameworkCore.MySql 9.0.0 for MySql.
45
45
46
46
### Exception is thrown when applying migrations if there are pending model changes
47
47
48
-
Starting with EF Core 9.0, if the model has pending changes compared to the last migration an exception is thrown when dotnet ef database update, Migrate or MigrateAsync is called:
48
+
Starting with EF Core 9.0, if the model has pending changes compared to the last migration, an exception is thrown when dotnet ef database update, Migrate or MigrateAsync is called:
49
49
50
50
The model for context 'DbContext' has pending changes. Add a new migration before updating the database. This exception can be suppressed or logged by passing event ID 'RelationalEventId.PendingModelChangesWarning' to the 'ConfigureWarnings' method in 'DbContext.OnConfiguring' or 'AddDbContext'.
51
51
@@ -56,12 +56,12 @@ You can find more information about PendingModelChangesWarning warning by [follo
56
56
### Breaking changes in Microsoft.OpenApi
57
57
58
58
Virto Commerce updated Microsoft.OpenApi from version 1.0.0 to 2.3.0 that includes some breaking changes. You will need to update and rebuild your custom module if you use Microsoft.OpenApi.
59
-
You can find more information about Breaking changes in Microsoft.OpenApi by [following link](https://github.com/microsoft/OpenAPI.NET/blob/main/docs/upgrade-guide-2.md).
59
+
You can find more information about breaking changes in Microsoft.OpenApi by [following link](https://github.com/microsoft/OpenAPI.NET/blob/main/docs/upgrade-guide-2.md).
60
60
61
61
## Remove BuildHost-net472 and BuildHost-netcore
62
62
63
63
After update Microsoft.EntityFrameworkCore.Design to 10.x, you will see that your project includes two folders BuildHost-net472 and BuildHost-netcore under obj folder.
64
-
These folders are created by Microsoft.EntityFrameworkCore.Design package to support design-time services for different target frameworks.
64
+
These folders are created by Microsoft.EntityFrameworkCore.Design a package to support design-time services for different target frameworks.
65
65
66
66
You can remove these two folders by modifying your .csproj file to include the following PackageReference for Microsoft.EntityFrameworkCore.Design with PrivateAssets set to all:
67
67
@@ -80,17 +80,17 @@ You can get the ModuleTypeLoadingException exception after updating platform and
80
80
Unhandled exception. VirtoCommerce.Platform.Core.Modularity.Exceptions.ModuleTypeLoadingException: Failed to load type for module SomeModule.
81
81
Cannot load "Microsoft.IO.RecyclableMemoryStream" for module ...
82
82
```
83
-
In .NET 10, Microsoft refresh and excluded some assemblies (dll) that are no longer needed.
83
+
In .NET 10, Microsoft refreshed and excluded some assemblies (dll) that are no longer needed.
84
84
85
-
To resolve the issue you can:
85
+
To resolve the issue, you can:
86
86
87
-
Option 1. Add module.keep file to your custom module project with the following content, it adds required dll into module package:
87
+
Option 1. Add module.keep file in your custom module project with the following content, it adds the required dll into module package:
88
88
89
89
```txt
90
90
Microsoft.IO.RecyclableMemoryStream.dll
91
91
```
92
92
93
-
Option 2. Update your module to .NET 10 using instructions below.
93
+
Option 2. Update your module to .NET 10 using the instructions below.
94
94
95
95
## 415 Client Error: Unsupported Media Type
96
96
@@ -120,7 +120,7 @@ vc-build Update -Stable -v 12
120
120
121
121
### Option 2. Update via package.json
122
122
123
-
If you use package.json file for automated deployment, change versions of the platform and Virto Commerce modules to 3.1000.0+. Based on latest Stable 8 or Edge release strategy.
123
+
If you use package.json file for automated deployment, change versions of the platform and Virto Commerce modules to 3.1000.0+. Based on latest Stable 12 or Edge release strategy.
124
124
125
125
### Option 3. Manually update
126
126
@@ -167,19 +167,13 @@ Download and execute the [vc-net10-update.ps1 Power Shell script](vc-net10-updat
167
167
./vc-net10-update.ps1
168
168
```
169
169
170
-

171
-
172
-

173
-
174
170
This script automates several these tasks, including (of course you can do it manually):
175
171
176
172
1. Updating the Target Framework to .NET 10 for every project.
177
173
2. Updating project dependencies, including Microsoft NuGet dependencies to version 10.0.0 and VirtoCommerce NuGet dependency to version 3.1000.0 and latest.
178
-
3. Updating other third-party dependencies to save version that used by Virto Commerce Platform.
174
+
3. Updating other third-party dependencies to the version used by Virto Commerce Platform .NET10.
179
175
4. Updating the module.manifest file to align with the changes in .NET 10.
1. Build the solution and meticulously address any compilation errors and warnings if required. This step ensures that the solution is compatible with the updated framework.
0 commit comments