idevice
Developer Tools

DVT Location Simulation

Set or clear simulated location through DVT.

DVT Location Simulation is a DVT client built on RemoteServerClient. It opens the com.apple.instruments.server.services.LocationSimulation channel.

Use It For

  • Connect through the DVT remote server.
  • Call the service-specific DTX methods.
  • Use the matching idevice-tools command when one exists.

Feature Flag

Cargo.toml
[dependencies]
idevice = { version = "0.1.64", features = ["usbmuxd", "location_simulation"] }

Service Names

PathValue
DVT Lockdowncom.apple.instruments.remoteserver
DVT Lockdown fallbackcom.apple.instruments.remoteserver.DVTSecureSocketProxy
DVT RSDcom.apple.instruments.dtservicehub
DVT channelcom.apple.instruments.server.services.LocationSimulation

Rust Example

src/main.rs
use idevice::dvt::{
    RemoteServerClient,
    location_simulation::LocationSimulationClient,
};

let mut remote = RemoteServerClient::connect(&provider).await?;
let mut client = LocationSimulationClient::new(&mut remote).await?;
client.set(37.3349, -122.0090).await?;
client.clear().await?;

CLI Equivalent

Terminal
idevice-tools location_simulation set 37.3349 -122.0090
idevice-tools location_simulation clear

Common Errors

ErrorWhat to check
Channel creation failedThe DVT remote server did not accept the channel identifier.
Protocol decode errorCheck that the client and device service are using the expected DTX payload shape.
Developer service unavailableStart from the iOS 17+ tunnel path or a device state that exposes developer services.

Source

DVT Screenshot

Take screenshots through the DVT screenshot channel.

XCTest

Run XCTest and XCUITest sessions through DVT.

On this page

Use It ForFeature FlagService NamesRust ExampleCLI EquivalentCommon ErrorsSource