2、开发环境搭建:Android Studio配置、TV模拟器创建、SDK Manager设置

说实话,很多做TV开发的朋友,第一步就栽在了环境搭建上。不是SDK版本不对,就是模拟器跑不起来。我当年刚接触Android TV开发时,光配环境就折腾了两天。后来带团队时发现,新人几乎都会踩同样的坑。

这节课,我就把那些坑一个个给你指出来。咱们从零开始,把开发环境搭得稳稳当当的。

2.1 Android Studio的版本选择与安装

先说版本。我个人习惯用最新稳定版,但有个前提——别追最新预览版。预览版可能有兼容性问题,你想想看,要是IDE本身有bug,排查起来多头疼。

目前推荐Android Studio Hedgehog(2023.1.1)或更高版本。下载地址就是官方那个:developer.android.com/studio。安装时注意几点:

  • 安装路径不要有中文——这老生常谈了,但总有人犯
  • 勾选Android Virtual Device——后面创建模拟器要用
  • SDK路径建议单独设置——别用默认的C盘,我习惯放D:\Android\SDK
小技巧:安装完成后,先别急着创建项目。打开Settings → Appearance & Behavior → System Settings → Android SDK,确认SDK Platforms里至少勾选了Android 12(API 31)和Android 14(API 34)。TV应用通常需要较高的API level。

2.2 SDK Manager的核心配置

SDK Manager是环境搭建的重头戏。说白了,它就是Android SDK的管家,管着各种版本的工具和平台。

打开方式:Tools → SDK Manager,或者工具栏上的小图标。进去后看三个Tab:

Tab名称 必须勾选的内容 说明
SDK Platforms Android 12 (API 31)
Android 13 (API 33)
Android 14 (API 34)
TV设备通常系统版本较新,API 31起步比较稳妥
SDK Tools Android SDK Build-Tools 34+
Android Emulator
Android SDK Platform-Tools
Emulator必须装,不然没法跑模拟器
SDK Update Sites 保持默认即可 除非你用了国内镜像,否则别乱改
注意:我曾经遇到过一个问题——SDK Tools里有个叫"Intel x86 Emulator Accelerator (HAXM installer)"的组件。如果你用的是AMD处理器,千万别装这个!装了反而会让模拟器启动失败。AMD用户请装"Windows Hypervisor Platform"(WHPX)。

2.3 TV模拟器的创建与配置

创建TV模拟器和手机模拟器流程差不多,但有几个关键区别。我一步步带你走:

  1. 打开AVD Manager(工具栏那个手机图标)
  2. 点击"Create Virtual Device"
  3. 在Category里选择"TV"
  4. 你会看到两个选项:Android TV (1080p)Android TV (4K)

选哪个?我个人建议:

  • 开发调试用1080p——启动快,资源占用少
  • 做UI适配测试时用4K——检查布局在大屏上的表现

选完设备后,下一步选系统镜像。这里有个坑:

重要:TV模拟器必须选带有"Google APIs"或"Google Play"的镜像。纯AOSP镜像没有TV相关的Google服务,很多功能跑不起来。

我推荐选API 34的"Android TV (Google APIs)"镜像。API level够新,兼容性好。

配置完硬件和镜像后,还有几个参数要调:

  • RAM:建议2GB以上,TV应用比手机应用吃内存
  • VM heap:512MB起步
  • Internal Storage:8GB够用,但建议16GB

嗯,这里要注意——别忘了勾选"Enable Device Frame"。虽然模拟器没有实体边框,但勾上后窗口大小更接近真实电视。

2.4 知识体系总览

下面这张图,把整个环境搭建的脉络理清楚了。你照着这个顺序走,基本不会出错:

TV开发环境搭建流程 1. 安装Android Studio 选择稳定版,配置SDK路径 2. SDK Manager配置 勾选API 31/33/34 3. 创建TV模拟器 选TV分类+Google APIs 关键决策点 CPU类型 Intel → 装HAXM AMD → 装WHPX 模拟器分辨率 1080p → 日常开发调试 4K → UI适配测试 ✅ 可运行的TV开发环境

2.5 验证环境是否搭好了

环境搭完,总得验证一下能不能用。我的做法是:

  1. 启动模拟器——等它完全开机(第一次启动会比较慢)
  2. 打开命令行,输入 adb devices——能看到设备列表就对了
  3. 创建一个空的TV项目,跑一下看看

这里有个小细节:TV模拟器默认是横屏的,而且没有返回键和Home键。你需要用键盘操作:

  • 方向键——移动焦点
  • Enter——确认
  • Esc——返回
  • Ctrl + Shift + H——回到桌面

如果你发现模拟器启动后黑屏,别慌。八成是显卡驱动问题。试试在AVD设置里把"Graphics"从"Automatic"改成"Software"。虽然性能差点,但至少能跑起来。

避坑指南:我曾经遇到模拟器启动后画面撕裂,折腾了半天发现是Hyper-V没关。如果你用的是Windows,记得检查一下:控制面板 → 程序和功能 → 启用或关闭Windows功能 → 确保Hyper-V是关闭状态(除非你用WHPX)。

2.6 小结

环境搭建这事儿,说白了就是一次配置,长期受益。你花半小时把SDK版本、模拟器参数都调对了,后面开发能省下大把时间。

我个人习惯是把SDK Manager的截图保存一份,换电脑时照着配,省得漏掉什么组件。你也试试看?


公众号:蓝海资料掘金营,微信deep3321