Skip to content

Commit e115312

Browse files
committed
readme update
1 parent b499ada commit e115312

File tree

2 files changed

+12
-10
lines changed

2 files changed

+12
-10
lines changed

README-WINDOWS.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,12 @@ It is necessary to complete all the steps for `ros2cs` [Prerequisites](https://g
1919
* Source your ROS2 installation (`C:\dev\ros2_foxy\local_setup.ps1`) in the terminal before you proceed.
2020
* Run `pull_repositories.ps1`. This will pull `ros2cs` as well as your custom messages. You might be asked for github credentials.
2121
* Run `build.ps1` script.
22-
* Optionally, you can build tests by adding `--with-tests` argument to `build` command.
23-
* You can build with `--clean-install` to make sure your installation directory is cleaned before deploying.
22+
* Optionally, you can build tests by adding `-with_tests` argument to `build` command.
23+
* You can build with `-clean_install` to make sure your installation directory is cleaned before deploying.
2424
* This ivokes `colcon_build` with `--merge-install` argument to simplify libraries installation.
2525
* It deploys built plugins into the Asset directory. Note that only plugins built for the current platform will be deployed (there is no cross-compilation).
2626
* It prepares Unity Asset that is ready to import into your Unity project (`install/asset/` directory).
27-
* By default, build process generates standalone libraries on Windows.
28-
You can disable this feature by setting CMake option `STANDALONE_BUILD` to `OFF` (e.g. through editing `build.ps1`).
27+
* Currently Windows OS supports standalone build only.
2928
* In order to generate `Ros2ForUnity.unitypackage` please run `create_unity_package.ps1`. Please provide path to your Unity executable when prompted.
3029
* Asset can be found in `install\unity_package` directory
3130
* In case your Unity license has expired, the `create_unity_package.ps1` won't throw any errors but `Ros2ForUnity.unitypackage` won't be generated too.
@@ -69,9 +68,9 @@ pip install numpy
6968

7069
## OS-Specific usage remarks
7170

72-
> If the Asset is built with `STANDALONE_BUILD` option set to `1` (the default), then nothing extra needs to be done.
71+
> If the Asset is built with `-standalone` flag (the default), then nothing extra needs to be done.
7372
Otherwise, you have to source your ros distribution before launching either Unity3D Editor or Application.
7473

75-
> Note that after you build the Asset, you can use it on a machine that has no ros2 installation (if built with `STANDALONE_BUILD`).
74+
> Note that after you build the Asset, you can use it on a machine that has no ros2 installation (if built with `-standalone`).
7675
7776
> You can simply copy over the `Ros2ForUnity` subdirectory to update your Asset.

README.md

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,11 +20,14 @@ Supported ROS2 distributions:
2020
- Foxy
2121
- Galactic
2222

23-
Tested Unity3D version: 2021.1.7f1.
23+
Supported Unity3d:
24+
- 2020+
2425

25-
For Windows only, this asset can be prepared in two flavors:
26-
- standalone (no ROS2 installation required on target machine, e.g. your Unity3D simulation server). All required dependencies are installed and can be used e.g. as a complete set of Unity3D plugins.
27-
- overlay (assuming existing (supported) ROS2 installation on target machine). Only asset libraries and generated messages are installed.
26+
Older versions of Unity3d may work, but the editor executable most probably won't be detected properly by deployment script. This would require user confirmation for using unsupported version.
27+
28+
For Windows, this asset can be prepared in standalone mode only (no ROS2 installation required on target machine, e.g. your Unity3D simulation server). All required dependencies are installed and can be used e.g. as a complete set of Unity3D plugins.
29+
30+
For Ubuntu, this asset can be prepared in overlay mode only (assuming existing (supported) ROS2 installation on target machine). Only asset libraries and generated messages are installed.
2831

2932
## Releases
3033

0 commit comments

Comments
 (0)