Skip to main content

Project

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

info

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

note

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.

Project Browser

Usage Example

Create a Core SDK C++ application for Windows:

ts_project -core MyWindowsApp -vcxproj

Create an Engine SDK C++ application for Linux:

ts_project -engine MyLinuxApp -cmake

Create a Fragment C++ application for macOS:

ts_project -fragment MymacOSApp -xcodeproj

Create a Compute C++ application for iOS:

ts_project -compute MyiOSApp -platform ios -xcodeproj

Create a Compute C++ application for Android:

ts_project -compute MyAndroidApp -gradle
cd ./MyAndroidApp/MyAndroidApp.gradle
./gradlew build

Create and run a C# project:

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

Create and run a Java project:

ts_project -fragment MyJavaApp -java
cd ./MyJavaApp
./gradlew 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
-canvas <name> Create Canvas 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 (33)
-check <argument> Exit 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
-java (name) Create Java project
-cargo Create Rust project
-swift Create Swift project
-python Create Python project