From b7892e53dbe781a5b914096ccdc538666d08a080 Mon Sep 17 00:00:00 2001 From: kielczykowski-rai Date: Mon, 30 Aug 2021 15:35:53 +0200 Subject: [PATCH] Mention UnityHub background process --- README-UBUNTU.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/README-UBUNTU.md b/README-UBUNTU.md index ae2e25b..5c6eaec 100644 --- a/README-UBUNTU.md +++ b/README-UBUNTU.md @@ -20,13 +20,14 @@ Start with installation of dependencies. Make sure to complete each step of `ros * It prepares Unity Asset that is ready to import into your Unity project. * Run `create_unity_asset.sh -u ` to generate .unitypackage file in `install/unity_package` -#### Troubleshooting - -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). - ## OS-Specific usage remarks You can run Unity Editor or App executable from GUI (clicking) or from terminal as long as ROS2 is sourced in your environment. The best way to ensure that system-wide is to add `source /opt/ros/foxy/setup.bash` to your `~/.profile` file. Note that you need to re-log for changes in `~/.profile` to take place. Running Unity Editor through Unity Hub is also supported. + +## Usage troubleshooting + +* 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). +* 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.