This commit is contained in:
2026-11-15 17:34:41 -08:00
parent bc7c89b528
commit 46152a464d
37 changed files with 1413 additions and 3919 deletions

View File

@@ -1,84 +1,25 @@
# Vyla Go (Android Mobile)
<p class="page-description">The native Android mobile client for the Vyla ecosystem, combining hardware-accelerated shaders, automated runtime management, and mobile streaming.</p>
<p class="page-description">Smooth mobile streaming player for Android phones and tablets.</p>
<img class="vyla-banner" src="/src/assets/images/android/site_preview.webp" alt="Vyla Go mobile application" loading="lazy" decoding="async" fetchpriority="low" />
## Overview
**Vyla Go** brings the Vyla media ecosystem to Android phones and tablets. Built with **Tauri v2 Mobile**, Vyla Go delivers a responsive touch interface with WebGL hardware shaders and background playback support.
---
## Downloads
Official APKs are available on [GitLab Releases](https://gitlab.com/vyla-entertainment/go/-/releases):
Official APK packages are available directly on [GitLab Releases](https://gitlab.com/vyla-entertainment/go/-/releases):
- **[Universal APK](https://gitlab.com/vyla-entertainment/go/-/releases)**: Supports `arm64-v8a`, `armeabi-v7a`, and `x86_64` on Android 7.0+ (API 24+).
- **[ARM64 APK](https://gitlab.com/vyla-entertainment/go/-/releases)**: Optimized for modern 64-bit Android devices.
- **[Universal APK](https://gitlab.com/vyla-entertainment/go/-/releases)**: Recommended for most Android phones and tablets (supports `arm64-v8a`, `armeabi-v7a`, and `x86_64` on Android 7.0+).
- **[ARM64 APK](https://gitlab.com/vyla-entertainment/go/-/releases)**: Smaller download optimized specifically for modern 64-bit devices.
---
## Key Features
## Installation
- **Tauri v2 Mobile**: Native Rust Android layer with secure Chromium WebView rendering.
- **WebGL Hardware Shaders**: Dynamic backdrops and smooth gesture animations.
- **Automated Resource Updates**: Fetches and applies runtime payload updates directly from release channels without requiring full APK reinstalls for minor script updates.
- **Low-Latency Streaming**: Adaptive mobile bitrate switching with background audio playback.
---
## Building from Source
### Prerequisites
- Node.js 20+
- Rust & Cargo
- Android Studio with Android SDK & NDK (API 29+)
Add cross-compilation targets:
```bash
rustup target add aarch64-linux-android x86_64-linux-android
```
### Build Commands
```bash
npm install
npm run build:payload
npm run build:apk
```
Output APK location:
```
src-tauri/gen/android/app/build/outputs/apk/universal/release/app-universal-release.apk
```
---
## Debugging with ADB
### Stream Logs
```powershell
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" logcat -s VylaGo
```
Clear and re-stream:
```powershell
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" logcat -c
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" logcat -s VylaGo
```
### Crash Diagnostics
```powershell
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" logcat -d | Select-String "VylaGo|AndroidRuntime|FATAL"
```
### Install to Connected Device
```powershell
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" install -r "src-tauri\gen\android\app\build\outputs\apk\universal\release\app-universal-release.apk"
```
### Reset App State
```powershell
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" shell am force-stop com.vyla.go
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" shell pm clear com.vyla.go
```
1. Download the latest `.apk` file using your Android browser from GitLab Releases.
2. Tap the completed download notification or open your **Files** / **Downloads** app.
3. If prompted with *“For your security, your phone is not allowed to install unknown apps from this source”*:
- Tap **Settings** in the dialog.
- Turn on **Allow from this source**.
- Tap the back button to return to the installer.
4. Tap **Install** and wait a moment for installation to complete.
5. Tap **Open** to start enjoying Vyla Go.