Zero Install .NET API 2.20.0
ZeroInstall.DesktopIntegration.Windows.StubBuilder Class Reference

Builds stub EXEs that execute "0install" commands. More...

Public Member Functions

IReadOnlyList< string > GetRunCommandLine (FeedTarget target, string? command=null, bool machineWide=false)
 Returns a command-line for executing the "0install run" command. Generates and returns a stub EXE if possible, falls back to directly pointing to the "0install" binary otherwise. More...
 
void BuildRunStub (string path, FeedTarget target, string? command=null, bool gui=false)
 Builds a stub EXE that executes the "0install run" command at a specific path. More...
 

Detailed Description

Builds stub EXEs that execute "0install" commands.

Member Function Documentation

◆ BuildRunStub()

void ZeroInstall.DesktopIntegration.Windows.StubBuilder.BuildRunStub ( string  path,
FeedTarget  target,
string?  command = null,
bool  gui = false 
)
inline

Builds a stub EXE that executes the "0install run" command at a specific path.

Parameters
pathThe path to store the generated EXE file.
targetThe application to be launched.
commandThe command argument to be passed to the the "0install run" command; can be null.
guitrue to build a GUI stub, false to build a CLI stub.
Exceptions
OperationCanceledExceptionThe user canceled the task.
InvalidOperationExceptionThere was a compilation error while generating the stub EXE.
IOExceptionA problem occurred while writing to the filesystem.
WebExceptionA problem occurred while downloading additional data (such as icons).
UnauthorizedAccessExceptionWrite access to the filesystem is not permitted.

◆ GetRunCommandLine()

IReadOnlyList< string > ZeroInstall.DesktopIntegration.Windows.StubBuilder.GetRunCommandLine ( FeedTarget  target,
string?  command = null,
bool  machineWide = false 
)
inline

Returns a command-line for executing the "0install run" command. Generates and returns a stub EXE if possible, falls back to directly pointing to the "0install" binary otherwise.

Parameters
targetThe application to be launched.
commandThe command argument to be passed to the the "0install run" command; can be null.
machineWidetrue place the generated stub in a machine-wide location; false to place it in the current user profile.
Returns
Exceptions
OperationCanceledExceptionThe user canceled the task.
InvalidOperationExceptionThere was a compilation error while generating the stub EXE.
IOExceptionA problem occurred while writing to the filesystem.
WebExceptionA problem occurred while downloading additional data (such as icons).
UnauthorizedAccessExceptionWrite access to the filesystem is not permitted.

The documentation for this class was generated from the following file: