Warning: The GeneXus Platform SDK has been discontinued starting with GeneXus 18 Upgrade 14. The reference assemblies for compiling GeneXus extensions are now available as NuGet packages.
You can download the GeneXus SDK installer according to your GeneXus version from the Download Center.
Starting with GeneXus 18 Upgrade 14, the SDK installer is no longer provided. Reference assemblies are published as NuGet packages on the GeneXus Azure Artifacts feed, and project types are defined through MSBuild project SDKs.
Add the GeneXus package source to your project's nuget.config:
<configuration>
<packageSources>
<add key="genexus-build-sdk"
value="https://pkgs.dev.azure.com/genexuslabs/7c97b484-0d92-464f-b32a-b7e2ac040279/_packaging/genexus-build-sdk/nuget/v3/index.json" />
</packageSources>
</configuration>
Create or update your global.json to declare the version of each GeneXus MSBuild SDK your solution uses:
{
"msbuild-sdks": {
"GeneXus.Base.Sdk": "3.0.0-beta5",
"GeneXus.Build.Sdk": "3.0.0-beta5",
"GeneXus.Package.BL.Sdk": "3.0.0-beta5",
"GeneXus.Package.UI.Sdk": "3.0.0-beta5",
"GeneXus.Pattern.Sdk": "3.0.0-beta5"
}
}
You need to list the SDKs your solution uses, plus any lower dependent project SDK. The available project SDKs are:
| SDK |
Use for |
| GeneXus.Package.UI.Sdk |
UI packages (IDE extensions with visual components) |
| GeneXus.Package.BL.Sdk |
Business logic packages |
| GeneXus.Pattern.Sdk |
Pattern extensions |
| GeneXus.Build.Sdk |
Plain class library projects |
| GeneXus.Base.Sdk |
Base SDK, inherited by the others |
It is recommended to define shared MSBuild properties in a Directory.Build.props file at the root of your solution, so that all C# projects in the extension inherit the same values:
<Project>
<PropertyGroup>
<!-- Version of the GeneXus reference assemblies to compile against.
Defaults to 18.13.2 if not set. -->
<GeneXusPackageReferenceVersion>18.13.2</GeneXusPackageReferenceVersion>
<!-- Target frameworks for all projects in this solution.
Defaults to net471;net8.0 if not set. -->
<GeneXusSdkTargetFrameworks>net471;net8.0</GeneXusSdkTargetFrameworks>
</PropertyGroup>
</Project>
Reference the appropriate SDK in your project file:
<Project Sdk="GeneXus.Package.UI.Sdk">
<PropertyGroup>
<!-- your package properties here -->
</PropertyGroup>
</Project>
Extensions for GeneXus Next follow a plugin model and use the same GeneXus NuGet feed and MSBuild SDK mechanism.
Add the same package source to your nuget.config:
<configuration>
<packageSources>
<add key="genexus-build-sdk"
value="https://pkgs.dev.azure.com/genexuslabs/7c97b484-0d92-464f-b32a-b7e2ac040279/_packaging/genexus-build-sdk/nuget/v3/index.json" />
</packageSources>
</configuration>
As with GeneXus 18 U14+, declare the SDK versions in global.json.
Use a Directory.Build.props file to share GeneXusPackageReferenceVersion and GeneXusSdkTargetFrameworks across all projects in the solution, as described above.
GeneXus Next plugins have separate backend and frontend components. The backend handles business logic and object definitions; the frontend contributes UI elements such as editors, commands, and dialogs.