StereoKit.Templates 0.7.4

StereoKit.Templates

These StereoKit templates are designed to be used with the dotnet new command for command-line and environments like Visual Studio Code, and also work with Visual Studio 2022's "New Project" interface! You do not need to clone this repository, these templates can be installed easily via the NuGet package.

Install

# Install the templates!
dotnet new install StereoKit.Templates

Pre-requisites

If you don't have the .NET SDK, or the dotnet command, you can install this via winget:

winget install Microsoft.DotNet.SDK.7
# Restart the Terminal to refresh your Path variable

On Linux, it may be as simple as this! If not, check Microsoft's instructions for installing dotnet on your Linux distribution.

sudo apt-get install dotnet-sdk-7.0

Usage

The sk-net template is a good place to start. It works with VR on Windows and Linux, and provides a good Simulator for development.

# Create a .NET Core based StereoKit project, and run it
mkdir SKProjectName
cd SKProjectName
dotnet new sk-net
dotnet run

Android Projects

The sk-multi template can also deploy to Android devices. While this experience is mostly seamless when using Visual Studio 2022, using CLI or VS Code is not as simple as dotnet run. Instead, you must build an apk and install that:

# Start with an multiplatform project
dotnet new sk-multi
# You _can_ still run the StereoKit Simulator like this
dotnet run
# To run on Android, just run the Android flavored project!
dotnet run --project Projects\Android\SKProjectName.Android.csproj

Publishing an APK

You can also build and deploy an APK like this! This was the only way to do it in the past, but may still be useful in some scenarios.

# The build command for making the Android APK
dotnet publish -c Release Projects\Android\SKProjectName.Android.csproj

# Install on device
adb install Projects\Android\bin\Release\net7.0-android\publish\com.companyname.skprojectname-Signed.apk
# Run the APK on device
adb shell monkey -p com.companyname.skprojectname 1

Additional information about signing apks while building like this can be found here.

Items

# Add an unlit shader named "test_shader" to the Assets folder
dotnet new skshader-unlit -n test_shader -o Assets

# Add an shader with default lighting named "test_lit_shader" to the Assets
# folder
dotnet new skshader-lit -n test_lit_shader -o Assets

# Add a basic IStepper template called SomeSystem
dotnet new skstepper -n SomeSystem.cs

Templates

Project templates:

Item templates: