App de TV de referência

Um app de TV que reproduz conteúdo ao vivo é necessário para algumas classes de dispositivos Android TV, como TVs de painel e decodificadores de operadoras. O código-fonte de um app de referência está disponível no Android Open Source Project.

Esta página resume como criar e personalizar um app de TV do sistema baseado em TV ao vivo para seu dispositivo de TV Android.

Dependências

O app de TV ao vivo é um componente do TV Input Framework (TIF) e não pode ser usado de forma independente dos outros componentes do TIF. Diferentes ramos do app têm dependências diferentes nos níveis da API do Android:

Filial Nível desejado da API Nível mínimo da API
main 24 (Android 7.0) 23
android-live-tv 23 (Android 6.0) 21
android-live-tv-l-mr1 22 (Android 5.1) 21

Acessar a fonte

Para começar, selecione uma versão de TV ao vivo no Git. As instruções a seguir são para a versão atual da TV ao vivo. Para usar uma versão anterior, mude para uma das ramificações do Git listadas na tabela anterior.

mkdir live-tv && cd live-tv
repo init -u https://android.googlesource.com/platform/manifest -b main
repo sync -j8 -c

Criar

Para criar o código da TV ao vivo, execute:

. build/envsetup.sh
tapas LiveTv x86
make LiveTv

Enviar por push

Use o código abaixo para enviar a TV ao vivo para o dispositivo de teste:

adb install -r -d $OUT/system/priv-app/LiveTv/LiveTv.apk

Se você quiser que o app de TV ao vivo tenha permissões do sistema, use o seguinte código para enviá-lo para /system/priv-app na primeira vez que você o instalar:

adb push $OUT/system/priv-app/LiveTv/LiveTv.apk  /system/priv-app/LiveTv/

Teste

Depois que o app TV ao vivo for instalado no dispositivo, teste se ele está integrado corretamente usando os testes abaixo, além do pacote de testes de compatibilidade e dos testes do verificador do CTS para o app de TV. Você precisa ter um dispositivo ou emulador conectado para executar todos os tipos de teste.

Testes de unidade

adb shell logcat -c
m LiveTv TVTestInput TVUnitTests -j20 &&\
adb install -r -d $OUT/system/priv-app/LiveTv/LiveTv.apk &&\
adb install -r -d $OUT/system/app/TVTestInput/TVTestInput.apk && \
adb install -r -d $OUT/data/app/TVUnitTests/TVUnitTests.apk && \
adb shell pm clear com.android.providers.tv && \
adb shell pm clear com.android.tv && \
adb shell am instrument \
  -e testSetupMode unit \
  -w com.android.tv.testinput/.instrument.TestSetupInstrumentation &&\
adb shell input keyevent KEYCODE_HOME &&\
adb shell am instrument \
  -w 'com.android.tv.tests/android.support.test.runner.AndroidJUnitRunner'

Testes funcionais

adb shell logcat -c
m LiveTv TVTestInput TVFuncTests -j20 &&\
adb install -r -d $OUT/system/priv-app/LiveTv/LiveTv.apk &&\
adb install -r -d $OUT/system/app/TVTestInput/TVTestInput.apk && \
adb install -r -d $OUT/data/app/TVFuncTests/TVFuncTests.apk && \
adb shell pm clear com.android.providers.tv && \
adb shell pm clear com.android.tv && \
adb shell am instrument \
  -e testSetupMode func \
  -w com.android.tv.testinput/.instrument.TestSetupInstrumentation &&\
adb shell input keyevent KEYCODE_HOME &&\
adb shell am instrument \
  -w 'com.android.tv.tests.ui/android.support.test.runner.AndroidJUnitRunner'

Testes de instabilidade

Os testes de instabilidade procuram frames perdidos e atrasos na renderização.

adb shell logcat -c
m LiveTv TVTestInput TVJankTests -j20 &&\
adb install -r -d $OUT/system/priv-app/LiveTv/LiveTv.apk &&\
adb install -r -d $OUT/system/app/TVTestInput/TVTestInput.apk &&\
adb install -r -d $OUT/data/app/TVJankTests/TVJankTests.apk &&\
adb shell pm clear com.android.providers.tv &&\
adb shell pm clear com.android.tv &&\
echo "Creating a lot of channels and EPG data, this may take a while" &&\
adb shell am instrument \
  -e testSetupMode jank \
  -w com.android.tv.testinput/.instrument.TestSetupInstrumentation &&\
adb shell input keyevent KEYCODE_HOME &&\
adb shell am instrument \
  -w 'com.android.tv.tests.jank/android.support.test.runner.AndroidJUnitRunner'