Modernize CMakeLists.txt to remove deprecated ament_target_dependencies (Fixes #2210)

[LalitNarayanYadav]

Modernize CMakeLists to remove ament_target_dependencies() deprecation warnings

This PR updates the CMakeLists.txt file to replace deprecated ament_target_dependencies() calls with modern target_link_libraries() using namespaced targets, as recommended by ROS 2 on Rolling.

✅ Changes

• Replaced all ament_target_dependencies() usages with target_link_libraries() and appropriate namespaced targets.
• Ensured compatibility with ROS 2 Rolling while preserving functionality.

📦 Benefits

• Eliminates CMake deprecation warnings
• Aligns with modern CMake best practices
• Future-proofs the build system

---

Closes #2207

[saikishor]

@LalitNarayanYadav Thank you for your comments. Just some minor comments, if they look good, you can commit them directly from UI

[LalitNarayanYadav]

Please review the changes.

[saikishor]

@LalitNarayanYadav Please fix the failing CI jobs. Please try to install pre-commit and fix by running the pre-commit run --all--files and also build it locally and then push it please

[bmagyar]

It would also be good to give the PR a meaningful title.

@LalitNarayanYadav hope you don't mind me asking but how much of the original content of this PR was AI generated?

[bmagyar]

☝️ @LalitNarayanYadav did this build for you locally?

[bmagyar]

I'm really not happy with the deprecation of the macro...

This PR now doubles the amount of lines it touches (+127 -62) and in it's current form does not help readability or compilation time.

There is inconsistent use of ${X_targets}, {X_targets} and X::X of which allow me to say the latter looks pretty bad :D

I guess the main reason for the lines of new "code" is not using THIS_PACKAGE_INCLUDE_DEPENDS anymore. If only there was a cmake macro that allowed that...

Any suggestions?

[mergify]

This pull request is in conflict. Could you fix it @LalitNarayanYadav?