PluginMobileNativeCode

KO | EN

gitlite — search

#python #react #ai #golang #machine-learning #linux #docker #nodejs #java #awesome #kubernetes #vue #security #mcp

PluginMobileNativeCode

(★ 108)

No description available.

File Explorer

Download Latest Version (.zip)

- - Icon128.png
- MobileNativeCode.uplugin
- CallJava4.png
- EnablePlugin1.png
- HonorPlay_2.png
- IOS_framework2.png
- iPhone7_2.png
- JavaBundle_Android.png
- Javap_Android.png
- LevelBlueprint2.png
- Logo3.png
- PathPlugin2.png
LICENSE
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Logo](https://raw.githubusercontent.com/Sovahero/PluginMobileNativeCode/master/screenshot/Logo3.png)

# Mobile Native Code Plugin for Unreal Engine 4/5
Plugin providing native mobile functionality access for Unreal Engine projects. Suitable for cases when you need:
* Access to device-specific features and file system
* Sensor data (Accelerometer, Barometer, etc.)
* Device information
* Inter-app communication
* Integration with mobile services (Facebook, Firebase, Admob)

**Mobile Native Code Plugin** serves as a foundation for native mobile development in Unreal Engine, supporting both Android and iOS platforms. It simplifies native code calls (Java/JNI and Objective-C) and provides examples of integrating external libraries.

# Features
![Java](https://raw.githubusercontent.com/Sovahero/PluginMobileNativeCode/master/screenshot/CallJava4.png)

* Engine Support: UE 4.21+ and UE 5.0+
* Used in commercial projects (UE 4.25-5.4)
* Calling native Java code with a single function from C++
* Examples of functions for interacting with native code

Source locations:
> **Blueprint/C++**: MobileNativeCode/Source/MobileNativeCode/Private/MobileNativeCodeBlueprint.cpp

> **Android**: MobileNativeCode/Source/MobileNativeCode/Private/Android/Java/

> **iOS**: MobileNativeCode/Source/MobileNativeCode/Private/IOS/ObjC/

Requirements:
* Visual Studio for Windows
* Xcode for iOS

# Setup

1) Copy MobileNativeCode to the Plugins folder located in the main path of your project (if not, create it).

![PathPlugin](https://raw.githubusercontent.com/Sovahero/PluginMobileNativeCode/master/screenshot/PathPlugin2.png)

2) Enable MobileNativeCode in Edit->Plugins->Installed->Mobile->MobileNativeCode. Restart the editor.

![EnablePlugin](https://raw.githubusercontent.com/Sovahero/PluginMobileNativeCode/master/screenshot/EnablePlugin1.png)

3) in the LevelBlueprint, create a diagram.

![LevelBlueprint](https://raw.githubusercontent.com/Sovahero/PluginMobileNativeCode/master/screenshot/LevelBlueprint2.png)

4) **Run on your mobile device.**

5) Go to *"MobileNativeCode\Source\MobileNativeCode\Private\MobileNativeCodeBlueprint.cpp"* to find out how these functions work

# Testing

**Android**

