Skip to content
Code to integrate with the Urho3D engine
C# C C++ HLSL GLSL Java Other
Branch: master
Clone or download

Latest commit

EgorBo Merge pull request #369 from gllebede/patch-1
Make mkdir command work on Windows environment
Latest commit cfeff3d Feb 8, 2019

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Bindings workaround for "bundling resource into ns2.0 with xamarin.ios10 doesn… Dec 3, 2018
Docs Added explanations for AsyncLoadState from source comments Jul 11, 2018
Extensions fix projects Nov 10, 2018
Nuget workaround for "bundling resource into ns2.0 with xamarin.ios10 doesn… Dec 3, 2018
ProjectTemplates update project templates Feb 22, 2018
Samples @ f1bcec7 update samples Mar 4, 2018
Screenshots improve linux support Feb 23, 2018
SharpieBinder Fix bug of generating extra class instead of struct(Copy paste problem) May 21, 2018
Tests fix Forms.iOS Nov 10, 2018
Urho3D fix projects Nov 10, 2018
docs update docs Dec 3, 2017
.gitignore fix #273 - GetBoneSafe doesn't accept StringHash Mar 1, 2018
.gitmodules put xamarin sumbodules back Apr 25, 2017
LICENSE Update license Dec 7, 2015
MakeAndroid one more mkdir Feb 7, 2019
MakeLinux fix #326 May 28, 2018
MakeMac drop i386 for macOS Nov 10, 2018
MakeSharpReality Get rid of WEBP support - (reduces native binary size by 5-7mb) Feb 20, 2018
MakeSharpReality.bat Get rid of WEBP support - (reduces native binary size by 5-7mb) Feb 20, 2018
MakeUWP Get rid of WEBP support - (reduces native binary size by 5-7mb) Feb 20, 2018
MakeUWP.bat fix projects Nov 10, 2018
MakeWindows fix MakeWindows Feb 20, 2018
MakeWindows.bat remove monoandroid81 from windows (mainly for CI) Nov 29, 2018
MakeWindowsAll.bat Add MakeWindowsAll.bat Mar 2, 2018
Makefile drop i386 for macOS Nov 10, 2018
MakeiOS drop i386 for macOS Nov 10, 2018
README.md Update README.md Feb 6, 2019
Urho.sln remove monoandroid81 from windows (mainly for CI) Nov 29, 2018
UrhoSharp.png New icon for the project templates and the Nuget Nov 18, 2015

README.md

UrhoSharp

Join the chat at https://gitter.im/xamarin/urho

UrhoSharp is a lightweight Game Engine suitable for using with C# and F# to create games and 3D applications. The game engine is available as a NETStandard 2.0 library, allowing your game code to be written once and shared across all platforms. UrhoSharp is powered by Urho3D, a game engine that has been under development for more than a decade. More information can be found in the UrhoSharp documentation. The bindings for Urho3D are licensed under the MIT license, as found on the LICENSE file.

Key advantages:

  • Lightweight - ~10mb per platform including basic assets
  • Embeddable - can be embedded into any app as a subview (UIView, NSView, Panel, etc).
  • Open-source - C# bindings and the underlying C++ engine Urho3D are licensed under the MIT License
  • Powerful 3rd parties - Bullet, Box2D, Recast/Detour, kNet, FreeType
  • Advanced graphics using physically based rendering (PBR), Skeletal animation, Inverse Kinematics etc
  • Simple code-first approach (however, it still supports native Urho3D editor)

Supported platforms:

  • Windows, WPF, WinForms (net45)
  • iOS (xamarin.ios10)
  • macOS
  • Android (monodroid81)
  • UWP (uap10.0.16299)
  • AR: HoloLens, ARKit, ARCore
  • Mixed Reality
  • Xamarin.Forms (iOS, Android, UWP)
  • Ubuntu

Sample Sample

Sample

Samples

Sample code lives in https://github.com/xamarin/urho-samples and repository has them as a git submodule. Samples use UrhoSharp via nuget.

Setup

Available on NuGet:

Quick start

To help developers get up and running quickly with UrhoSharp we are providing a solution template for Visual Studio (you can find it in "Online templates" tab). This template consists of PCL+Android+iOS+Mac/Windows with a simple scene and some assets (Xamarin Studio templates will be available soon):

VS

How to build bindings

This is currently a little messy, so YMMV.

In order to compile binaries for all platforms you will need both Windows and OS X environment. Please follow these steps:

Compile UrhoSharp on macOS

You will need:

  • XCode
  • Visual Studio for Mac
  • Homebrew (/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install))
  • CMake (brew install cmake)
  • Command Line tools (xcode-select --install)
  • Android NDK + ANDROID_NDK_HOME environment variable

NOTE: UrhoSharp.csproj and UrhoSharp.Forms.csproj are SDK-style NETStandard2.0 projects with multi-targeting, unfortunately Visual Studio for Mac currently doesn't fully support such projects so you have to compile them using msbuild CLI, e.g. cd Bindings/Forms && msbuild /restore UrhoSharp.Forms.csproj /p:Configuration=Release /p:Platform=AnyCpu

If you have an error message tool 'xcodebuild' requires Xcode, but active developer directory '/Library/Developer/CommandLineTools' is a command line tools instance during compilation try to switch developer directory like this sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

1. Clone the repository including submodules

git clone git@github.com:xamarin/urho.git --recursive

2. Compile Urho.pch, SharpieBinder and generate bindigs

The following command will download Clang 3.7.0 if you do not have it installed, and use this to scan the Urho header files, then compile the sources to PCH, parse it via SharpieBinder and generate C# bindings. Additionally there is a perl script to generate bindings to Urho3D events.

make Generated

3. Compile UrhoSharp for Mac (fat dylib)

make Mac

it usually takes 5-10 minutes.

4. Compile UrhoSharp for iOS (fat dylib: i386, x86_64, armv7, arm64)

make iOS SDK_VER=12.1

5. Compile UrhoSharp for Android (armeabi, armeabi-v7a, arm64, x86, x86_64)

make -j5 Android

-j5 means a job per ABI. Make sure you have installed Android SDK and NDK (see MakeAndroid file) This target can also be executed on Windows.

Compile UrhoSharp on Windows

Obviously you can't do it on OS X so you have to switch to Windows environment. Make sure you have installed:

You will need:

Open "Command Prompt for Visual Studio" (or regular CMD with msbuild.exe added to the PATH) Go to the project root directory and execute

MakeWindows.bat x64 Release 2017 OpenGL

All compiled binaries could be found in the Bin/{platform} folder. You can also change the parameters, for example the following command:

MakeWindows.bat x86 Debug 2017 DirectX

Compiles debug version of mono-urho.dll with DirectX as a backend.

Compile UrhoSharp on Linux*

Special thanks to @aktowns Prerequisites for Ubuntu 16.06

sudo apt-get install cmake clang-3.7 avr-libc libglew-dev libsdl2-dev libsdl2-image-dev libglm-dev libfreetype6-dev libgl1-mesa-dev libx11-dev

Then just execute:

make Linux

*Tested on Ubuntu 16.06, Fedora 25 and WSL

Updating Documentation

Once you have a build, run the refresh-docs target, like this:

make refresh-docs

This will update the documentation based on the API changes. Then you can use a tool like DocWriter [1] on the Mac to edit the contents, or just edit the ECMA XML documentation by hand with an XML editor.

[1] http://github.com/xamarin/DocWriter

You can’t perform that action at this time.