Project

The Project Tool generates ready-to-build starter projects for various platforms. It provides templates for Core, Engine, Compute, and Fragment applications.

info

If no command-line parameters are provided, the Project Tool displays a configuration interface. Tellusim SDK browser includes a Project menu for quickly launching the Project Tool.

info

You can omit the -root argument when creating a project inside the Tellusim SDK directory. Alternatively, the path to the Tellusim SDK can be set using the TSROOT environment variable.

info

When the target is outside the Tellusim SDK, the Project Tool copies the include and library directories into the new project folder.

Usage Example

Create a Core SDK application for Windows:

ts_project -core MyWindowsCoreApp -vcxproj

Create an Engine SDK application for Linux:

ts_project -engine MyLinuxEngineApp -cmake

Create a Fragment application for macOS:

ts_project -fragment MymacOSFragmentApp -xcodeproj

Create a Compute application for iOS:

ts_project -compute MyiOSComputeApp -platform ios -xcodeproj

Create and run a C# project:

ts_project -fragment MyCSharpApp -csproj
cd ./MyCSharpApp
dotnet run

Create and run a Rust Cargo project:

ts_project -fragment MyRustApp -cargo
cd ./MyRustApp
cargo run

Create and run a Swift Package Manager project:

ts_project -fragment MySwiftApp -swift
cd ./MySwiftApp
swift run

Create and run a Python project:

ts_project -fragment MyPythonApp -python
cd ./MyPythonApp
./main.py

Command Line Parameters

Tellusim Project Generation Tool
Usage: ts_project -fragment my_project -vcxproj -xcodeproj -root ../Tellusim_SDK
Usage: ts_project -engine my_project -makefile Makefile -root ../Tellusim_SDK
Usage: ts_project Makefile -cmake -makefile
  -verbose          Verbose output
  -clear            Clear arguments
  -info             Print arguments
  -core <name>      Create Core App
  -engine <name>    Create Engine App
  -compute <name>   Create Compute App
  -fragment <name>  Create Fragment App
  -name <name>      Set project name
  -root <path>      Path to Tellusim SDK root
  -target <name>    Binary name (main)
  -postfix <name>   Target postfix
  -platform <name>  Target platform (ios, tvos)
  -arch <name>      Project architecture
  -ipa <name>       iOS/tvOS IPA name
  -apk <name>       Android APK name
  -appx <name>      Windows UWP APPX name
  -srcs <name>      Source files
  -libs <name>      Library names
  -assets <name>    Resource names
  -std <version>    C++ STD version (11)
  -toolset <ver>    Visual Studio toolset (v143)
  -version <ver>    Visual Studio version (vs170)
  -minsdk <ver>     Android SDK version (30)
  -resource <path>  Path to resource directory
  -check <argument> Quit if the argument is not defined
  -cmake (name)     Create CMake project
  -makefile (name)  Create Makefile project
  -vcxproj (name)   Create Visual Studio project
  -xcodeproj (name) Create Xcode project
  -gradle (name)    Create Gradle project
  -csproj (name)    Create C# project
  -cargo            Create Rust project
  -swift            Create Swift project
  -python           Create Python project