Проблемы с .NET
This section provides information on typical .NET related issues. В этом разделе представлена информация о типичных проблемах, связанных с .NET.
.NET 5 SDK versionВерсия SDK .NET 5#
To develop a project using C# Component System, a developer (artist, designer, and any other person working with the project) should have .NET 5 SDK installed on their computer. Чтобы разработать проект с использованием C # Component System , разработчик (художник, дизайнер и любой другой человек, работающий с проектом) должен установить на свой компьютер .NET 5 SDK.
It is required to install the SDK, not the runtime, because SDK contains both the compiler, which compiles .cs-components in UnigineEditor, and the runtime, which runs an already compiled application from UnigineEditor at the development stage. Требуется установить SDK , а не среду выполнения, поскольку SDK содержит как компилятор, который компилирует .cs-компоненты в UnigineEditor, так и среду выполнения, которая запускает уже скомпилированное приложение из UnigineEditor. на стадии разработки.
Do I Need to Install .NET 5 on All PCs to Run the Final Build?Нужно ли мне устанавливать .NET 5 на все ПК для запуска финальной сборки?#
Running a final application built by UnigineEditor via the Build Tool does not require .NET 5 SDK or .NET 5 runtime. The output applications are self-contained and can be run flawlessly on almost any computer. Для запуска окончательного приложения, созданного UnigineEditor через Build Tool не требуется .NET 5 SDK или среда выполнения .NET 5. Приложения вывода являются самодостаточными и могут безупречно запускаться практически на любом компьютере.
Typical ErrorsТипичные ошибки#
If you don't have .NET 5 SDK installed, you can come across various errors while working with the project in both SDK Browser and UnigineEditor. For example, when running the application (clicking the RUN button) after creating it in SDK Browser, you may receive the error stating that File Not Found — File *_x64.dll doesn't exist: Если у вас не установлен .NET 5 SDK, вы можете столкнуться с различными ошибками при работе с проектом как в SDK Browser, так и в UnigineEditor. Например, при запуске приложения (нажав кнопку RUN) после его создания в браузере SDK вы можете получить сообщение об ошибке, в котором говорится, что File Not Found — File *_x64.dll doesn't exist:
File Not Found — File *_x64.dll doesn't exist File Not Found — File *_x64.dll doesn't exist Errors also can occur when clicking the Play button in UnigineEditor (Required .NET SDK 5.0 not found): Ошибки также могут возникать при нажатии кнопки Play в UnigineEditor (Required .NET SDK 5.0 not found):
Required .NET SDK 5.0 not found Требуемый пакет SDK для .NET 5.0 не найден Fixing Errors with Missing SDKИсправление ошибок с отсутствующим SDK#
To fix any possible errors with missing .NET 5 SDK, you need to download and install .NET 5 SDK using the following link: https://dotnet.microsoft.com/download/dotnet/5.0. Чтобы исправить любые возможные ошибки с отсутствующим пакетом SDK для .NET 5, вам необходимо загрузить и установить .NET 5 SDK по следующей ссылке: https://dotnet.microsoft.com/download/dotnet/5.0.
After installing .NET 5 SDK, restart UnigineEditor to have all the changes in the OS be implemented correctly. For Windows, it is also recommended to restart the PC to have the %PATH% variable updated. После установки .NET 5 SDK перезапустите UnigineEditor, чтобы все изменения в ОС были внесены правильно. Для Windows также рекомендуется перезагрузить компьютер, чтобы обновить переменную %PATH%. Installing .NET 5 SDK on WindowsУстановка .NET 5 SDK в Windows#
Install a version 5.0.x: https://dotnet.microsoft.com/download/dotnet/5.0. Установите версию 5.0.x: https://dotnet.microsoft.com/download/dotnet/5.0.
Download the required installer and run it following all installation steps. Загрузите необходимый установщик и запустите его, выполнив все шаги установки.
Optional: After installing the SDK you might find it useful to disable .NET SDK telemetry. Необязательно : после установки SDK может оказаться полезным отключить телеметрию .NET SDK .
Installing .NET 5 SDK on LinuxУстановка .NET 5 SDK в Linux#
Install a .NET SDK version 5.0.x: https://docs.microsoft.com/en-us/dotnet/core/install/linux. Мы рекомендуем установить .NET SDK версии 5.0.x: https://docs.microsoft.com/en-us/dotnet/core/install/linux.
Linux operating systems supported by .NET 5.0 include at least the following: Операционные системы Linux, поддерживаемые .NET 5.0, включают как минимум следующее:
- Red Hat Enterprise Linux 7, 8
- CentOS 7, 8
- Fedora 32, 33
- Debian 9, 10
- Ubuntu 16.04, 18.04, 19.10, 20.04, 20.10
- openSUSE 15+
- SUSE Enterprise Linux (SLES) 12 SP2+, 15
- Alpine Linux 3.11+
Checking .NET SDK VersionПроверка версии пакета SDK для .NET#
You can check which .NET SDK Version (or versions) is installed on your PC. Вы можете проверить, какая версия (или версии) .NET SDK установлена на вашем компьютере.
On WindowsВ Windows#
- Open the Command Prompt (Click the Start button and type cmd). Откройте командную строку (нажмите кнопку Start и введите cmd ).
- In the window that opens, type the following:
Shell-командыВ открывшемся окне введите следующее:
dotnet --list-sdksShell-командыdotnet --list-sdks
The following information should appear: Должна появиться следующая информация:
List of the SDKs installed on the PC Список SDK, установленных на ПК On LinuxВ Linux#
- Open the terminal. Откройте терминал.
- In the window that opens, type the following:
Shell-командыВ открывшемся окне введите следующее:
dotnet --list-sdksShell-командыdotnet --list-sdks
The following information should appear: Должна появиться следующая информация:
List of the SDKs installed on the PC Список SDK, установленных на ПК In the output, all installed .NET SDK versions are listed. If you installed .NET 5 SDK and it is not listed, address Microsoft support. В выходных данных перечислены все установленные версии .NET SDK. Если вы установили .NET 5 SDK и его нет в списке, обратитесь в службу поддержки Microsoft.
Checking SDK CompatibilityПроверка совместимости SDK#
When loading a C# Component System based project, UnigineEditor lists all found .NET versions in its log: При загрузке проекта на основе C # Component System UnigineEditor перечисляет все найденные версии .NET в своем журнале:
 |
