Skip to content

Commit 6f31020

Browse files
GulamYMarkvanMents
andauthored
Clarify required versions of .NET runtime (#11457)
* Update ferefrences to outdated .NET runtime * Explain .NET versions more accurately. * Make note about auto-installed .NET versions more accurate. --------- Co-authored-by: MarkvanMents <mark.van.ments@mendix.com>
1 parent 4e6b0af commit 6f31020

3 files changed

Lines changed: 25 additions & 20 deletions

File tree

content/en/docs/refguide/installation/install.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,9 @@ The prerequisites are the following:
5050

5151
| Studio Pro 11.0.0 - 11.6.2 | Studio Pro 11.6.3 and above |
5252
| --- | --- |
53-
| [.NET Desktop Runtime 8.0.x (x64 or ARM64)](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) <br/> Mendix recommends using version 8.0.10 or above | [.NET Desktop Runtime 10.0.x (x64 or ARM64)](https://dotnet.microsoft.com/en-us/download/dotnet/10.0) <br/> Mendix recommends using version 10.0.3 or above |
53+
| [.NET Desktop Runtime 8.0.x (x64 or ARM64)](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) <br/> Mendix recommends using version 8.0.10 or above | [.NET Desktop Runtime 10.0.x (x64 or ARM64)](https://dotnet.microsoft.com/en-us/download/dotnet/10.0) <br/>Mendix recommends using the latest version to ensure you are up to date with security patches. |
54+
55+
{{% alert color="info" %}}If .NET Desktop Runtime is not installed on your machine, Mendix will install a version which was current at the time this version of Studio Pro was released.{{% /alert %}}
5456

5557
* [Eclipse Temurin JDK 21 (x64 or ARM64)](https://adoptium.net/temurin/releases/?version=21)
5658

@@ -82,12 +84,12 @@ It is possible to prepare the prerequisite installers beforehand so the setup pr
8284
4. Download the prerequisites listed in the **[Troubleshooting](#troubleshooting)** section above and move them into the **Dependencies** folder.
8385
5. Rename the following dependencies:
8486
1. Microsoft .NET Desktop Runtime
85-
* For Studio Pro versions 11.0.0 through 11.6.2, rename the Microsoft .NET Desktop Runtime 8.0.x
87+
* For Studio Pro versions 11.0.0 through 11.6.2, rename the Microsoft .NET Desktop Runtime 8.0.x to remove the patch version. For example, if you have downloaded .NET Desktop Runtime 8.0.10:
8688
* On x64, rename *windowsdesktop-runtime-8.0.10-win-x64.exe* to *windowsdesktop-runtime-8.0-x64.exe*
8789
* On ARM64, rename *windowsdesktop-runtime-8.0.10-win-arm64.exe* to *windowsdesktop-runtime-8.0-arm64.exe*
88-
* For Studio Pro versions 11.6.3 and above, rename the Microsoft .NET Desktop Runtime 10.0.x
89-
* On x64, rename *windowsdesktop-runtime-10.0.3-win-x64.exe* to *windowsdesktop-runtime-10.0-x64.exe*
90-
* On ARM64, rename *windowsdesktop-runtime-10.0.3-win-arm64.exe* to *windowsdesktop-runtime-10.0-arm64.exe*
90+
* For Studio Pro versions 11.6.3 and above, rename the Microsoft .NET Desktop Runtime 10.0.x to remove the patch version. For example, if you have downloaded .NET Desktop Runtime 10.0.7:
91+
* On x64, rename *windowsdesktop-runtime-10.0.7-win-x64.exe* to *windowsdesktop-runtime-10.0-x64.exe*
92+
* On ARM64, rename *windowsdesktop-runtime-10.0.7-win-arm64.exe* to *windowsdesktop-runtime-10.0-arm64.exe*
9193
2. Eclipse Temurin JDK
9294
* Rename the Java Development Kit 21 *msi*
9395
* On x64, rename *OpenJDK21U-jdk_x64_windows_hotspot_21.0.5_11.msi* to *adoptiumjdk_21_x64.msi*

content/en/docs/refguide10/installation/install.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,9 @@ The prerequisites are the following:
5252

5353
| Studio Pro 10.0.0 - 10.10.0 | Studio Pro 10.11.0 - 10.24.15 | Studio Pro 10.24.16 and above |
5454
| --- | --- | --- |
55-
| [.NET Desktop Runtime 6.0.x (x64 or ARM64)](https://dotnet.microsoft.com/en-us/download/dotnet/6.0) <br/> Mendix recommends using version 6.0.35 or above | [.NET Desktop Runtime 8.0.x (x64 or ARM64)](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) <br/> Mendix recommends using version 8.0.10 or above | [.NET Desktop Runtime 10.0.x (x64 or ARM64)](https://dotnet.microsoft.com/en-us/download/dotnet/10.0) <br/> Mendix recommends using version 10.0.3 or above |
55+
| [.NET Desktop Runtime 6.0.x (x64 or ARM64)](https://dotnet.microsoft.com/en-us/download/dotnet/6.0) <br/> Mendix recommends using version 6.0.35 or above. | [.NET Desktop Runtime 8.0.x (x64 or ARM64)](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) <br/> Mendix recommends using version 8.0.10 or above. | [.NET Desktop Runtime 10.0.x (x64 or ARM64)](https://dotnet.microsoft.com/en-us/download/dotnet/10.0) <br/> Mendix recommends using the latest version to ensure you are up to date with security patches. |
56+
57+
{{% alert color="info" %}}If .NET Desktop Runtime is not installed on your machine, Mendix will install a version which was current at the time this version of Studio Pro was released.{{% /alert %}}
5658

5759
* Eclipse Temurin JDK (x64) (see [JDK Installation](/refguide10/jdk-installation/) if you want to install another version of the JDK). Mendix version 10.8.0 and 10.0.9 supports JDK 11 and 17. Mendix version 10.10.0 supports JDK 11, 17, and 21, but installer still installs JDK 11.
5860

@@ -100,15 +102,15 @@ It is possible to prepare the prerequisite installers beforehand so the setup pr
100102
4. Download the prerequisites listed in the **[Troubleshooting](/refguide9/install/#troubleshooting)** section above and move them into the **Dependencies** folder.
101103
5. Rename the following dependencies:
102104
1. Microsoft .NET Desktop Runtime
103-
* For Studio Pro versions 10.0.0 - 10.10.0, rename the Microsoft .NET Desktop Runtime 6.0.x
105+
* For Studio Pro versions 10.0.0 - 10.10.0, rename the Microsoft .NET Desktop Runtime 6.0.x to remove the patch version. For example, if you have downloaded .NET Desktop Runtime 6.0.35:
104106
* On x64, rename *windowsdesktop-runtime-6.0.35-win-x64.exe* to *windowsdesktop-runtime-6.0-x64.exe*
105107
* On ARM64, rename *windowsdesktop-runtime-6.0.35-win-arm64.exe* to *windowsdesktop-runtime-6.0-arm64.exe*
106-
* For Studio Pro versions 10.11.0 - 10.24.15, rename the Microsoft .NET Desktop Runtime 8.0.x
108+
* For Studio Pro versions 10.11.0 - 10.24.15, rename the Microsoft .NET Desktop Runtime 8.0.x to remove the patch version. For example, if you have downloaded .NET Desktop Runtime 8.0.10:
107109
* On x64, rename *windowsdesktop-runtime-8.0.10-win-x64.exe* to *windowsdesktop-runtime-8.0-x64.exe*
108110
* On ARM64, rename *windowsdesktop-runtime-8.0.10-win-arm64.exe* to *windowsdesktop-runtime-8.0-arm64.exe*
109-
* For Studio Pro versions 10.24.16 and above, rename the Microsoft .NET Desktop Runtime 10.0.x
110-
* On x64, rename *windowsdesktop-runtime-10.0.3-win-x64.exe* to *windowsdesktop-runtime-10.0-x64.exe*
111-
* On ARM64, rename *windowsdesktop-runtime-10.0.3-win-arm64.exe* to *windowsdesktop-runtime-10.0-arm64.exe*
111+
* For Studio Pro versions 10.24.16 and above, rename the Microsoft .NET Desktop Runtime 10.0.x to remove the patch version. For example, if you have downloaded .NET Desktop Runtime 10.0.7:
112+
* On x64, rename *windowsdesktop-runtime-10.0.7-win-x64.exe* to *windowsdesktop-runtime-10.0-x64.exe*
113+
* On ARM64, rename *windowsdesktop-runtime-10.0.7-win-arm64.exe* to *windowsdesktop-runtime-10.0-arm64.exe*
112114
2. Eclipse Temurin JDK (x64)
113115
* For Studio Pro versions 10.0.0 - 10.10.0, rename the Java Development Kit 11 (x64) *msi*
114116
* For example, *OpenJDK11U-jdk_x64_windows_hotspot_11.0.20.1_1.msi* to *adoptiumjdk_11_x64.msi*

content/en/docs/refguide9/general/install.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,9 @@ The prerequisites are the following:
6565

6666
| Studio Pro 9.0.0 - 9.24.33 | Studio Pro 9.24.34 - 9.24.41 | Studio Pro 9.24.42 and above |
6767
| --- | --- | --- |
68-
| [Microsoft .NET Desktop Runtime 6.0.x](https://dotnet.microsoft.com/en-us/download/dotnet/6.0) – Mendix recommends using version 6.0.6 or above | [Microsoft .NET Desktop Runtime 8.0.x](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) – Mendix recommends using version 8.0.14 or above | [.NET Desktop Runtime 10.0.x (x64 or ARM64)](https://dotnet.microsoft.com/en-us/download/dotnet/10.0) <br/> Mendix recommends using version 10.0.3 or above |
68+
| [Microsoft .NET Desktop Runtime 6.0.x](https://dotnet.microsoft.com/en-us/download/dotnet/6.0) – Mendix recommends using version 6.0.6 or above. | [Microsoft .NET Desktop Runtime 8.0.x](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) – Mendix recommends using version 8.0.14 or above. | [.NET Desktop Runtime 10.0.x (x64 or ARM64)](https://dotnet.microsoft.com/en-us/download/dotnet/10.0) <br/>Mendix recommends using the latest version to ensure you are up to date with security patches. |
69+
70+
{{% alert color="info" %}}If .NET Desktop Runtime is not installed on your machine, Mendix will install a version which was current at the time this version of Studio Pro was released.{{% /alert %}}
6971

7072
* Java JDK
7173

@@ -103,14 +105,13 @@ It is possible to prepare the prerequisite installers beforehand, so that the Me
103105
3. Create a folder with the name **Dependencies** in the same location where the Mendix Studio Pro installer was placed.
104106
4. Download the prerequisites listed in the [Troubleshooting](#troubleshooting) section above and move them into the **Dependencies** folder.
105107
5. Rename the following dependencies:
106-
* Microsoft .NET Desktop Runtime
107-
* For Studio Pro versions 9.0.0 - 9.24.33, rename the Microsoft .NET Desktop Runtime 6.0.x
108-
* Rename the Microsoft .NET Desktop Runtime 6.0.x executable (*dotnet.exe*) to *windowsdesktop-runtime-6.0-x64.exe*
109-
* For Studio Pro versions 9.24.34 - 9.24.41, rename the Microsoft .NET Desktop Runtime 8.0.x
110-
* Rename *windowsdesktop-runtime-8.0.14-win-x64.exe* to *windowsdesktop-runtime-8.0-x64.exe*
111-
* For Studio Pro versions 9.24.42 and above, rename the Microsoft .NET Desktop Runtime 10.0.x
112-
* Rename *windowsdesktop-runtime-10.0.3-win-x64.exe* to *windowsdesktop-runtime-10.0-x64.exe*
113-
* The Microsoft .NET Desktop Runtime 6.0.x executable (*dotnet.exe*) to *windowsdesktop-runtime-6.0-x64.exe*
108+
* Microsoft .NET Desktop Runtime
109+
* For Studio Pro versions 9.0.0 - 9.24.33, rename the Microsoft .NET Desktop Runtime 6.0.x to remove the patch version. For example, if you have downloaded .NET Desktop Runtime 6.0.6:
110+
* Rename the Microsoft .NET Desktop Runtime 6.0.6 executable (*dotnet.exe*) to *windowsdesktop-runtime-6.0-x64.exe*
111+
* For Studio Pro versions 9.24.34 - 9.24.41, rename the Microsoft .NET Desktop Runtime 8.0.x to remove the patch version. For example, if you have downloaded .NET Desktop Runtime 8.0.14:
112+
* Rename *windowsdesktop-runtime-8.0.14-win-x64.exe* to *windowsdesktop-runtime-8.0-x64.exe*
113+
* For Studio Pro versions 9.24.42 and above, rename the Microsoft .NET Desktop Runtime 10.0.x to remove the patch version. For example, if you have downloaded .NET Desktop Runtime 10.0.7:
114+
* Rename *windowsdesktop-runtime-10.0.7-win-x64.exe* to *windowsdesktop-runtime-10.0-x64.exe*
114115
* The Java Development Kit 11, 17 or 21 (x64) *msi* (for example, *OpenJDK17U-jdk_x64_windows_hotspot_17.0.10_7.msi*) to one of the following, depending on the Studio Pro version:
115116
* *adoptiumjdk_21_x64.msi* – for versions 9.24.34 and above
116117
* *adoptiumjdk_17_x64.msi* – for versions 9.24.16 and above

0 commit comments

Comments
 (0)