mirror of
https://gitlab.com/vyla-entertainment/documentation.git
synced 2026-11-20 01:17:23 -05:00
fixed syntax issues
This commit is contained in:
@@ -2,105 +2,83 @@
|
||||
|
||||
<p class="page-description">The native Android mobile client for the Vyla ecosystem, combining hardware-accelerated shaders, automated runtime management, and mobile streaming.</p>
|
||||
|
||||
<img class="vyla-banner" src="/src/assets/images/android/site_preview.webp" alt="Vyla Go mobile streaming application interface" loading="lazy" decoding="async" fetchpriority="low" />
|
||||
<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 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.
|
||||
**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 APK packages are published on the [Vyla Go GitLab Releases](https://gitlab.com/vyla-entertainment/go/-/releases):
|
||||
Official APKs are available on [GitLab Releases](https://gitlab.com/vyla-entertainment/go/-/releases):
|
||||
|
||||
| Package | Target Architectures | Compatibility | Download Link |
|
||||
| :--- | :--- | :--- | :--- |
|
||||
| **Universal APK** | `arm64-v8a`, `armeabi-v7a`, `x86_64` | Android 7.0+ (API 24+) | [Download Universal APK](https://gitlab.com/vyla-entertainment/go/-/releases) |
|
||||
| **ARM64 APK** | `aarch64` | Modern 64-bit Android Devices | [Download ARM64 APK](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.
|
||||
|
||||
---
|
||||
|
||||
## 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.
|
||||
- **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
|
||||
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**:
|
||||
|
||||
- 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
|
||||
# 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:
|
||||
Output APK location:
|
||||
```
|
||||
src-tauri/gen/android/app/build/outputs/apk/universal/release/app-universal-release.apk
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Developer & Debugging Guide (ADB)
|
||||
## Debugging with 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 Logs
|
||||
```powershell
|
||||
# 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
|
||||
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
|
||||
Inspect unhandled exceptions, native SIGSEGV errors, and runtime failures:
|
||||
```powershell
|
||||
& "$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:
|
||||
### 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"
|
||||
```
|
||||
|
||||
### Resetting App State
|
||||
To completely terminate and purge cached app state:
|
||||
### 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
|
||||
```
|
||||
|
||||
### Fixing Emulator DNS Timeouts
|
||||
When running Android emulators that fail to reach remote release endpoints:
|
||||
```powershell
|
||||
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" shell settings put global private_dns_mode off
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user