Installation instructions: Difference between revisions

'''[[About ExaGear products|ExaGear products]]''' is a commercial project closed in 2019, the goal of which was to launch x86 games and applications on ARM systems.

You need to download the latest actual caches and APK ''ExaGear Windows Emulator''. '''Important!''' Currently, it is not possible to buy a license due to the closure of the project, use modified APKs. Today, for 3D games, it is not recommended to use the original .obb, since the rendering speed is very low there, and there is no OpenGL support, it is recommended to use Chinese (fix) caches modified by the user mr.frolof. You can download them on ''[[Exagear International:About|server]] Discord ExaGear International'', the recommended cache for 2D games can be downloaded [https://drive.google.com/file/d/12KeBQnAjmmH_9-kL8o_fSi2zi5l6tcj4/view from here].

====Launching and testing work====

After the cache has been decompressed, you need to create a container with the necessary permissions (permissions

which correspond to the screen resolution, for example, 2400x1080 is in the modified APK) (be sure to switch 16 bit to 32 in the screen settings), and with the necessary control. Launch TFM from your desktop (you need to choose the one that suits your device (for example: "Mali, OpenGL 3.3" or similar). If there is only one TFM to choose from, then launch it. You can launch the container from "Menu->Container Management- >Press the three dots next to the container name->Run". Download (from Google Drive) [https://drive.google.com/file/d/1daP90r7ScKqRJ2mdg-b9hJyHFOrXGEWv/view?usp=sharing simple test] DirectX 9 and extract it.

'''Attention!''' If the original obb is used, and/or old modifications, then there are no TFM shortcuts by default, they must be created manually. For OpenGL, Direct3D to work in the original .obb ''ExaGear'' you need to install additional LibGL libraries (or patches).

'''Important!''' If you have a device with a Mali video accelerator (you can check it in ''AIDA64''), then to get 3D acceleration you need to run VirGL (in Chinese APK and its mods, you can enable it directly from the main menu '' ExaGear Windows Emulator''). More detailed instructions are [[Installation instructions#Instructions for installing and configuring VirGL Overlay|below]].

After starting the container, check the rendering operation: set the rendering mode from the "Start" menu along the path: Start->WineGL->VirGL (you can Turnip + Zink, VirtIO-GPU if you have Adreno 618+), (paths may differ).

'''Important!''' If non-Chinese .obbs are used, the start menu paths may be different, and some items may not be available.

Start Sphere/CubeMap. If a kettle or an airplane with a kettle is displayed over the screen (Does not apply to VirtIO-GPU, LLVMpipe (not recommended), Turnip+Zink), then ''ExaGear'' works properly. If an error window appears, then the previous steps may not have been completed/performed with errors.

If there were no problems, or they are solved, you can try to run 2D / 3D games, the most playable ones will be games from the mid-2000s. You can try to increase the number of fps using the [[Optimize games in ExaGear|data]] registry commands.

There are apk versions with different package names, for example: original com.eltechs.ed, clone com.eltechs.es. Such apk can be installed in parallel, but two programs cannot be launched at the same time (there will be an error when starting the container.

====Help====

For help, you can contact the ''ExaGear International'' server, where they will help you if possible. Before you ask a question, check out how to properly frame it on the #faq-faq channel

Unofficial support for joysticks, etc. can be done by res [[Controls in ExaGear#Input Bridge|Input Bridge]]. Keyboards, mice can work without it.

# [[Optimization games in ExaGear]]

# [[Controls in ExaGear]]

 

==== Download the latest ExaGear RPG/Strategies and software ====

First, you need to download the latest official (or modified) cache file (.obb) '''ExaGear RPG/Strategies'''(''2.6.8,3.5.0'' ''respectively)'' from [[http://https://4pda.to/forum/index.php?showtopic=992239&st=0#entry30308693 post]] on the 4PDA forum, as well as APK. Then, download the required program you want to run in '''ExaGear RPG/Strategies'''.

'''Important!''' Currently, it is not possible to buy a license due to the closure of the project, use modified APKs.

==== Installing the App ====

====Checking the functionality====

Move the .exe file(s) of the program you want to run to /sdcard/ExaGear, run '''ExaGear RPG/Strategies''', select the file you want to run, the translator program and the .exe file will run.

'''Important! ExaGear RPG/Strategies are outdated.''' Android 9 and above may experience problems launching the application. There may also be [[Device compatibility#Problems running ExaGear on Huawei devices|problems]] with Huawei devices running Android 9+.

'''Important!''' VirGL does not work on '''ExaGear RPG/Strategies''', or major cache modifications are required to run on '''ExaGear RPG/Strategies'''!

To get started, download the latest version of '''VirGL Overlay''' modified to work without root (on 17.09.22 the latest version is 0.0.9) from [https://drive.google.com/file/d/1KGpwEjy3ICEsYpqOVinbljHMmtAyYBML/view?usp=sharing this] link. You also need to download and install a suitable '''ExaGear''' cache with '''VirGL''' support. Base cache can be downloaded [https://mega.nz/file/PuhwTQCT#aswzqKc3iLEJI9DFdNPc-EbyWfMF9TmZWtiBqv2b_Q0 here].

==== Health Check ====

[https://drive.google.com/file/d/1daP90r7ScKqRJ2mdg-b9hJyHFOrXGEWv/view?usp=sharing Download] a simple test ''DirectX 9'' and unzip it. Go to ExaGear and run Sphere/CubeMap. If a teapot or a plane with a teapot is displayed on top of the screen, then '''VirGL''' works. If an error window appears, then the previous steps may not have been completed/performed with errors. If all the steps were followed correctly but still an error, there may be a problem with VirGL, try an older version (for example 0.0.8, 0.0.7).

There is a possibility in Chinese caches you can install LibGL with VirGL, and the apk has an integrated VirGL Overlay, in this case you don’t need to install separate applications, just set it up as in the screenshot, and give permission to the ExaGear application "Over all applications" and from the "Start" menu along the way: Start->WineGL->VirGL Overlay (may differ) install LibGL with VirGL as well as Mesa 18-21(v3).

Additional parameters need to be registered in the .desktop file of the desktop shortcut. You need to write between the words <code>Exec=env and WINEPREFIX</code>, for example: <code>Exec=env VTEST_WIN=1 WINEPREFIX</code>.

<code>VTEST_SOCK=</code> - parameter required to run '''VirGL Overlay''' (deprecated, no longer needed in new versions of libGL,)

<code>VTEST_WIN=1</code> - rendering an overlay in the window (reduces performance, you need to check the box 'Use vtest protocol 2(new Mesa libGL needed, Mesa 18-21 v3 is needed)

<code>MESA_GL_VERSION_OVERRIDE=3.3</code>(up to 4.6) - Upgrade OpenGL version.

====The page is not finished====