Skip to content

Commit d3cc537

Browse files
authored
Merge pull request #6582 from nikolajlauridsen/v15/clarify-breaking-changes-resolution
V15: Clarify breaking changes resolution
2 parents 1dc8c29 + edbf141 commit d3cc537

File tree

1 file changed

+26
-2
lines changed
  • 15/umbraco-cms/fundamentals/setup/upgrading/version-specific

1 file changed

+26
-2
lines changed

15/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md

Lines changed: 26 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,32 @@ Snapshots have been removed, meaning any code using `IPublishedSnapshot`, and by
2929

3030
Models generated by ModelsBuilder used the `IPublishedSnapshot` interface, which has been removed. This means that the models need to be rebuilt. The approach to this will differ depending on the mode chosen:
3131

32-
* InMemoryAuto - Remove the `umbraco\Data\TEMP\InMemoryAuto` folder to trigger a rebuild of the models.
33-
* SourceCodeAuto and SourceCodeManual - Remove the old models located in the `\umbraco\models` folder by default. Trigger a rebuild of the models from the ModelsBuilder dashboard in the backoffice.
32+
**InMemoryAuto**
33+
34+
Remove the `umbraco\Data\TEMP\InMemoryAuto` folder to trigger a rebuild of the models.
35+
36+
**SourceCodeAuto and SourceCodeManual**
37+
38+
Remove the old models located in the `\umbraco\models` folder by default. This will cause your views to no longer be able to build due to missing types.
39+
To get around this you can disable the precompiled view temporarily by adding the following to your `.csproj` file:
40+
41+
```xml
42+
<PropertyGroup>
43+
<RazorCompileOnBuild>false</RazorCompileOnBuild>
44+
<RazorCompileOnPublish>false</RazorCompileOnPublish>
45+
</PropertyGroup>
46+
```
47+
48+
This will allow your site to start up, but you will still see an error page when loading a page.
49+
50+
1. Disregard the error.
51+
2. Enter the backoffice.
52+
3. Rebuild the models from the ModelsBuilder dashboard.
53+
54+
You can now re-enable precompiled views and rebuild your site.
55+
56+
If you have custom C# code that references the models this will also not build. You can either comment out your custom code temporarily until the models have been rebuilt or fix the models manually.
57+
To fix the models manually you need to find and replace `IPublishedSnapshotAccessor` with `IPublishedContentTypeCache`.
3458

3559
<summary>Umbraco 14</summary>
3660

0 commit comments

Comments
 (0)