.NET SDK is не найден. |
 |
Обнаружены неподходящие версии .NET SDK. |
 |
.NET SDK 5.0.x найден, и Cистема компонентов C# успешно инициализирована. |
Visual Studio Code IssuesПроблемы с Visual Studio Code#
OmniSharp extension Error: spawn cmd ENOENTOmniSharp extension Error: spawn cmd ENOENT#
In case IntelliSense cannot be started due to the spawn cmd ENOENT error in the OmniSharp extension, it is recommended to add %WINDIR%\System32 to the PATH variable. Если IntelliSense не может быть запущен из-за ошибки spawn cmd ENOENT в расширении OmniSharp, рекомендуется добавить %WINDIR%\System32 к переменной PATH.
Editing the PATH variable on Windows 10 Редактирование переменной PATH в Windows 10 On Linux, you may require adding ~/.vscode/extensions to the path, for example in the .bashrc file:
export PATH=$HOME/.vscode/extensions:$PATH В Linux вам может потребоваться добавить ~/.vscode/extensions к пути, например, в файле .bashrc:
export PATH=$HOME/.vscode/extensions:$PATH
For more details see https://github.com/OmniSharp/omnisharp-vscode/issues/32. Подробнее см. https://github.com/OmniSharp/omnisharp-vscode/issues/32.
Project Opening IssuesПроблемы открытия проекта#
In case a single source file of a C# component is opened in VS Code when double-clicking it in UnigineEditor, it is recommended to make sure the path to the VS Code bin (%VSCODE_INSTALLATION_FOLDER%\bin) folder is added to the %PATH% environment variable, for example, as follows: C:\Program Files\Microsoft VS Code\bin. В случае, если один исходный файл компонента C # открывается в VS Code при двойном щелчке по нему в UnigineEditor, рекомендуется убедиться, что путь к папке bin (%VSCODE_INSTALLATION_FOLDER%\bin) VS Code добавлен в переменную среды %PATH% , например, так: C:\Program Files\Microsoft VS Code\bin.
Editing the PATH variable on Windows 10 Редактирование переменной PATH в Windows 10 For Windows, it is also recommended to restart the PC to have the %PATH% variable updated. Для Windows также рекомендуется перезагрузить компьютер, чтобы обновить переменную %PATH%.