Skip to content

Commit a99f90e

Browse files
authored
Merge pull request #13 from RobotecAI/docs/unity_hub_restart
Mention UnityHub background process restart
2 parents 6899a7f + b7892e5 commit a99f90e

File tree

1 file changed

+5
-4
lines changed

1 file changed

+5
-4
lines changed

README-UBUNTU.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,13 +20,14 @@ Start with installation of dependencies. Make sure to complete each step of `ros
2020
* It prepares Unity Asset that is ready to import into your Unity project.
2121
* Run `create_unity_asset.sh -u <your-path-to-unity-editor-executable>` to generate .unitypackage file in `install/unity_package`
2222

23-
#### Troubleshooting
24-
25-
If you see `"No ROS environment sourced. You need to source your ROS2 (..)"` message in Unity3D Editor, it means your environment was not sourced properly. This could happen if you run Unity but it redirects to Hub and ignores your console environment variables (this behavior can depend on Unity3D version). In such case, run project directly with `-projectPath` or add ros2 sourcing to your `~/.profile` file (you need to re-log for it to take effect).
26-
2723
## OS-Specific usage remarks
2824

2925
You can run Unity Editor or App executable from GUI (clicking) or from terminal as long as ROS2 is sourced in your environment.
3026
The best way to ensure that system-wide is to add `source /opt/ros/foxy/setup.bash` to your `~/.profile` file.
3127
Note that you need to re-log for changes in `~/.profile` to take place.
3228
Running Unity Editor through Unity Hub is also supported.
29+
30+
## Usage troubleshooting
31+
32+
* If you see `"No ROS environment sourced. You need to source your ROS2 (..)"` message in Unity3D Editor, it means your environment was not sourced properly. This could happen if you run Unity but it redirects to Hub and ignores your console environment variables (this behavior can depend on Unity3D version). In such case, run project directly with `-projectPath` or add ros2 sourcing to your `~/.profile` file (you need to re-log for it to take effect).
33+
* Keep in mind that UnityHub works the whole time in the background after it's first launch. This means that environment variables are inherited and cached when process is launched for the first time. To change between Unity Assets compiled with different ros2 distributions, please kill existent UnityHub process and run it with the correct ros2 distribution sourced.

0 commit comments

Comments
 (0)