Streamit TV - Documentation

Android TV Emulator Requirement for Flutter 3.35+

Overview

Starting from Flutter 3.35+, support for Android TV x86 emulator images has been deprecated/removed. Applications built using newer Flutter versions (including the current project version) must be tested using x86_64-based Android TV or Google TV emulator images.

To ensure a stable development and testing experience, all developers should migrate their Android TV emulators to an x86_64 system image.


Why This Change Is Required

Legacy Android TV emulator images based on the x86 architecture are no longer supported by recent Flutter releases.

Using an unsupported emulator may lead to:

  • Application startup failures
  • Flutter engine initialization issues
  • Unexpected runtime behavior
  • Unsupported emulator warnings
  • Inconsistent testing results

Required Emulator Configuration

SettingRecommended Value
Device ProfileTelevision (1080p)
API LevelAndroid 16 (API 36) or later
ServicesGoogle APIs
ABIx86_64
System ImageAndroid TV Intel x86.64 Atom System Image

Emulator Setup Instructions

Step 1: Open Device Manager

1. Launch Android Studio
2. Navigate to Tools → Device Manager
3. Click Create Device

Step 2: Select TV Device

1. Choose Television (1080p) or another Android TV device profile.
2. Click Next.

Step 3: Select an x86_64 System Image

Choose one of the following supported system images:

Recommended

  • Android TV Intel x86.64 Atom System Image

Alternative

  • Google TV Intel x86.64 Atom System Image

Ensure that the ABI displayed in the details panel is x86_64.

Step 4: Create and Launch Emulator

1. Complete the emulator creation wizard.
2. Launch the newly created emulator.
3. Run the Flutter application normally.


    Supported vs Unsupported Images

    Supported

    • Android TV Intel x86.64 Atom System Image
    • Google TV Intel x86.64 Atom System Image

    Unsupported

    • Android TV Intel x86 Atom System Image
    • Google TV Intel x86 Atom System Image
    • Any Android TV emulator image using the x86 ABI

    Screenshot Reference

    Select an Android TV or Google TV system image that uses the x86_64 architecture. The recommended option is Android TV Intel x86.64 Atom System Image.