Qt for HarmonyOS/Local Emulator Configuration

Scenario

Initialize the "Phone" device type "Pura 90" in a local directory (e.g. /Volumes/MacintoshExtSSD/DevEcoEmulator), and start it using command-line tools.

Prerequisites

• DevEco Studio installed
• Sufficient disk space at the target emulator location

Initialize the Emulator

1. Open DevEco Studio.
2. Open Device Manager.
3. Edit Local Emulator Location to set the emulator storage path (e.g. /Volumes/MacintoshExtSSD/DevEcoEmulator).
4. Find the device: Phone → Pura 90.

   Note: You may select any supported emulator available in DevEco Studio. "Pura 90" is used here as an example.

5. Click the Download button in the Actions column, then wait for the emulator to download and initialize.

Run the Emulator via Command Line

Test Method

1. Close DevEco Studio completely.
2. Disable the network connection on your machine.
3. Run the following command in a terminal:

/Applications/DevEco-Studio.app/Contents/tools/emulator/Emulator \
  -start "Pura 90" \
  -instancePath /Volumes/MacintoshExtSSD/DevEcoEmulator/

Closing DevEco Studio and disabling the network ensures the emulator launches independently from the IDE and confirms it can run fully offline using only the locally downloaded resources.

Notes

• Replace the -instancePath value with your own emulator storage path.
• The emulator name passed to -start must match the device name configured in Device Manager.
• Any supported emulator from DevEco Studio's device list can be used — replace "Pura 90" with the desired device name.

See also

• Qt for HarmonyOS