Merge released into master (#5696)

* Add a troubleshooting section for macOS installation with respect to Rosetta (#5691) * Update installation-procedure.md * Update installation-procedure.md * Add files via upload * Add necessary first line in proto file examples (#5692) * Add necessary first line in proto file examples * Update docs/guide/tutorial-7-your-first-proto.md Co-authored-by: Olivier Michel <[email protected]> * Update docs/guide/tutorial-7-your-first-proto.md Co-authored-by: Olivier Michel <[email protected]> * Update docs/guide/tutorial-7-your-first-proto.md Co-authored-by: Olivier Michel <[email protected]> Co-authored-by: Olivier Michel <[email protected]> Co-authored-by: Olivier Michel <[email protected]> Co-authored-by: Stephan Kunz <[email protected]>
cyberbotics · Dec 24, 2022 · 6f5751c · 6f5751c
1 parent 3f872d9
commit 6f5751c
Show file tree

Hide file tree

Showing 3 changed files with 21 additions and 0 deletions.
diff --git a/docs/guide/images/rosetta_setting.png b/docs/guide/images/rosetta_setting.png
diff --git a/docs/guide/installation-procedure.md b/docs/guide/installation-procedure.md
@@ -304,6 +304,24 @@ open ~/Applications/Webots.app    # to launch Webots using the open command
 
 Alternatively, you can double-click on the Webots icon to launch it.
 
+#### Troubleshooting for Apple Silicon Users
+
+If you are getting errors like these:
+```bash
+...(mach-o file, but is an incompatible architecture (have (arm64), need (x86_64)))
+```
+
+This is likely caused by Rosetta loading Webots under the x86 architecture instead of the native ARM. Unless you really want to use x86 binaries with your Webots simulation, make sure to turn off Rosetta. Sometimes macOS may try to open the app using Rosetta by default, which may cause issues when it comes to run robot controllers with dependencies on ARM libraries.
+
+To check if it's opened using Rosetta, right click on the Webots application in Finder and select Get Info. 
+
+Make sure that the "Open using Rosetta" setting is unchecked, like in the picture below: 
+
+%figure "Rosetta setting"
+
+![rosetta_setting.png](images/rosetta_setting.png)
+
+%end
 
 #### From the Homebrew Package
 

diff --git a/docs/guide/tutorial-7-your-first-proto.md b/docs/guide/tutorial-7-your-first-proto.md
@@ -12,6 +12,7 @@ Create a new empty text file in the `protos` folder of your project called `Four
 
 Any PROTO file should at least respect the following structure:
 ```
+#VRML_SIM {{ webots.version.major }} utf8
 PROTO protoName [
   protoFields
 ]
@@ -30,6 +31,7 @@ Finally, save the PROTO file.
   **Solution**: You should have something like this:
 
 ```
+  #VRML_SIM {{ webots.version.major }} utf8
   PROTO FourWheelsRobot [
 
   ]
@@ -80,6 +82,7 @@ And the `mass` field of the [Physics](../reference/physics.md) node of the [Robo
 ```
 Save your PROTO file, it should now look like this:
 ```
+#VRML_SIM {{ webots.version.major }} utf8
 PROTO FourWheelsRobot [
   field SFVec3f    translation  0 0 0
   field SFRotation rotation     0 0 1 0