MicrosoftDocs/mixed-reality

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

JonathanDotCel opened this issue · 0 comments

JonathanDotCel commented

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:

  • if I need to use the rest of the SDK?
  • does it only import XR-aware widgets supplied by microsoft?
  • or can it work on vanilla UGUI?
  • does it handle prefabs and figma autolayout effectively?

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.

  • The video at the top of the page rushes through, and confusingly bounces between 10x speed and 0x speed sections, with no sound.
  • Make it clear the if the figma bridge works with vanilla Unity (e.g. built in UGUI Widgets)
  • If it does, split it off into a separate download
  • None of the connected pages have particularly clear links, especially as regards prerequisites
  • The installer feels unnecessary, bloated, fiddly, has theme issues, and ultimately doesn't work for reasons I can't debug.

Thanks
Jonathan

Document Details

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