Windows installation instructions per library

[chapulina]

Related to #96.

Lots of our libraries already build and run on Windows, but we don't have tutorials on how to do that yet.

Each library has their own install tutorial, and we should add this information there. Note that this is different from the top-level tutorials install tutorials that live in this repository (that's covered by #96).

These are the tutorials to be updated:

• ign-math
• ign-common - also move Linux install tutorial from README
• ign-gazebo - also move Linux install tutorial from README
• ign-fuel-tools - already has Windows instructions, must verify they're working
• ign-gui
• ign-launch - also move Linux install tutorial from README
• ign-msgs - also move Linux install tutorial from README
• ign-physics
• ign-plugin
• ign-rendering
• ign-sensors
• ign-transport - already has Windows instructions, must verify they're working
• sdformat

[JShep1]

For the record, we have internal docs up to ign-gazebo for building with vcpkg, but are now investigating conda-forge as it has ruby support and my initial impressions are that it is far easier and quicker to get to a point where you can begin compiling. Currently, there seems to be some issues with gts finding glib.h on Windows (#96 (comment)), but I believe it may be more worth sorting these issues out to move forward with conda-forge as the default Ignition Windows package manager (and possibly blazing a trail to eventually sync ROS2 so users can have the most streamlined build process).

It's safe to say this issue is blocked on the gts/glib issue for now, ignition-cmake and ignition-math (for both vcpkg and conda-forge) are complete and documented internally. But with regards to going forward with conda-forge, ign-common is where that issues arises. As stated here, I'm going to try to find a quick local workaround to unblock forward progress with this documentation then work on the more long term solution.

[traversaro]

As stated here, I'm going to try to find a quick local workaround to unblock forward progress with this documentation then work on the more long term solution.

I do not know if I a missing something, but I think that opening a PR again the ignition-cmake repo containing the patch in https://github.com/conda-forge/libignition-cmake0-feedstock/blob/master/recipe/FindGTS.cmake.patch is a perfectly fine solution, and in general a correct bug fix for any system in which pkg-config is not available. The fact that gts is currently lacking .pc files on conda-forge is another issue that may deserved to be fixed (as mentioned in #96 (comment)), but it can be done even after https://github.com/conda-forge/libignition-cmake0-feedstock/blob/master/recipe/FindGTS.cmake.patch as been applied upstream in ignition-cmake .

[mabelzhang]

Regarding the list of tutorials, ign-cmake doesn't have such a page (because it's unreleased?), but ign-math depends on ign-cmake, right? Should we put the ign-cmake Windows instructions in https://github.com/ignitionrobotics/ign-cmake/blob/ign-cmake2/README.md ? Then ign-math's doesn't need to talk about ign-cmake.

[chapulina]

Regarding the list of tutorials, ign-cmake doesn't have such a page

Ah nice catch, this is part of #53

Should we put the ign-cmake Windows instructions in https://github.com/ignitionrobotics/ign-cmake/blob/ign-cmake2/README.md ?

Yeah let's put it in the README for now

[chapulina]

let's put it in the README for now

Actually I went ahead and added tutorial generation for ign-cmake, so you could target that if you want: gazebosim/gz-cmake#137

[mabelzhang]

Thanks! I targeted that page for ign-cmake.

Should we duplicate the installation instructions to all the READMEs? That might get more visibility since that shows up on https://ignitionrobotics.org/libs/ . I can copy the text from the tutorials over to the READMEs for all the PRs once the texts are reviewed.

ign-common also doesn't seem to have an installation tutorial, but does have a README, so we'd be duplicating the Ubuntu stuff from the README to a new installation tutorial.

[chapulina]

Should we duplicate the installation instructions to all the READMEs?

We did a good push deduplicating the install instructions on #14, but as you pointed out, we missed some libraries. I reopened it with a list of the libraries that are left. Maybe some of those can be tackled as the Windows tutorials are added?

[mabelzhang]

Nice. Yeah I can do that while I'm at it.