CASTOVIA icon
CASTOVIA

Studio App Build Guide

How to build provider-branded Android TV and Android Mobile apps using Castovia Studio.

What Studio Includes

Android TV

App foundation for Android TV devices. Provider-branded from Castovia\u2019s existing app base.

Android Mobile

App foundation for Android phones and tablets. Provider-branded from Castovia\u2019s existing app base.

Important Clarifications

  • Apps are generated from Castovia\u2019s existing app base \u2014 not custom-built from zero.
  • iOS and Apple TV are NOT included. They require separate commissioning.
  • App store approval is NOT guaranteed by Castovia.
  • Google Play developer accounts remain the provider\u2019s responsibility.
  • Release signing remains the provider\u2019s responsibility unless separately contracted.

Step-by-Step Build Process

  1. 1Configure App Branding in Castovia admin → App Branding.
  2. 2Set app name, slug, primary/accent colors, logos, icons, and splash screen.
  3. 3Download the Android TV config JSON from the branding page.
  4. 4Download the Android Mobile config JSON from the branding page.
  5. 5Place config JSON files in the correct app project folder.
  6. 6Open the app project (apps/android) in Android Studio.
  7. 7Run Gradle sync to resolve dependencies.

Build Debug APKs

Android TV:

./gradlew :tv:assembleDebug

Android Mobile:

./gradlew :mobile:assembleDebug

Install & Test

  1. 9 Install debug APK on test device: adb install path/to/app-debug.apk
  2. 10 Test login, pairing, playback, and navigation.
  3. 11 Prepare release signing keys (provider responsibility).
  4. 12 Submit via provider\u2019s own Google Play developer account.

Security

  • No signing keys stored in Castovia unless a safe feature exists.
  • No CDN/DRM secrets in app config JSON.
  • No sourceUrl in app config JSON.
  • App receives only safe playback metadata from Castovia API.