![HonorPlay](https://raw.githubusercontent.com/Sovahero/PluginMobileNativeCode/master/screenshot/HonorPlay_2.png)

**iOS**

![iPhone7](https://raw.githubusercontent.com/Sovahero/PluginMobileNativeCode/master/screenshot/iPhone7_2.png)

# Additional information

## for Android

* Go to *MobileNativeCode\Source\MobileNativeCode\Private* and open *MobileNativeCodeBlueprint.cpp*.
This file demonstrates 5 functions for calling Java code.

* **(IMPORTANT!)** When adding a new Java class or changing the current one, delete the **Intermediate** folder in your project folder.

* **Note for UE4 users**: If you're using UE4, uncomment the following code block in `MobileNativeCode_UPL_Android.xml`:
```xml


```

To call your own Java class:

* Add your *Java* class to the folder: *MobileNativeCode\Source\MobileNativeCode\Private\Android\Java*

* Change the value of *package* at: **com.Plugins.MobileNativeCode**

* before the class and functions, add ***@Keep***

* Java code is called using **AndroidUtils::CallJavaCode...**
 This function has two overloads for **static** and **local** Java functions:

> **AndroidUtils::CallJavaCode< *ReturnType* >("com/Plugins/MobileNativeCode/*YourClass*", "*YourFunction*", "", false, arg1, arg2, arg3)**
>* *ReturnType* - is specified depending on the return type. For example *FString* or *TArray< float >*
>* *1 argument* - is package+the name of your class 
>* *2 argument* - the name of your function 
>* *3 argument* - Set your own signature instead of an automatic one (send a blank one if you need an automatic one). 
> In most cases, this argument will be empty 
>* *4 argument* - indicates whether to pass the *Java main Activity* of this session. 
> If you want to pass an Activity, it should be specified first in the list of arguments of your Java function
>*  Further, the number of arguments can be passed as many as you want, depending on what your function accepts.

> **AndroidUtils::CallJavaCode< *ReturnType* >(*JavaObjectClass*, "*YourFunction*", "", arg1, arg2, arg3)**
>* *ReturnType* - is specified depending on the return type. For example *FString* or *TArray< float >*
>* *1 argument* - the type of *jobject* that you want to call the local function from
>* *2 argument* - the name of your function 
>* *3 argument* - Set your own signature instead of an automatic one (send a blank one if you need an automatic one).
> For example, if the function does not accept any parameters and returns the type of the Bundle class, you should specify **"()Landroid/os/Bundle;"**
>*  Further, the number of arguments can be passed as many as you want, depending on what your function accepts.

* OverrideSignature is specified so that JNI can find the desired function among all java files. Most of the standard types have been added to the plugin and therefore the 3rd function argument can be left empty. For some complex types (for example Bundle) you need to install it.

* To define *Signature* for complex types, you need to add your class to *"MobileNativeCode\Source\MobileNativeCode\ Private\Android\Java\"* and build your Android project. After a successful build, in your project folder navigate to: *"Intermediate\Android\ % ARCH% \gradle\app\build\intermediates\javac\debug\classes\com\Plugins\MobileNativeCode"*
you will see files with ***.class** type. You need to add the path of your **jdk/bin** to the system variables in **PATH**, then you need to open *PowerShell* or *Cmd* in this folder and enter the command **"javap -s YourJavaClass"**. After that, a list of all your functions will appear, our *Signature* will be in the descriptor field.
![SignatureJava](https://raw.githubusercontent.com/Sovahero/PluginMobileNativeCode/master/screenshot/Javap_Android.png)

* The ***UMobileNativeCodeBlueprint::ExampleMyJavaObject*** function shows an example of working with local Java objects. In order to assign any Java class to your jobject, you need to return it from a static variable (for example, *return new Bundle ();*) and then call the functions of this jobject, as in Java:
![JavaBundle](https://raw.githubusercontent.com/Sovahero/PluginMobileNativeCode/master/screenshot/JavaBundle_Android.png)

* Asynchronous Java invocation occurs through dispatchers UE4 - Java code calls a C++ function, which in turn activates it.

## For iOS

* The Objective-C language can be written in **. cpp* files, but it is better to use **. mm* file

* For some code, you need the key and the resolution (or another Description). The entire list can be seen at the links:
[Description Apple](https://developer.apple.com/documentation/bundleresources/information_property_list/protected_resources),
[Key Apple](https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252-SW3)

* These permissions can be added in Unreal engine 4 itself in the IOS section, but I suggest using the file *MobileNativeCode_UPL_iOS.xml* by path *MobileNativeCode\Source\MobileNativeCode*
In the commented lines, there is an example of how information is added to the Info.plist

* You can see the list of connected public libraries in the file *MobileNativeCode\Source\MobileNativeCode\MobileNativeCode.Build.cs*
![build](https://raw.githubusercontent.com/Sovahero/PluginMobileNativeCode/master/screenshot/IOS_framework2.png)
* If you don't have the Framework you need, add it yourself by simply continuing the list.
[Learn more about the IOS Framework](https://developer.apple.com/documentation/technologies)

* Also **MobileNativeCode.Build.cs** shows examples of connecting libraries **.framework and* **.bundle* in **.ipa* file

To call Objective-C code

* Add your *Objective-C* class to the *MobileNativeCode\Source\MobileNativeCode\Private\IOS\ObjC* folder

* Connect it to *MobileNativeCode\Source\MobileNativeCode\Private\MobileNativeCodeBlueprint.cpp*

PluginMobileNativeCode

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

PluginMobileNativeCode

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README