MicrosoftDocs / mixed-reality

Mixed Reality documentation
Creative Commons Attribution 4.0 International
173 stars 181 forks source link

MRTK Figma Bridge - Installation Fails, unexpected/unecessary installer. #731

Open JonathanDotCel opened 1 year ago

JonathanDotCel commented 1 year ago

I've been trying to use the Figma bridge, from this doc: https://learn.microsoft.com/en-us/windows/mixed-reality/design/figma-unity-bridge

It's a bit confusing off the bat, as it mentions a setup program, so: A: it's just going to download a bunch of .unitypackages and leave them somewhere. B: it's going to make me run it per-project, and install directly.

Both of which imply unnecessary extra steps, and introduce confusion early on for new users, especially as the top (Prerequisite) links on the page are terribly unclear, and sort of suggest that there's a much larger setup involved. Something like a setup via a .msi & .msix bundle or so, given that visual studio is mentioned.

These links are unclear: image E.g. What's going on? How much of this do I genuinely require just to use the figma bridge? chrome_Ru9iXJ7t73

I want to see if this bridge is suitable for my project, but there's no mention of for example:

In any case, I download and run it. (fwiw: At this point I'm hesitant to install this way as it's error prone, and you're relying on third party tools to correctly make changes to project files) The changes do appear to be sensible, it correctly detects Unity 2021.3.x, so I accept.

I switch over to unity and get the below errors.

Library\PackageCache\com.microsoft.mixedreality.toolkit.foundation@43abb40aaee4\SDK\Features\UX\Scripts\BoundsControl\BoundsControl.cs(939,54): error CS0165: Use of unassigned local variable 'colliderByTransform'

Library\PackageCache\com.microsoft.mixedreality.toolkit.foundation@43abb40aaee4\SDK\Features\UX\Scripts\BoundsControl\BoundsControl.cs(947,54): error CS0165: Use of unassigned local variable 'rendererBoundsByTransform'

Library\PackageCache\com.microsoft.mixedreality.toolkit.foundation@43abb40aaee4\SDK\Features\UX\Scripts\BoundingBox\BoundingBox.cs(1906,54): error CS0165: Use of unassigned local variable 'colliderByTransform'

Library\PackageCache\com.microsoft.mixedreality.toolkit.foundation@43abb40aaee4\SDK\Features\UX\Scripts\BoundingBox\BoundingBox.cs(1914,54): error CS0165: Use of unassigned local variable 'rendererBoundsByTransform'
Problem detected while importing the Prefab file: 'Packages/com.microsoft.mixedreality.toolkit.foundation/Providers/Oculus/XRSDK/MRTK-Quest/Prefabs/MRTK-Quest_LocalAvatar.prefab'.
The file might be corrupt or have missing nested Prefabs. See details below.
Errors:
    Prefab instance problem: MRTK-Quest_LocalAvatar (Missing Prefab with guid: 84c8b8609f9bb434eaf5248f17ff1293)
Problem detected while importing the Prefab file: 'Packages/com.microsoft.mixedreality.toolkit.foundation/Providers/Oculus/XRSDK/MRTK-Quest/Prefabs/MRTK-Quest_HandsPrefab.prefab'.
The file might be corrupt or have missing nested Prefabs. See details below.
Errors:
    Prefab instance problem: MRTK-Quest_HandsPrefab (Missing Prefab with guid: 835e735ca71bf78459fb2cababd74112)
Problem detected while importing the Prefab file: 'Packages/com.microsoft.mixedreality.toolkit.foundation/Providers/Oculus/XRSDK/MRTK-Quest/Prefabs/MRTK-Quest_OVRCameraRig.prefab'.
The file might be corrupt or have missing nested Prefabs. See details below.
Errors:
    Prefab instance problem: MRTK-Quest_OVRCameraRig (Missing Prefab with guid: 126d619cf4daa52469682f85c1378b4a)
    Prefab instance problem: OVRControllerPrefab (Missing Prefab with guid: d9809c5e8418bb047bf2c8ba1d1a2cec). 2 instances are missing the same Prefab

Okay never mind, let's undo those changes and see if there's a git repo. https://github.com/microsoft/MixedRealityToolkit-Unity/releases/tag/v2.8.3

There are a few choices: Extensions, Foundation, Utilities, Tools, etc... I download and install all of the .unitypackage files. There's no figma bridge here.

I search via git; https://github.com/search?q=repo%3Amicrosoft%2FMixedRealityToolkit-Unity%20figma&type=code There's no figma bridge here either.

There's no real web presence either. In fact, googling it either brings up the .md for the page in the first link. It finds this... but that doesn't seem to be the right thing: https://github.com/simonoliver/UnityFigmaBridge

I re-run the setup, and get this screen Which won't let me copy paste the package name. And made me sit through another catalogue refresh. And which has some theme issues. MixedRealityFeatureTool_jLV2MHnoAh

And which still wants to manually install dependencies. The dependencies now cause this due to guid collisions (999+ instances):

GUID [4d9628b89018421fa5adeaabed593632] for asset 'Packages/com.microsoft.mixedreality.toolkit.foundation/Core' conflicts with:
  'Assets/MRTK/Core' (current owner)
We can't assign a new GUID because the asset is in an immutable folder. The asset will be ignored.

I honestly feel like every step of this could have been handled much, much better.

Thanks Jonathan


Document Details

Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.