-
Notifications
You must be signed in to change notification settings - Fork 17
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #24 from hwsmm/android
Add an Android bindings project
- Loading branch information
Showing
10 changed files
with
191 additions
and
24 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,48 @@ | ||
| Additions allow you to add arbitrary C# to the generated classes | ||
| before they are compiled. This can be helpful for providing convenience | ||
| methods or adding pure C# classes. | ||
|
|
||
| == Adding Methods to Generated Classes == | ||
|
|
||
| Let's say the library being bound has a Rectangle class with a constructor | ||
| that takes an x and y position, and a width and length size. It will look like | ||
| this: | ||
|
|
||
| public partial class Rectangle | ||
| { | ||
| public Rectangle (int x, int y, int width, int height) | ||
| { | ||
| // JNI bindings | ||
| } | ||
| } | ||
|
|
||
| Imagine we want to add a constructor to this class that takes a Point and | ||
| Size structure instead of 4 ints. We can add a new file called Rectangle.cs | ||
| with a partial class containing our new method: | ||
|
|
||
| public partial class Rectangle | ||
| { | ||
| public Rectangle (Point location, Size size) : | ||
| this (location.X, location.Y, size.Width, size.Height) | ||
| { | ||
| } | ||
| } | ||
|
|
||
| At compile time, the additions class will be added to the generated class | ||
| and the final assembly will a Rectangle class with both constructors. | ||
|
|
||
|
|
||
| == Adding C# Classes == | ||
|
|
||
| Another thing that can be done is adding fully C# managed classes to the | ||
| generated library. In the above example, let's assume that there isn't a | ||
| Point class available in Java or our library. The one we create doesn't need | ||
| to interact with Java, so we'll create it like a normal class in C#. | ||
|
|
||
| By adding a Point.cs file with this class, it will end up in the binding library: | ||
|
|
||
| public class Point | ||
| { | ||
| public int X { get; set; } | ||
| public int Y { get; set; } | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,18 @@ | ||
| <Project Sdk="Microsoft.NET.Sdk"> | ||
| <PropertyGroup> | ||
| <TargetFramework>net8.0-android</TargetFramework> | ||
| <SupportedOSPlatformVersion>21</SupportedOSPlatformVersion> | ||
| <RootNamespace>SDL3_CS_Android</RootNamespace> | ||
| <Nullable>enable</Nullable> | ||
| <ImplicitUsings>enable</ImplicitUsings> | ||
| </PropertyGroup> | ||
| <ItemGroup> | ||
| <EmbeddedJar Include="Jars\SDL3AndroidBridge.jar" /> | ||
| </ItemGroup> | ||
| <ItemGroup> | ||
| <EmbeddedNativeLibrary Include="..\native\android\armeabi-v7a\libSDL3.so" /> | ||
| <EmbeddedNativeLibrary Include="..\native\android\arm64-v8a\libSDL3.so" /> | ||
| <EmbeddedNativeLibrary Include="..\native\android\x86\libSDL3.so" /> | ||
| <EmbeddedNativeLibrary Include="..\native\android\x86_64\libSDL3.so" /> | ||
| </ItemGroup> | ||
| </Project> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,14 @@ | ||
| <enum-field-mappings> | ||
| <!-- | ||
| This example converts the constants Fragment_id, Fragment_name, | ||
| and Fragment_tag from android.support.v4.app.FragmentActivity.FragmentTag | ||
| to an enum called Android.Support.V4.App.FragmentTagType with values | ||
| Id, Name, and Tag. | ||
| <mapping jni-class="android/support/v4/app/FragmentActivity$FragmentTag" clr-enum-type="Android.Support.V4.App.FragmentTagType"> | ||
| <field jni-name="Fragment_name" clr-name="Name" value="0" /> | ||
| <field jni-name="Fragment_id" clr-name="Id" value="1" /> | ||
| <field jni-name="Fragment_tag" clr-name="Tag" value="2" /> | ||
| </mapping> | ||
| --> | ||
| </enum-field-mappings> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,13 @@ | ||
| <enum-method-mappings> | ||
| <!-- | ||
| This example changes the Java method: | ||
| android.support.v4.app.Fragment.SavedState.writeToParcel (int flags) | ||
| to be: | ||
| android.support.v4.app.Fragment.SavedState.writeToParcel (Android.OS.ParcelableWriteFlags flags) | ||
| when bound in C#. | ||
| <mapping jni-class="android/support/v4/app/Fragment.SavedState"> | ||
| <method jni-name="writeToParcel" parameter="flags" clr-enum-type="Android.OS.ParcelableWriteFlags" /> | ||
| </mapping> | ||
| --> | ||
| </enum-method-mappings> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,14 @@ | ||
| <metadata> | ||
| <remove-node | ||
| path="/api/package[@name='org.libsdl.app']/class[@name='SDLActivity']/field[@name='mClipboardHandler']"/> | ||
| <remove-node | ||
| path="/api/package[@name='org.libsdl.app']/class[@name='SDLActivity']/field[@name='mMotionListener']"/> | ||
| <remove-node | ||
| path="/api/package[@name='org.libsdl.app']/class[@name='SDLActivity']/field[@name='mTextEdit']"/> | ||
| <remove-node | ||
| path="/api/package[@name='org.libsdl.app']/class[@name='SDLActivity']/method[@name='getMotionListener' and count(parameter)=0]"/> | ||
| <remove-node | ||
| path="/api/package[@name='org.libsdl.app']/class[@name='SDLControllerManager']/field[@name='mHapticHandler']"/> | ||
| <remove-node | ||
| path="/api/package[@name='org.libsdl.app']/class[@name='SDLControllerManager']/field[@name='mJoystickHandler']"/> | ||
| </metadata> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Empty file.
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters