I just got Hello World to work on Windows, which was great, but I felt the onboarding experience was a bit rough. It can be hard to put yourself in the shoes of a new user once you're not anymore, so I tried to write these problems down while they're still fresh in my mind:

Is Step 5 of the GTK Windows MSYS2 install instructions required for Gtk-rs? What parts of mingw-w64-x86_64-toolchain can be omitted? (It has 17 install options. Do I really need Ada, Fortran, Objective C?)
Requirements is not supposed to be used anymore. But it is the only document with Windows install instructions.
- SETX failed with this error for me. Setting in GUI worked, so I didn't investigate.
- Requirements gives the impression that only one of the sections "Using the native Windows shell" or "Using the MSYS2 MinGW shell" needs to be executed. However I could only compile after installing mingw-w64-x86_64-pkg-config and mingw-w64-x86_64-gcc, indicating the second part isn't optional.
Needing the GNU ABI is only metioned in the deprecated Requirements
- The linked rustup README on GNU ABI is hard to understand.
  - What do these things mean when I want to set up Gtk-rs?
  - Do I only need the rustup gnu target or the full gnu toolchain for Gtk-rs?
  - How do I configure Rust to use the right target/toolchain for my project without explicitly specifying it at every call to cargo?

A Windows build documentation should address those questions because other new users will likely also face them.

Add documentation about how to compile for Windows without cross-compilation #70

Description

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions