Name: urho
Owner: Xamarin
Description: Code to integrate with the Urho3D engine
Created: 2015-06-04 17:30:23.0
Updated: 2018-05-24 16:24:14.0
Pushed: 2018-05-24 13:36:07.0
Homepage: null
Size: 63903
Language: C#
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
?# UrhoSharp
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 portable class 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:
Supported platforms:
Sample code lives in https://github.com/xamarin/urho-samples and repository has them as a git submodule. Samples use UrhoSharp via nuget.
Available on NuGet:
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):
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:
You will need:
brew install cmake
)xcode-select --install
)1. Clone the repository including submodules
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.
Generated
3. Compile UrhoSharp for Mac (fat dylib)
Mac
it takes 5-10 minutes.
4. Compile UrhoSharp for iOS (fat dylib: i386, x86_64, armv7, arm64)
iOS SDK_VER=11.2
5. Compile UrhoSharp for Android (armeabi, armeabi-v7a, arm64, x86, x86_64)
-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.
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
Windows.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:
Windows.bat x86 Debug 2017 DirectX
Compiles debug version of mono-urho.dll with DirectX as a backend.
Special thanks to @aktowns Prerequisites for Ubuntu 16.06
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:
Linux
*Tested on Ubuntu 16.06, Fedora 25 and WSL
Once you have a build, run the refresh-docs
target, like this:
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