Giter Club home page Giter Club logo

kit-app-template's Introduction

Omniverse Kit App Template

Omniverse Kit App Template - is the place to start learning about developing Omniverse Apps. This project contains everything necessary to develop and package an Omniverse App.

Links

What Is an App?

Ultimately, an Omniverse Kit app is a .kit file. It is a single file extension. You can think of it as the tip of a dependencies pyramid, a final extension that pulls in everything.

Extensive documentation detailing what extensions are and how they work can be found here.

Getting Started

Install Omniverse and some Apps

  1. Install Omniverse Launcher: download
  2. Install and launch one of Omniverse apps in the Launcher. This repo requires the latest Create installed.

Build

  1. Clone this repo to your local machine.
  2. Open a command prompt and navigate to the root of your cloned repo.
  3. Run build.bat to bootstrap your dev environment and build an example app.
  4. Run _build\windows-x86_64\release\my_name.my_app.bat (or other apps) to open an example kit application.

You should have now launched your simple kit-based application!

Package

To package, run package.bat. The package will be created in the _build/packages folder.

To use the package, unzip and run link_app.bat inside the package once before running.

Packaging just zips everything in the _build/[platform]/release folder, using it as a root. Linked app (baseapp) and kit (kit) folders are skipped.

Changing a Base App

When building 2 folder links are created: * _build/[platform]/release/baseapp link to Omniverse App (e.g. Create) * _build/[platform]/release/kit links to kit inside of the app above (same as _build/[platform]/release/baseapp/kit)

In repo.toml, the baseapp name and version are specified and can be changed:

[repo_kit_link_app]
app_name = "create"   # App name.
app_version = ""    # App version. Empty means latest. Specify to lock version, e.g. "2022.2.0-rc.3"

After editing repo.toml, run build.bat again to create new app links.

Keep Learning: Launching Apps

If you look inside the bat/sh app script runner file it just launches kit and passes a kit file (my_name.my_app.kit). Application kit files define app configuration. Omniverse Kit is the core application runtime for Omniverse Applications. Think of it as python.exe. It is a small runtime, that enables all the basics like settings, python, logging and searches for extensions. Everything else is an extension. You can run only this new extension without running any big App like Create:

There are 2 other app examples: my_name.my_app.viewport.kit and my_name.my_app.editor.kit. Try running them.

Contributing

The source code for this repository is provided as-is and we are not accepting outside contributions.

kit-app-template's People

Contributors

novoselov-ab avatar mati-nvidia avatar kshivakumar-nvidia avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.