API referenca za WvdS VSCode Core Extension.

Core Extension zagotavlja centralne storitve, ki jih lahko uporabljajo vse druge razširitve.

uses
  WvdS.Core.Services,
  WvdS.Core.Toolchain,
  WvdS.Core.Logging;

procedure LogInfo(const AMessage: string);
procedure LogInfo(const AFormat: string; const AArgs: array of const);

Zapiše informacijsko sporočilo v Output Channel.

procedure LogWarn(const AMessage: string);
procedure LogWarn(const AFormat: string; const AArgs: array of const);

Zapiše opozorilo v Output Channel.

procedure LogError(const AMessage: string);
procedure LogError(const AFormat: string; const AArgs: array of const);

Zapiše napako v Output Channel.

{$IFDEF DEBUG}
procedure LogDebug(const AMessage: string);
procedure LogDebug(const AFormat: string; const AArgs: array of const);
{$ENDIF}

Zapiše razhroščevalno sporočilo. Na voljo samo pri kompilaciji z -dDEBUG.

function GetToolPath(ATool: TWvdSToolType): string;

Vrne konfigurirano pot do orodja.

Primer:

var
  FpcPath: string;
begin
  FpcPath := GetToolPath(ttFPC);
  if FpcPath = '' then
    raise EWvdSToolNotFound.Create(rsToolNotFound);
end;

function GetToolVersion(ATool: TWvdSToolType): string;

Vrne verzijo nameščenega orodja.

function IsToolAvailable(ATool: TWvdSToolType): Boolean;

Preveri, ali je orodje na voljo.

procedure AutoDetectTools;

Izvede samodejno zaznavanje vseh orodij.

function GetConfiguration(const ASection: string): TJSObject;

Prebere VS Code konfiguracijo.

Primer:

var
  Config: TJSObject;
  LogLevel: string;
begin
  Config := GetConfiguration('wvds.core');
  LogLevel := String(Config['logLevel']);
end;

procedure UpdateConfiguration(
  const ASection: string;
  const AKey: string;
  AValue: JSValue;
  ATarget: TConfigurationTarget
);

Zapiše VS Code konfiguracijo.

procedure PublishEvent(const AEventName: string; AData: TJSObject);

Objavi dogodek za druge razširitve.

Primer:

var
  Data: TJSObject;
begin
  Data := TJSObject.New;
  Data['projectPath'] := ProjectPath;
  Data['success'] := True;
  PublishEvent('wvds.build.completed', Data);
end;

procedure SubscribeEvent(
  const AEventName: string;
  AHandler: TWvdSEventHandler
);

Naroči se na dogodke.

Primer:

procedure HandleBuildCompleted(AData: TJSObject);
begin
  if Boolean(AData['success']) then
    LogInfo('Build succeeded!')
  else
    LogError('Build failed!');
end;
 
// Ob aktivaciji:
SubscribeEvent('wvds.build.completed', @HandleBuildCompleted);

procedure ShowInfoMessage(const AMessage: string);
function ShowInfoMessage(
  const AMessage: string;
  const AItems: array of string
): TJSPromise;  // Razreši v izbrani element

procedure ShowWarningMessage(const AMessage: string);

procedure ShowErrorMessage(const AMessage: string);

function ShowQuickPick(
  const AItems: array of string;
  const APlaceholder: string
): TJSPromise;

function GetWorkspaceRoot: string;

Vrne pot do mape delovnega prostora.

function GetOpenDocument: string;

Vrne pot do trenutno odprtega dokumenta.

• Meta API
• VSCode Wrapper
• Razvoj razširitev