sfdk-emulator-set
Set Salesforce Function SDK emulator environment variables
TLDR
Set a property
Show emulator properties
SYNOPSIS
sfdk-emulator-set [options] <emulator_name_or_id>
PARAMETERS
<emulator_name_or_id>
The unique name or identifier of the Sailfish OS emulator instance to be set as the active or default one for subsequent SDK operations. This name typically corresponds to an emulator previously created using sfdk emulator create.
-h, --help
Displays a help message and exits, showing usage information for the command.
-v, --verbose
Enables verbose output, providing more detailed information about the operation's progress and actions.
-q, --quiet
Suppresses non-essential output, showing only errors or critical information, useful for scripting.
DESCRIPTION
sfdk-emulator-set is an assumed utility within the Sailfish OS Software Development Kit (SDK), primarily used for managing or configuring the active emulator environment. While not a top-level sfdk command directly documented in standard CLI references as sfdk-emulator-set, its name suggests a function similar to sfdk emulator set-default or a script for initializing a specific emulator setup. It allows developers to specify which Sailfish OS emulator instance or configuration should be used by default for subsequent SDK operations like building and deploying applications. This command is crucial in multi-emulator environments, enabling seamless switching between different Sailfish OS versions or device types for testing purposes without manual configuration changes for each project or task. Its exact implementation details may vary depending on the SDK version or whether it acts as an internal helper script or a user-facing command.
CAVEATS
The sfdk-emulator-set command is not a standard, top-level command documented in the main Sailfish OS SDK CLI reference (like sfdk emulator set-default). Its exact parameters and behavior might vary significantly between SDK versions, or it might function as an internal helper script. Users should consult their specific SDK installation's documentation or use --help if available for precise usage.
USAGE CONTEXT
This command is typically executed within a Sailfish OS SDK development environment, often from the SDK's command-line interface or a terminal where the SDK's environment variables are sourced. It is primarily used by developers to prepare their build and deployment environment before compiling applications or deploying them to a specific emulator instance for testing. Its successful execution depends on having a properly installed Sailfish OS SDK and pre-configured emulator images.
HISTORY
The Sailfish OS SDK and its command-line tools, including components for emulator management, have evolved since the platform's inception. While the specific sfdk-emulator-set command may not have a long, publicly documented history as a standalone utility, the functionality it represents (setting a default or active emulator) has been a core part of SDK operations. Earlier versions of the SDK might have relied more on individual scripts for specific tasks, which later consolidated into comprehensive subcommands under the main sfdk emulator utility, such as sfdk emulator set-default. Its usage likely reflects a pattern of direct script invocation for specific configuration tasks within the SDK environment.