# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://liquiidio.gitbook.io/unity-plugin-suite/wcwunity/installation/mobile-installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
