Skip to content

Latest commit

 

History

History
183 lines (120 loc) · 5.45 KB

Migration.md

File metadata and controls

183 lines (120 loc) · 5.45 KB
Raw

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 Msgs 8.X to 9.X

  1. SuppressWarnings.hh is deprecated and isn't part of msgs.hh anymore. Use gz-utils instead.
  2. Header files under ignition/... are deprecated and will be removed in future versions. Use gz/... instead.
  3. Protobuf messages and packages will no longer use ignition.msgs, use gz.msgs instead
  4. INSTALL_IGN_MSGS_GEN_EXECUTABLE and IGN_MSGS_GEN_EXECUTABLE are deprecated and will be removed. Use INSTALL_GZ_MSGS_GEN_EXECUTABLE and GZ_MSGS_GEN_EXECUTABLE instead.
  5. IGN_DESCRIPTOR_PATH is deprecated and will be removed. Use GZ_DESCRIPTOR_PATH instead.
  6. camerasensor.proto has deprected the string image_format = 4. Please use PixelFormatType pixel_format = 21;

Breaking Changes

  1. 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

Gazebo Msgs 8.1 to 8.2

Modifications

  1. gps.proto

    • Recommend the use of navsat.proto instead. The GPS message will be deprecated in the future.

  2. gps_sensor.proto

    • Recommend the use of navsat_sensor.proto instead. The GPS message will be deprecated in the future.

Gazebo Msgs 6.X to 7.X

Removals

  1. bool use_parent_model_frame from axis.proto.

  2. double force from joint_cmd.proto.

  3. double target, double p_gain, double i_gain, double d_gain, double i_max, double i_min, double limit from pid.proto.

Gazebo Msgs 6.3 to 6.4

Modifications

  1. particle_emitter.proto
    • Fields have changed from plain data types to messages.

Gazebo Msgs 4.X to 5.X

Modifications

Deprecations

  1. axis.proto
    • The use_parent_model_frame field is deprecated, use xyz_expressed_in instead. Setting xyz_expressed_in = "__model__" is equivalent touse_parent_model_frame = true and leaving xyz_expressed_in empty is equivalent to use_parent_model_frame = false

Gazebo Msgs 3.X to 4.X

Modifications

  1. image.proto

    • Corrected BAYER_RGGR8 to BAYER_BGGR8 in PixelFormatType.

  2. joint.proto

    • The axis.proto message contains joint position, velocity, force, and acceleration information.

  3. serialized.proto

    • SerializedComponent's component field type changed from string to bytes.

  4. sensor.proto

    • Deprecating RaySensor, and replacing with LidarSensor.

Deprecations

  1. joint.proto

    • The angle field is deprecated, use position in the axis.proto message instead.
    • The velocity field is deprecated, use velocity in the axis.proto message instead.

  2. image.proto

    • pixel_format field is deprecated, use pixel_format_type with enum PixelFormatType instead.

Removals

  1. include/gz/msgs/gz.hh is no longer installed.

Gazebo Msgs 2.X to 3.X

Additions

  1. axis_aligned_box.proto

    • New message for axis-aligned bounding boxes.

  2. entity.proto

    • New message to uniquely identify an entity.

  3. entity_factory.proto

    • Add Model field to allow model insertion.

  4. light.proto

    • Add id, parent_id fields.

  5. link.proto

    • Add repeated light field.

  6. twist.proto

    • New message for storing linear and angular velocity.

  7. Utility.hh

    • Conversion functions for axis_aligned_box.proto.

Modifications

  1. Use ignition-cmake2 and ignition-math6.

  2. Use protobuf3 for all messages.

  3. contacts.proto

    • Use Entity instead of string to specify entities in contact.

  4. entity_factory.proto

    • Rename clone_model_name field to clone_name.
    • Remove edit_name field.
    • Use oneof to indicate only one method can be used at a time.

Deprecations

Removals

Gazebo Msgs 2.0 to 2.1

Modifications

  1. Use gz-math6 instead of gz-math5. This implies an indirect dependency on gz-cmake2 and cmake 3.10.2, which are not available on Ubuntu Xenial, so migration to Ubuntu Bionic may be required.

Gazebo Msgs 1.X to 2.0

Additions

  1. log_control.proto

    • Add record_resources bool to match osrf/gazebo PR 3008.

  2. log_status.proto

    • Add record_resources bool to match osrf/gazebo PR 3008.

  3. sonar.proto

    • Add geometry field.

  4. world_statistics.proto

    • Add real_time_factor field.

Modifications

  1. Use ignition-cmake1 and ignition-math5.

  2. Use inline versioned namespace.

Deprecations

Removals

  1. Generator.hh
    • This file is no longer installed. It served only to make an internal protc plugin that customized the protobuf compiler output.