Skip to content

Latest commit

 

History

History
36 lines (32 loc) · 1.89 KB

Migration.md

File metadata and controls

36 lines (32 loc) · 1.89 KB

Note on deprecations

A tick-tock release cycle allows easy migration to new software versions. Obsolete code is marked as deprecated for one major release. Deprecated code produces compile-time warnings. These warning serve as notification to users that their code should be upgraded. The next major release will remove the deprecated code.

Gazebo CMake 2.X to 3.X

  1. Breaking: Examples are now built using native cmake. Two targets will be generated for each set of examples: EXAMPLES_Build_TEST and EXAMPLES_Configure_TEST Examples are not built by default, but instead require BUILD_EXAMPLES:bool=True to be set. This is because examples require the package of interest to be installed via make install.

  2. Breaking: The project name has been changed to use the gz- prefix, you must use the gz prefix!

  • This also means that any generated code that use the project name (e.g. CMake variables, in-source macros) would have to be migrated.
  • Some non-exhaustive examples of this include:
    • GZ_<PROJECT>_<VISIBLE/HIDDEN>
    • CMake -config files
    • Paths that depend on the project name :
  1. Deprecated: include/ignition/utilities/SuppressWarning.hh Replacement: include/ignition/utils/SuppressWarning.hh (in the gz-utils package)
  2. Deprecated: include/ignition/utilities/ExtraTestMacros.hh Replacement: include/ignition/utils/ExtraTestMacros.hh (in the gz-utils package)
  3. Deprecated: CMake functions and macros starting with ign_ Replacement: CMake functions and macros starting with gz_
  4. Deprecated: ignition namespaces Replacement: gz namespaces
  5. Deprecated: Ign prefixed CMake files Replacement: Gz prefixed CMake files
  6. Deprecated: IGN/IGNITION prefixed CMake variables and options Replacement: GZ prefixed CMake variables and options