gz-launch: Installation

[Voldivh]

Setup

• Os: MacOS
• BuildType: Source

Links

• Live
• Source

Checks

• Instructions work
• Images (if there are any) match the result

---

You can find the code used to generate this test case here

[srmainwaring]

Status

• Instructions work
• Images (if there are any) match the result

System

• MacBook Pro 2021, Apple M1 Max, 32 GB
• macOS Ventura 13.4
• Xcode 14.3.1

Suggested changes

Update branch names: ign => gz

- These instructions are for installing only Gazebo Launch. If you're interested in using all the Gazebo libraries, not only Igniton Launch, check out this [Gazebo installation](https://gazebosim.org/docs/latest/install).
+ These instructions are for installing only Gazebo Launch. If you're interested in using all the Gazebo libraries, not only Gazebo Launch, check out this [Gazebo installation](https://gazebosim.org/docs/latest/install).

- git clone https://github.com/gazebosim/gz-launch -b ign-launch<#>
+ git clone https://github.com/gazebosim/gz-launch -b gz-launch<#>

Add dependency on libwebsockets, it does not appear in the brew deps for gz-launch7 but is needed for building the web server component.

% brew deps gz-launch7                 
abseil
ampl-mp
aom
apache-arrow
aribb24
assimp
aws-sdk-cpp
boost
brotli
bullet
bzip2
c-ares
ca-certificates
cairo
cfitsio
cjson
cmake
console_bridge
cppzmq
dartsim
dav1d
doxygen
eigen
epsilon
expat
fcl
ffmpeg
flac
flann
fmt
fontconfig
freeimage
freetype
freexl
frei0r
fribidi
gcc
gdal
geos
gettext
gflags
giflib
glib
glog
gmp
gnutls
google-benchmark
graphite2
grpc
gts
harfbuzz
hdf5
highway
icu4c
imath
ipopt
isl
jasper
jpeg-turbo
jpeg-xl
json-c
jsoncpp
krb5
lame
leptonica
libaec
libarchive
libass
libb2
libbluray
libccd
libde265
libevent
libgeotiff
libheif
libidn2
libkml
liblerc
libmpc
libnghttp2
libogg
libpng
libpq
librist
librttopo
libsamplerate
libsndfile
libsodium
libsoxr
libspatialite
libtasn1
libtiff
libtool
libunibreak
libunistring
libvidstab
libvmaf
libvorbis
libvpx
libx11
libxau
libxcb
libxdmcp
libxext
libxml2
libxrender
libyaml
libzip
libzzip
little-cms2
lz4
lzo
m4
mbedtls
minizip
mpdecimal
mpfr
mpg123
netcdf
netpbm
nettle
nlopt
nspr
nss
numpy
octomap
ode
open-scene-graph
openblas
opencore-amr
openexr
openjpeg
openssl@3
opus
osrf/simulation/gz-cmake3
osrf/simulation/gz-common5
osrf/simulation/gz-fuel-tools9
osrf/simulation/gz-gui8
osrf/simulation/gz-math7
osrf/simulation/gz-msgs10
osrf/simulation/gz-physics7
osrf/simulation/gz-plugin2
osrf/simulation/gz-rendering8
osrf/simulation/gz-sensors8
osrf/simulation/gz-sim8
osrf/simulation/gz-tools2
osrf/simulation/gz-transport13
osrf/simulation/gz-utils2
osrf/simulation/ogre1.9
osrf/simulation/ogre2.3
osrf/simulation/sdformat14
ossp-uuid
p11-kit
pango
pcre2
pixman
pkg-config
poppler
popt
proj
protobuf
python@3.11
qhull
qt@5
rapidjson
rav1e
re2
readline
rubberband
ruby
sdl2
shared-mime-info
snappy
spdlog
speex
sqlite
srt
svt-av1
tbb
tesseract
theora
thrift
tinyxml
tinyxml2
unbound
unixodbc
urdfdom
urdfdom_headers
uriparser
utf8proc
webp
x264
x265
xerces-c
xorgproto
xvid
xz
zeromq
zimg
zstd

Details

Continuing from

• gz-sim: Installation #804 (comment)

gz-launch builds

% colcon build --merge-install --cmake-args -DCMAKE_BUILD_TYPE=RelWithDebInfo -DBUILD_TESTING=OFF -DCMAKE_MACOSX_RPATH=FALSE -DCMAKE_INSTALL_NAME_DIR=$(pwd)/install/lib --packages-select gz-launch7
Starting >>> gz-launch7
--- stderr: gz-launch7                                
CMake Warning at /Users/rhys/Code/osrf/gz_harmonic_ws/install/share/cmake/gz-cmake3/cmake3/GzConfigureBuild.cmake:68 (message):
   CONFIGURATION WARNINGS:
   -- Unable to find libwebsockets. The websocket_server plugin will not be built.
Call Stack (most recent call first):
  CMakeLists.txt:111 (gz_configure_build)


---
Finished <<< gz-launch7 [10.5s]

Summary: 1 package finished [11.1s]
  1 package had stderr output: gz-launch7

Install missing dependency

brew install libwebsockets

Rebuild - clean

% rm -rf ./build/gz-launch7
% colcon build --merge-install --cmake-args -DCMAKE_BUILD_TYPE=RelWithDebInfo -DBUILD_TESTING=OFF -DCMAKE_MACOSX_RPATH=FALSE -DCMAKE_INSTALL_NAME_DIR=$(pwd)/install/lib --packages-select gz-launch7
Starting >>> gz-launch7
Finished <<< gz-launch7 [0.78s]                     

Summary: 1 package finished [1.49s]

Also build using

cd ./src/gz-launch && mkdir build && cd build
cmake .. && make -j8

Test - clear

% make test
Running tests...
Test project /Users/rhys/Code/osrf/gz_harmonic_ws/src/gz-launch/build
    Start 1: UNIT_Manager_TEST
1/6 Test #1: UNIT_Manager_TEST ..................   Passed    0.51 sec
    Start 2: check_UNIT_Manager_TEST
2/6 Test #2: check_UNIT_Manager_TEST ............   Passed    0.03 sec
    Start 3: UNIT_gz_TEST
3/6 Test #3: UNIT_gz_TEST .......................   Passed    0.88 sec
    Start 4: check_UNIT_gz_TEST
4/6 Test #4: check_UNIT_gz_TEST .................   Passed    0.02 sec
    Start 5: INTEGRATION_faulty_plugins
5/6 Test #5: INTEGRATION_faulty_plugins .........   Passed    0.26 sec
    Start 6: check_INTEGRATION_faulty_plugins
6/6 Test #6: check_INTEGRATION_faulty_plugins ...   Passed    0.03 sec

100% tests passed, 0 tests failed out of 6

Total Test time (real) =   1.72 sec

[Voldivh]

Thanks @srmainwaring I'll be closing this issue since the PR with the suggested changes have been merged.