开发者控制台
登录
登录
开发者控制台

下载Fire App Builder并构建应用

下载Fire App Builder并构建应用

 I： 开始设置

步骤1：
下载并构建示例应用
→
步骤2：
通过adb连接
→
步骤3：
浏览应用
→
步骤4：
尝试Alexa集成
→
步骤5：
自定义示例项目

要使用Fire App Builder进行设置，请从GitHub下载项目，确保安装了Java JDK和Android Studio，然后打开示例“Application”目录。

步骤A： 下载Fire App Builder

由于Git中的符号链接默认值在Mac和Windows之间有所不同，以下的说明将因平台而异。

Mac

如果您使用的是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

如果您使用的是Windows，在克隆Fire App Builder存储库之前，在您的Git设置中将符号链接设置为true。否则，您可能会在构建项目时遇到问题。

  1. 检查您是否拥有计算机的管理员权限（转到开始 > 控制面板 > 用户账户 > 管理用户账户）。如果您没有管理员权限也没有关系。您可以在以后运行脚本来修复任何问题。

  2. 如果您确实具有管理权限，请以管理员身份打开命令行终端并运行以下命令，将Git配置为允许符号链接：

    git config -–global core.symlinks true

    当您运行这个命令时，将把Git配置设置为启用符号链接。在Git克隆期间，所有Linux符号链接都将转换为Windows符号链接。

  3. 请使用以下选项之一下载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
  4. 如果您在克隆或下载存储库之前没有运行git config –global core.symlinks true所需的管理权限，请运行在没有管理员权限的情况下为Windows配置符号链接中介绍的脚本。

步骤B：设置JDK

您需要Oracle提供的1.8版本的Java开发工具包 (JDK) 或更高版本。JDK用于在您的计算机上编译Java应用。首先检查您是否已经拥有JDK。

  1. 打开终端或命令提示符。

  2. 键入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。

  3. 如果您没有JDK，请从Java SE开发工具包下载中下载适用于您计算机的JDK安装程序版本并运行。有关更多详细信息，请参阅以下内容：

步骤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”项目并构建应用：

  1. 启动Android Studio。

  2. 在Welcome（欢迎）屏幕中，单击Open an existing Android Studio project（打开现有Android Studio项目）。

    如果您没有看到这个包含这些特定选项的欢迎屏幕，那么您可能没有为Android Studio配置JDK或任何Android SDK。

  3. 浏览到您下载fire-app-builder GitHub项目的目录。在Fire App Builder项目文件夹中，选择Application文件夹，然后单击Open（打开）。

    Gradle开始构建该项目。

    系统可能会提示您更新Gradle，具体视最新版本的Gradle而定。如果出现提示，请单击Don't remind me again for this project（不要再就此项目提醒我）。

    如果Android Studio缺少任何所需的库或文件，您可能会看到如下所示的消息：

    或者您可能会在Gradle控制台中看到如下所示的消息：

    或者看到以下消息：

    如果您看到这些消息，请单击这些链接来安装缺失的工具。只需继续打开项目并按照提示安装任何缺失的工具即可，直到Android Studio不再发出错误消息为止。

    如果遇到构建失败的情况，可以尝试清理和重建项目（Build [构建] > Clean Project [清理项目]，或Build [构建] > Rebuild Project [重建项目]）。

  4. 单击Android Studio页脚中的Build按钮打开Gradle控制台，这样您就可以监控Gradle构建的进度。这样您将知晓构建是否成功或者Android Studio是否需要其他下载。等到Gradle完成构建。

    构建完成后，您应该会在Gradle控制台中看到一条消息，内容为Gradle build finished（Gradle构建已完成）。在Gradle完成项目构建后，Android Studio将在Android视图中显示以下目录：

    Android Studio目录

    当Android打开项目时，默认情况下会显示Android视图（在之前的屏幕截图中以红色圈出），并且“Application”文件夹简称为“app”。 Android视图会展平项目的文件，并将以更实用的排列方式显示最常用的文件，但文件的实际结构在您的计算机硬盘上有所不同。（Project [项目] 视图将向您显示所有文件夹和文件的实际排列方式。）

构建问题故障排除

如果您尝试构建项目，但收到以下错误消息：

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: 2022年1月4日