# Mobile Installation

Please note that the **USAGE OF THIS PLUGIN ON MOBILE DEVICES IS NOT RECOMMENDED** as it uses a local HttpListener and works with localhost instead of a real domain while usage of a real domain is supported. Both comes with security risks.

### **UniversalSDK**

The Mobile Installation and Configuration requires an additional third-party Package to be installed\
\- <https://assetstore.unity.com/packages/tools/integration/universal-sdk-204843>\
\
The **UniversalSDK Package** allows the Application to make use of

* ***Chrome-Custom-Tabs*** on Android (see <https://developer.chrome.com/docs/android/custom-tabs/> for further information)
* ***SFSafariViewController*** on iOS ( see h[ttps://developer.apple.com/documentation/safariservices/sfsafariviewcontroller](https://developer.apple.com/documentation/safariservices/sfsafariviewcontroller) for further information)<br>

### Chrome-Custom-Tabs and the SFSafariViewController

Chrome-Custom-Tabs and the SFSafariViewController will allow the Application to Login to the Wax Cloud Wallet and Sign and Push Transactions/Acions in a secure environment while Cookies are shared between Custom-Tab/SafariViewController-Sessions and the local Browser, minimizing the Security-Risks while increasing the User-Experience.\
\
Apart from above mentioned benefits, the use of these native features allows the removal of specific issues coming with the use of WebViews&#x20;

* Cookie-Problems resulting in having to Login again and again
* no auto-signing
* disallowed user-agents within the WebView resulting in failing OAuth-Authenitcation
* banning of Applications from the AppStore or PlayStore because of usage of disallowed or unsupported user-agents
* banning of Applications from the AppStore or PlayStore because of heavy usage of WebViews (see iOS and Android Guidelines)

### Installation

* Download and install the UniversalSDK (<https://assetstore.unity.com/packages/tools/integration/universal-sdk-204843>) from the AssetStore&#x20;
* **Follow the Installation-instructions provided in the UniversalSDK- Repository/Package&#x20;*****(The Setup is unfortunately not that easy but it's possible and works if it's done right)** We could try to explain the configuration here with our own words but we would never do as well as the author of the package*

***NOTE!** Builds for other Targets (WebGL, Desktop etc.) will fail if the UniversalSDK is installed, therefore, it is recomended to create* separate branches for your Mobile-Targets.
