MRTK e despojamento de código gerido — MRTK2
Ao utilizar o back-end de scripting IL2CPP do Unity (opcional no Unity 2018.4, necessário em 2019 e mais recente), ocorre o despojamento de código gerido . O linker do Unity executa este processo para reduzir o tamanho binário, bem como para diminuir os tempos de compilação.
O Mixed Reality Toolkit utiliza um ficheiro, link.xml, para influenciar a forma como o linker do Unity processa as assemblagens do MRTK. Este ficheiro, descrito na íntegra na documentação do Unity, fornece ao linker instruções sobre como preservar o código quando a sua utilização não pode ser inferida (por exemplo: utilizada através de reflexão).
Como uma plataforma flexível e personalizável, o MRTK cria o link.xml ficheiro na Assets/MixedRealityToolkit.Generated importação, caso se verifique que não existe. Os ficheiros de link.xml pré-existentes não são substituídos. Recomenda-se que link.xml e link.xml.meta seja adicionado ao controlo de versões. Os programadores devem sentir-se à vontade para personalizar Assets/MixedRealityToolkit.Generated/link.xml para satisfazer as necessidades do projeto.
Por predefinição, o ficheiro link.xml criado pelo MRTK preserva a totalidade das assemblagens apresentadas nos seguintes dados.
<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>
Para obter mais informações sobre o formato de ficheiro link.xml, consulte a documentação do Unity.