Awesome
TSK VSCode Editor
Unity Code editor integration for VSCode. (2021.3+)
Check out the Changelog and FAQs pages for more information.
Note - This package is incompatible with Unity Visual Studio package.
If you find my package useful, please consider giving it a Star 🌟 to show your support. Thank you!
Features
Project SDK Support
This package offers comprehensive project SDK support based on .Net standards. By leveraging this support, you can utilize the latest C# features and language enhancements within your Unity projects, subject to Unity's compatibility.
Organized .csproj Files
To enhance project structure and maintain cleanliness, the com.tsk.ide.vscode
package facilitates the automatic separation of .csproj
files into individual folders. These folders are consolidated within a main directory named "CSProjFolders." This organization ensures a more streamlined and organized project structure, contributing to improved clarity and ease of navigation.
Successful Dotnet Build
The com.tsk.ide.vscode
package ensures a seamless build process by guaranteeing successful execution of the dotnet build
command. This means your project can be compiled and built without issues, ensuring a smooth development experience.
Microsoft.Unity.Analyzers Integration
In addition to its core features, this package includes seamless integration with Microsoft.Unity.Analyzers library. This integration provides access to various code analysis and validation tools designed for Unity projects. With the support of these analyzers, you can enhance code quality, identify potential issues, and adhere to best practices, ultimately improving the overall robustness and maintainability of your Unity projects.
Streamlined Configuration Setup and Customization
The com.tsk.ide.vscode package presents a proficient solution designed for streamlined integration of Visual Studio Code with Unity. This package significantly simplifies the setup process by generating essential configuration files, namely settings.json
, .editorconfig
, .code-workspace
, and launch.json
. This conserves valuable time and boosts your efficiency by minimizing the potential for setup errors.
To utilize this feature, navigate to Preferences > External Tools > Generate config files for:
and select the appropriate options to create the configuration files. After this, merely click on the Regenerate
button.
Beyond simplifying setup, the com.tsk.ide.vscode
package introduces a dedicated configuration section within External Tools. This component provides unprecedented control over the settings files generated, enabling manual customization in accordance with individual preferences and unique project requirements. This flexibility allows you to customize your development environment for the best possible productivity and outcome.
Prerequisites
- Install the .Net 7 SDK.
- Install the C# Dev Kit extension from the VS Code Marketplace.
- Install the Unity extension from the VS Code Marketplace
Install via Package Manager
Unity
- Open Window/Package Manager
- Click +
- Select Add package from git URL
- Paste
https://github.com/Chizaruu/com.tsk.ide.vscode.git#upm
into URL - Click Add
OpenUPM
Please follow the instrustions:
- Open Edit/Project Settings/Package Manager
- Add a new Scoped Registry (or edit the existing OpenUPM entry)
Name: package.openupm.com
URL: https://package.openupm.com
Scope(s): com.tsk.ide.vscode
- Click Save (or Apply)
- Open Window/Package Manager
- Click +
- Select Add package by name... or Add package from git URL...
- Paste
com.tsk.ide.vscode
into name - Paste
1.5.0
into version - Click Add
Alternatively, merge the snippet to Packages/manifest.json
{
"scopedRegistries": [
{
"name": "package.openupm.com",
"url": "https://package.openupm.com",
"scopes": ["com.tsk.ide.vscode"]
}
],
"dependencies": {
"com.tsk.ide.vscode": "1.5.0"
}
}
Post Installation
Regenerate .csprog files
After installing the package, follow these steps to regenerate the .csproj files:
- Open the Preferences window.
- Go to the External Tools tab.
- Click on the Regenerate .csproj Files option.
The assembly project files will be auto-generated in {ProjectDirectory}/CSharpProjFolders.
To ignore these auto-generated files, add the following line to your .gitignore:
Example .gitignore lines:
# TSK VSCode
/CSharpProjFolders/*
Extras
- To enable grammar and highlighting for jslib files, install the jslib-for-unity package.
Contributing
Thank you for considering contributing to the com.tsk.ide.vscode
package! To contribute, please follow these guidelines:
- Create a new branch for your changes.
- Discuss your changes by creating a new issue in the repository before starting work.
- Follow the existing coding conventions and style.
- Provide a clear description of your changes in your pull request.
- Submit your pull request to the default branch.
We appreciate all contributions to com.tsk.ide.vscode!