下载Fire App Builder并构建应用
要完成Fire App Builder的设置，请先从GitHub下载项目。确保您已安装Java开发工具包 (JDK) 和Android Studio。然后打开示例“Application”（应用程序）目录。
- 步骤A： 下载Fire App Builder
- 步骤B：设置JDK
- 步骤C： 安装Android Studio以及必要的工具和SDK
- 步骤D： 在Android Studio中打开示例应用
- 构建问题故障排除
- 后续步骤
步骤A： 下载Fire App Builder
由于Git中的符号链接默认值在Mac和Windows之间有所不同，以下的说明将因操作系统而异。
如果您使用的是Mac或Linux，请使用以下选项之一下载Fire App Builder的代码。
-
以zip文件形式下载代码。前往https://github.com/amzn/fire-app-builder然后单击Code（代码）> Download ZIP（下载ZIP）。
或者
-
使用命令提示符克隆存储库。在命令提示符处，浏览到所需的目录，然后运行
git clone命令下载文件：git clone https://github.com/amzn/fire-app-builder.git
如果您使用的是Windows，在克隆Fire App Builder存储库之前，在您的Git设置中将符号链接设置为true。否则，您可能会在构建项目时遇到问题。
- 检查您是否拥有计算机的管理员权限（转到开始 > 控制面板 > 用户账户 > 管理用户账户）。如果您没有管理员权限也没有关系。您可以在以后运行脚本来修复任何问题。
-
配置git以允许符号链接。如果您拥有管理权限，请以管理员身份打开命令提示符并运行以下命令：
git config -–global core.symlinks true运行此命令会将git config设置为启用符号链接。在Git克隆期间，所有Linux符号链接都会转换为Windows符号链接。
- 请使用以下选项之一下载Fire App Builder的代码。
-
以zip文件形式下载代码。前往https://github.com/amzn/fire-app-builder然后单击Code（代码）> Download ZIP（下载ZIP）。
或者
-
使用命令提示符克隆存储库。在命令提示符处，浏览到所需的目录，然后运行
git clone命令下载文件：git clone https://github.com/amzn/fire-app-builder.git
-
- 如果您没有运行
git config –global core.symlinks true所需的管理权限，请运行在没有管理员权限的情况下为Windows配置符号链接中介绍的脚本。
步骤B：设置JDK
您需要Oracle提供的1.8版本的JDK或更高版本。您将使用JDK在您的计算机上编译Java应用。首先检查您是否已经拥有JDK。
- 打开命令提示符。
-
键入
java -version。如果您有JDK，响应应该如下所示：java version "1.8.0_121" Java(TM) SE Runtime Environment (build 1.8.0_121-b13) Java HotSpot(TM) 64-Bit Server VM (build 25.121-b13, mixed mode在Windows上，您也可以手动查看
C:\Program Files\Java\jdk1.8.0\之类的目录，确定是否存在JDK。 -
如果您没有JDK，请从Java SE开发工具包下载中下载适用于您计算机的JDK安装程序版本并运行。有关更多详细信息，请参阅以下内容：
- Mac： 适用于OS X的10 JDK 8安装
- Windows： 适用于Microsoft Windows的JDK安装。（具体而言，请参阅“运行JDK安装程序”和“更新PATH环境变量”。）
- 有关其他操作系统和信息，请参阅JDK 8和JRE 8安装从此处开始。
步骤C： 安装Android Studio以及必要的工具和SDK
要使用Fire App Builder，您必须安装Android Studio，即Android项目的官方IDE。
有关在计算机上设置Android Studio开发环境的信息，请参阅Android Studio入门和安装Android Studio。
Fire App Builder要求您在Android Studio中安装特定SDK工具和API。无需提前从独立SDK Manager中选择这些工具。当您打开Fire App Builder项目（如下一部分打开示例应用中所述）时，Android Studio将提示您安装任何缺失的构建工具或API。
步骤D： 在Android Studio中打开示例应用
在Android Studio中打开Fire App Builder中的“Application”项目并构建应用：
- 启动Android Studio。
-
在Welcome（欢迎）屏幕中，单击Open an existing Android Studio project（打开现有Android Studio项目）。
如果您没有看到这个包含这些特定选项的欢迎屏幕，那么您可能没有为Android Studio配置JDK或任何Android SDK。
-
浏览到您下载fire-app-builder GitHub项目的目录。在Fire App Builder项目文件夹中，选择Application文件夹，然后单击Open（打开）。
Gradle开始构建该项目。
系统可能会提示您更新Gradle，具体视最新版本的Gradle而定。如果出现提示，请单击Don't remind me again for this project（不要再就此项目提醒我）。
注意： 首次打开项目时，Gradle构建项目可能需要20到40分钟。构建时间取决于Gradle必须下载的资产，以及您的网速和处理器速度。后续应当会花费大约一分钟或更短的时间。在等待时，可考虑浏览应用以熟悉该应用。也可考虑探索Fire TV设备上的Settings（设置）选项。如果Android Studio缺少任何所需的库或文件，您可能会看到如下所示的消息：
或者您可能会在Gradle控制台中看到如下所示的消息：
或是以下消息：
如果您看到这些消息，请单击这些链接来安装缺失的工具。继续打开项目并按照提示安装任何缺失的工具，直到Android Studio不再发出错误消息为止。
如果遇到构建失败的情况，可以尝试清理和重建项目（Build [构建] > Clean Project [清理项目]，或Build [构建] > Rebuild Project [重建项目]）。
-
单击Android Studio页脚中的Build按钮打开Gradle控制台，这样您就可以监控Gradle构建的进度。控制台会告知您构建是否成功或者Android Studio是否需要其他下载。等到Gradle完成构建。
构建完成后，您应该会在Gradle控制台中看到一条消息，内容为
Gradle build finished（Gradle构建已完成）。在Gradle完成项目构建后，Android Studio会在Android视图中显示以下目录：
当Android打开项目时，默认情况下会显示Android视图（在之前的屏幕截图中以红色圈出）。“Application”（应用程序）文件夹简称为“app”（应用） Android视图会展平项目的文件，并以更实用的排列方式显示最常用的文件。但是，文件的实际结构在您的计算机硬盘上有所不同。（Project [项目] 视图会向您显示所有文件夹和文件的实际排列方式。）
注意： 除非另有说明，否则本文档指的是使用Android视图时的文件位置。此外，本文档上次审阅时使用的是Android Studio 3.1.2。Android Studio在不断发展，因此在参考Android Studio时可能会出现一些偏差。
构建问题故障排除
如果您尝试构建项目，但收到以下错误消息：
Error: Content is not allowed in prolog（错误：导言中不允许包含内容）
此错误与Windows有关。当您克隆Github存储库时，Git没有将符号链接配置为true。结果，某些XML文件使用的符号链接没有以正确的内容复制下来。
要修复此问题，您必须将Git配置为允许使用符号链接：
git config –global core.symlinks true
然后重新克隆存储库并再次构建项目。您可以通过查看Utils > src > main > res > values > strings.xml > strings.xml (en-rUS) 中的strings.xml文件来验证符号链接是否有效。如果您看到正常内容，则表示符号链接有效。相反，如果只有一个简短的参考而没有其他内容，则符号链接无效。
如果您没有配置符号链接的权限，请参阅在在没有管理员权限的情况下为Windows配置符号链接。
后续步骤
转到下一步，通过ADB连接到Fire TV。在此步骤中，您将连接到Fire TV设备并在该设备上运行应用。
Last updated: 2025年4月7日
