Skip to content

Commit 1e8a921

Browse files
wiweikeveleigh
authored andcommitted
Merge pull request #7269 from wiwei/restartit
Add another troubleshooting step for msb4u integration
1 parent e265541 commit 1e8a921

File tree

1 file changed

+16
-2
lines changed

1 file changed

+16
-2
lines changed

Documentation/Tools/HolographicRemoting.md

Lines changed: 16 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ configure the project using the following steps.
2525

2626
### Debugging HoloLens 2 remoting via Unity package import
2727

28-
If HoloLens 2 hand joints and eye tracking aren't working over remoting, there are three common points of potential issues. They're listed below in the order they should be checked.
28+
If HoloLens 2 hand joints and eye tracking aren't working over remoting, there are a few common points of potential issues. They're listed below in the order they should be checked.
2929

3030
#### MSBuildForUnity package import via writing into the package.manifest
3131

@@ -45,7 +45,21 @@ For the third point, navigate to the Unity Player Settings. From there, under th
4545

4646
![DotNetWinRT Present](../Images/Tools/Remoting/DotNetWinRTPresent.png)
4747

48-
After all three of those, hand joints over remoting should be working! If not, there might be something misconfigured in the profiles for general hand joints on-device. In that case, please [reach out on one of our help resources](../GettingStartedWithTheMRTK.md#getting-help).
48+
#### Failure to find dotnet.exe
49+
50+
MSBuild for Unity depends on dotnet.exe existing in the system path - dotnet.exe must both be
51+
installed and present in the PATH environment variable. If neither of those requirements are
52+
true, this error may manifest in the Unity console:
53+
54+
```
55+
Win32Exception: ApplicationName='dotnet', CommandLine='msbuild DotNetAdapter.csproj -restore -v:minimal -p:NuGetInteractive=true -t:Build -p:Configuration=Release -nologo', CurrentDirectory='C:\src\Assets\MixedRealityToolkit.Providers\WindowsMixedReality\Shared\DotNetAdapter', Native error= The system cannot find the file specified.
56+
```
57+
58+
The solution to this is to ensure that the [.NET Core CLI tools are installed]
59+
(https://docs.microsoft.com/en-us/dotnet/core/tools/?tabs=netcore2x) and reboot the system
60+
to force all apps to get a refreshed system path.
61+
62+
If hand joints over remoting are still not working after following the above steps, there might be something misconfigured in the profiles for general hand joints on-device. In that case, please [reach out on one of our help resources](../GettingStartedWithTheMRTK.md#getting-help).
4963

5064
### Removing HoloLens 2-specific remoting support
5165

0 commit comments

Comments
 (0)