From c592479a71818244a5f0ae3debee1cfb24e9c4e5 Mon Sep 17 00:00:00 2001
From: Astariul <remondnicola@gmail.com>
Date: Fri, 5 Apr 2024 13:47:22 +0900
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20Add=20doc=20on=20how=20to=20run?=
 =?UTF-8?q?=20the=20iOS=20simulator=20from=20the=20command=20line?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/emu_setup.md | 52 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/docs/emu_setup.md b/docs/emu_setup.md
index fc01ce2..fa8060f 100644
--- a/docs/emu_setup.md
+++ b/docs/emu_setup.md
@@ -124,6 +124,58 @@ Now, make sure you can properly build the `WebDriverAgentRunner` target : select
 
 If all the stars are aligned, it should start the emulator !
 
+### Starting the emulator
+
+Once you have ensured the emulator runs properly, you should be able to start it from the command line (without Xcode open).
+
+First, check the list of emulators available :
+
+```bash
+xcrun simctl list
+```
+
+Example of emulators listed :
+
+```
+-- iOS 17.4 --
+    iPhone SE (3rd generation) (96ADAD77-ECE6-420E-B56C-505E0C16231B) (Shutdown)
+    iPhone 15 (128F95FC-F499-4B09-A3B2-55937BF52B0B) (Shutdown)
+    iPhone 15 Plus (86591FC6-B3E7-43A2-9E9B-D4A2A90DAF31) (Shutdown)
+    iPhone 15 Pro (9D38F87D-273B-4D8F-8AD5-E901C1974C1E) (Shutdown)
+    iPhone 15 Pro Max (15EF57B4-69E6-4369-9534-70692A2023E5) (Shutdown)
+    iPad Air (5th generation) (252D522B-CEAA-4085-BE17-A453BC219755) (Shutdown)
+    iPad (10th generation) (39F2ADD2-2FCF-44C3-9DC9-4CC4D50875E9) (Shutdown)
+    iPad mini (6th generation) (59125B84-4ED1-40C1-8457-3CE824394385) (Shutdown)
+    iPad Pro (11-inch) (4th generation) (DB122D71-F358-48DA-B11C-D25305657E7F) (Shutdown)
+    iPad Pro (12.9-inch) (6th generation) (1100927A-B631-4678-AB19-02EA4F680537) (Shutdown)
+```
+
+Then you can start the device you want with :
+
+```bash
+xcrun simctl boot <UUID>
+```
+
+For example, to start `iPhone 15 Pro`, you should run :
+
+```bash
+xcrun simctl boot 9D38F87D-273B-4D8F-8AD5-E901C1974C1E
+```
+
+!!! warning
+    The `xcrun simctl boot` command only launch the simulator background service, to launch the foreground GUI, run :
+
+    ```bash
+    open -a Simulator
+    ```
+
+!!! note
+    To shutdown the simulator, run :
+
+    ```bash
+    xcrun simctl shutdown <UUID>
+    ```
+
 ### Preparing iOS Keyboard
 
 iOS Keyboard is the default keyboard on iOS, so there is nothing to do to enable it.