Files
documentation/products/go.md
2026-11-14 18:21:12 -08:00

4.2 KiB

Vyla Go (Android Mobile)

The native Android mobile client for the Vyla ecosystem, combining hardware-accelerated shaders, automated runtime management, and mobile streaming.

Vyla Go mobile streaming application interface

Overview

Vyla Go brings the power of the Vyla media ecosystem directly to Android smartphones and tablets. Built using Tauri v2 Mobile, Vyla Go delivers a fluid, responsive touch experience backed by native hardware acceleration and custom WebGL shaders.

Designed for mobile reliability on varying cellular and Wi-Fi networks, Vyla Go automatically coordinates local resource extraction, service fallbacks, and remote update fetching without requiring constant manual APK re-installations.


Downloads

Official APK packages are published on the Vyla Go GitLab Releases:

Package Target Architectures Compatibility Download Link
Universal APK arm64-v8a, armeabi-v7a, x86_64 Android 7.0+ (API 24+) Download Universal APK
ARM64 APK aarch64 Modern 64-bit Android Devices Download ARM64 APK

Key Features

  • Tauri v2 Mobile Architecture: Native Rust-backed Android application layer with secure Chromium WebView rendering.
  • Hardware-Accelerated WebGL Shaders: Real-time dynamic glassmorphism, responsive ambient backdrops, and fluid gesture navigation.
  • Automated Resource Management: Downloads and unpacks core service updates directly from official release channels, keeping scraper definitions up to date.
  • Low-Latency Mobile Playback: Supports HLS and direct stream resolution with adaptive mobile bitrate handling.

Building from Source

Prerequisites

Before compiling Vyla Go, ensure your development environment has:

  • Node.js: v20 or newer
  • Rust & Cargo: Latest stable toolchain
  • Android Studio: Android SDK & NDK (v29+)
  • Cross-Compilation Targets:
rustup target add aarch64-linux-android x86_64-linux-android

Build Commands

# 1. Install project dependencies
npm install

# 2. Package the runtime update payload
npm run build:payload

# 3. Compile the release APKs
npm run build:apk

The compiled release packages are output to:

src-tauri/gen/android/app/build/outputs/apk/universal/release/app-universal-release.apk

Developer & Debugging Guide (ADB)

The Vyla Go repository provides complete ADB integration for debugging, log collection, and direct device installation:

Streaming Device Logs

Monitor the application logs in real time via ADB:

# Stream live application logs tagged VylaGo
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" logcat -s VylaGo

# Clear the log buffer and stream fresh output
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" logcat -c
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" logcat -s VylaGo

Crash Diagnostics

Inspect unhandled exceptions, native SIGSEGV errors, and runtime failures:

& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" logcat -d | Select-String "VylaGo|AndroidRuntime|FATAL"

Direct Device Installation

Install your newly built APK directly to a connected USB or Wi-Fi debug device:

& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" install -r "src-tauri\gen\android\app\build\outputs\apk\universal\release\app-universal-release.apk"

Resetting App State

To completely terminate and purge cached app state:

& "$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

Fixing Emulator DNS Timeouts

When running Android emulators that fail to reach remote release endpoints:

& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" shell settings put global private_dns_mode off