Table of Contents

Class ExtensionInfo

Namespace
RDCore.SDK.Extensibility
Assembly
RDCore.SDK.dll

The information contained in an extension manifest.

public record ExtensionInfo : IEquatable<ExtensionInfo>
Inheritance
ExtensionInfo
Implements
Inherited Members

Remarks

🧩 This is how RDCore recognizes an extension as such. This file should be marked as read-only at the OS level.

Properties

Capabilities

The advertised capabilities of the extension.

public required PlatformExtensionServerCapability[] Capabilities { get; init; }

Property Value

PlatformExtensionServerCapability[]

Description

A short description of the extension.

public required string Description { get; init; }

Property Value

string

DiagnosticPrefix

The three-letter prefix of the diagnostic codes the extension's publisher issues; null for none.

public string? DiagnosticPrefix { get; init; }

Property Value

string

FileHash

The file hash of the extension executable: its base64-encoded SHA-512 hash.

public required string FileHash { get; init; }

Property Value

string

Id

The stable identifier of the extension; its Title when the manifest declares none.

public string Id { get; init; }

Property Value

string

IsCoreExtension

Whether the extension is the one the platform bundles (CoreExtension), whose diagnostics are the platform's own.

[JsonIgnore]
public bool IsCoreExtension { get; init; }

Property Value

bool

Remarks

Not read from the extension's manifest: the platform says which extension it bundles, and the extension does not. Set when the extension is found (Discover()).

Name

The name of the extension executable (.exe).

public required string Name { get; init; }

Property Value

string

Publisher

The name of the publisher.

public required string Publisher { get; init; }

Property Value

string

PublisherWebUrl

The publisher's web URL.

public required string PublisherWebUrl { get; init; }

Property Value

string

SdkVersion

The version of RDCore.SDK the extension was built against, as its assembly references it; null when the manifest does not say.

public Version? SdkVersion { get; init; }

Property Value

Version

SettingDescriptions

The description of each setting of Settings, by its key, in each language of the platform, by its two-letter name (Languages).

public Dictionary<string, Dictionary<string, string>> SettingDescriptions { get; init; }

Property Value

Dictionary<string, Dictionary<string, string>>

Settings

The settings the extension is configured with (ExtensionSettingsAttribute), without their descriptions, which are in SettingDescriptions; none for an extension that has none.

public SettingDescriptor[] Settings { get; init; }

Property Value

SettingDescriptor[]

Title

The friendly name, or title, of the extension: the name of the folder its manifest is in (LocationMismatch).

public required string Title { get; init; }

Property Value

string

Version

The version of the extension.

public required Version Version { get; init; }

Property Value

Version

Methods

SettingsIn(CultureInfo)

The settings of the extension, described in a language: culture's, or the platform's first when it has no description in it.

public SettingsSchema SettingsIn(CultureInfo culture)

Parameters

culture CultureInfo

The language of the user interface.

Returns

SettingsSchema

WithSettingsOf(Assembly)

The manifest, with the settings the extension's assembly says it is configured with (ExtensionSettingsAttribute) and their descriptions in each language of the platform; a description the extension has none of in a language is the one its resources fall back on.

public ExtensionInfo WithSettingsOf(Assembly assembly)

Parameters

assembly Assembly

The extension's assembly.

Returns

ExtensionInfo

The manifest as it is, for an assembly that says nothing of its settings.