unity_player_widget 0.1.0

A plugin that allows you to embed a Unity project in Flutter.

unity_player_widget

A plugin that allows you to embed a Unity project in Flutter.

How to use

In development, use an example for now.

How to install

Preparation

0. Add unity_player_widget plugin to your Flutter project.
1. Create a Unity project (or use existed).
2. Download Editor folder and add it to your unity project.
3. Create a folder named "unity" in the Flutter project.
4. Move created Unity project to "unity" folder.
   

Your flutter project folder should look like this:
-android
-ios
-lib
-test
-unity
└{Your Unity Project}
-pubspec.yml
-README.md

Android

1. In Unity project go to File->Build settings
2. Add at least 1 scene to the project
3. Go to android Player Settings
   (!!!settings may vary depending on which Unity packages you use!!!)
   

Universal player settings:
Scripting Backend -> IL2CPP
ARMv7 -> TRUE
ARM64 -> TRUE

AR Foundation player settings:
Minimum API Level -> 24
Scripting Backend -> IL2CPP
ARMv7 -> TRUE
ARM64 -> TRUE

Vuforia player settings:
Scripting Backend -> IL2CPP
ARMv7 -> TRUE
ARM64 -> TRUE

EasyAR player settings:
Auto Graphics API -> False
Graphics APIs -> OpenGLES2
Multithread Rendering -> False
Scripting Backend -> IL2CPP
ARMv7 -> TRUE
ARM64 -> TRUE

4. Select UnityPlayerWidget->Export Android
5. In Flutter project go to android/unityLibrary/libs and create package for every aar or jar file in the folder. (If you use AndroidStudio, just right-click to your project, select New->Module->{Import .JAR/.AAR Package} and find aar or jar file in the libs folder).
   
   
6. Move all created packages into android folder.
7. Go to android/unityLibrary/build.gradle
   

• Remove this line:
  

// GENERATED BY UNITY. REMOVE THIS COMMENT TO PREVENT OVERWRITING WHEN EXPORTING AGAIN

• Replace all dependencies by implementation project(':[Name of created package]')
  Your dependencies should look like this:
  

dependencies {
    implementation project(':package1')
    implementation project(':package2')
    implementation project(':package3')
    implementation project(':package4')
}

• Add buildTypes to android section:
  

android {
	//**//
	buildTypes {
		profile { matchingFallbacks = ['debug', 'release'] }
	}
}

8. Go to android/settings.gradle
   

• Include all created packages (first line of the file)
  Your include section should look like this:
  

include ':app', ':package1', ':package2', ':package3', ':package4'

• Add this to the end of the file:

include ":unityLibrary"
project(":unityLibrary").projectDir = file("./unityLibrary")

9. minSdkVersion in android/app/build.gradle and android/unityLibrary/build.gradle must be equal (change minSdkVersion in android/app/build.gradle if they are not).
10. VUFORIA ONLY
    Add android:screenOrientation="fullSensor" as an activity attribute in android/app/src/main/AndroidManifest.xml file.

iOS

1. In Unity project go to File->Build settings
2. Add at least 1 scene to the project
3. Go to iOS Player Settings
   (!!!settings may vary depending on which Unity packages you use!!!)
   

Universal player settings:
Metal API Validation -> False

AR Foundation player settings:
Metal API Validation -> False
Target Minimum iOS version -> 11.0
Architecture -> ARM64

Vuforia player settings:
(not tested yet)

EasyAR player settings:
Auto Graphics API -> False
Graphics APIs -> Metal, OpenGLES2
Metal API Validation -> False
Architecture -> Universal

4. Select UnityPlayerWidget->Export iOS.
5. Open Runner.xcworkspace with Xcode and add ios/unityLibrary/Unity-iPhone.xcodeproj to "Runner".
   
6. Add Data folder to the UnityFramework in the Target Membership section.
   
   
7. Add UnityFramework to "Runner".
   
   
8. Go to Runner/Info.plist and set io.flutter.embedded_views_preview -> YES
9. AR ONLY
   Go to Runner/Info.plist and set Privacy - Camera Usage Description -> [Some description]
10. EasyAR ONLY
    Go to Unity-iPhone -> UnityFramework and set Enable Bitcode -> NO