MRTK und verwalteter Code stripping — MRTK2

Wenn Sie das IL2CPP-Skripting-Back-End von Unity (optional in Unity 2018.4, erforderlich im Jahr 2019 und neuer) verwenden, tritt verwalteter Code-Stripping auf. Der Linker von Unity führt diesen Prozess aus, um die Binärgröße zu verringern und die Buildzeiten zu verringern.

Das Mixed Reality Toolkit verwendet eine Datei, um zu beeinflussen, link.xmlwie der Linker von Unity MRTK-Assemblys verarbeitet. Diese Datei, die in der Dokumentation von Unity beschrieben wird, stellt den Linker anweisungen zum Beibehalten von Code bereit, wenn die Verwendung nicht abgeleitet werden kann (ex: über Spiegelung verwendet).

Als flexible und anpassbare Plattform erstellt MRTK die link.xml Datei im Assets/MixedRealityToolkit.Generated Import, wenn sie nicht vorhanden ist. Bereits vorhandene link.xml Dateien werden nicht überschrieben. Es wird empfohlen, link.xmllink.xml.meta die Versionskontrolle zu hinzufügen. Entwickler sollten sich frei fühlen, Assets/MixedRealityToolkit.Generated/link.xml die Anforderungen des Projekts zu erfüllen.

Standardmäßig behält die von MRTK erstellte link.xml Datei die Gesamte der Assemblys in den folgenden Daten.

<linker> 
  <!-- 
    This link.xml file is provided to prevent MRTK code from being optimized away 
    during IL2CPP builds.More details on when this is needed and why this is needed 
    can be found here: https://github.com/microsoft/MixedRealityToolkit-Unity/issues/5273 
    If your application doesn't use some specific services (for example, if teleportation system is 
    disabled in the profile), it is possible to remove their corresponding lines down 
    below(in the previous example, we would remove the TeleportSystem below). 
    It's recommended to start with this list and narrow down if you want to ensure 
    specific bits of code get optimized away. 
  --> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit" preserve="all"/> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.SDK" preserve="all"/> 
  <!-- Core systems --> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Services.BoundarySystem" preserve="all"/> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Services.CameraSystem" preserve="all"/> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Services.DiagnosticsSystem" preserve="all"/> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Services.InputSystem" preserve="all"/> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Services.SceneSystem" preserve="all"/> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Services.SpatialAwarenessSystem" preserve="all"/> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Services.TeleportSystem" preserve="all"/> 
  <!-- Data providers --> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Providers.LeapMotion" preserve="all"/> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Providers.OpenVR" preserve="all"/> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Providers.UnityAR" preserve="all"/> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Providers.WindowsMixedReality.Shared" preserve="all"/> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Providers.WindowsMixedReality" preserve="all"/> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Providers.XRSDK.WindowsMixedReality" preserve="all"/> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Providers.WindowsVoiceInput" preserve="all"/> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Providers.XRSDK" preserve="all"/> 
  <!-- Extension services --> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Extensions.HandPhysics" preserve="all"/> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Extensions.Tracking" preserve="all"/> 
  <assembly fullname = "Microsoft.MixedReality.Toolkit.Extensions.SceneTransitionService" preserve="all"/> 
</linker>

Weitere Informationen zum link.xml-Dateiformat finden Sie in der Unity-Dokumentation.

Siehe auch