安装与设置

本指南提供有关在您的系统上安装和运行 Sencha Architect 的说明。它还讨论了在完成和发布您的第一个项目之前需要的其他软件。

本指南还旨在为您提供一条清晰的路径，以避免与 Sencha Architect 安装相关的常见应用程序构建问题。了解各种依赖项以确保干净安装非常重要。

支持的操作系统

• Windows（包括 10 和 11）
• macOS（包括 Apple M1 和 M2）
• Linux（Ubuntu 20.04 和 22.04）

下载

如果您没有 Sencha Architect，您可以下载免费且完整的 30 天试用版。

• 下载 Sencha Architect.

所需依赖项

在运行安装程序之前，让我们看一下依赖项。Sencha Architect 需要以下项目

• Java 运行时环境 (JRE)

这是支持基于 Ext JS 5 及更低版本的项目所必需的。

我们还需要 Ruby，您可以从这里下载

• Ruby

Java 和 Ruby 必须通过命令行可用。安装程序将在安装这些工具时将它们添加到 PATH 系统变量中。

这些变量偶尔会丢失或完全无法添加。发生这种情况时，这些工具在命令行上不可用，Sencha Architect 也无法访问。正确设置这些路径非常重要。

Linux

如果您运行的是 Ubuntu 17+，您可能需要安装 libconfg-2.so.4 库。您可以通过运行以下命令来安装它

sudo apt-get install libgconf-2-4

设置系统变量

让我们看看如何在各种支持的操作系统上设置系统路径变量。

Windows

Windows 7

1. 从“开始”菜单中选择“计算机”。
2. 从菜单中选择“系统属性”。
3. 单击“高级系统设置”>“高级”选项卡。
4. 单击“环境变量”，在“系统变量”下，然后单击“PATH”。
5. 在“编辑”窗口中，通过将类的位置添加到 PATH 的值来修改 PATH。如果您没有 PATH 项，您可以选择添加新变量并将 PATH 作为名称，将类的位置作为值添加。
6. 关闭窗口并重新打开命令提示符窗口。

Windows 8

1. 将鼠标指针拖动到屏幕的右下角
2. 单击“搜索”图标并键入：控制面板
3. 单击“控制面板”>“系统”>“高级”
4. 单击“环境变量”，在“系统变量”下，然后单击“PATH”。
5. 在“编辑”窗口中，通过将类的位置添加到 PATH 的值来修改 PATH。如果您没有 PATH 项，您可以选择添加新变量并将 PATH 作为名称，将类的位置作为值添加。
6. 关闭窗口并重新打开命令提示符窗口。

Windows 10

1. 单击 Windows 徽标并键入：控制面板。
2. 单击“系统”>“高级系统设置”>“高级”选项卡。
3. 单击“环境变量”，在“系统变量”下，然后单击“PATH”。
4. 在“编辑”窗口中，通过将类的位置添加到 PATH 的值来修改 PATH。如果您没有 PATH 项，您可以选择添加新变量并将 PATH 作为名称，将类的位置作为值添加。
5. 关闭窗口并重新打开命令提示符窗口。

Mac OSX / Linux

1. 编辑 ~/ .bash_profile

2. 使用以下行修改 PATH 变量（使用工具的路径）

    export PATH=<PATH-TO-ADD-HERE>:$PATH
   

3. 保存，关闭文件，然后打开新的终端窗口

注意： .bash_profile 是一个隐藏文件。这些类型的文件默认在 Finder 中隐藏。要启用隐藏文件，请从命令行运行以下命令

defaults write com.apple.finder AppleShowAllFiles TRUE
killall Finder

依赖项安装

Java 运行时环境 (JRE)

首先，访问 Oracle 下载页面以获取 Java JRE 的副本。

Sencha Architect 需要 JRE 才能正确使用 Sencha Cmd。您将需要 Cmd 来生成有效的构建，因此必须正确安装 Java。

打开命令行工具以测试 Java 是否正确安装。

Mac OSX

Mac OSX 用户只需打开 终端。

Windows

Windows 用户可以通过从“开始”屏幕输入 cmd 来打开命令行。

一旦您的命令行可用，请发出以下命令。

java -version

如果安装正确，它应该输出版本信息，如下所示

>java -version
java version "1.8.0_40"
Java(TM) SE Runtime Environment (build 1.8.0_40-b27)
Java HotSpot(TM) 64-Bit Server VM (build 25.40-b25, mixed mode)

注意： 64 位 Sencha Architect 安装程序需要 64 位 JRE。

将 Java 添加到您的 PATH

Windows

为了将 Java 添加到您的 PATH，请将以下信息添加到您的系统变量中

variable name: 
JAVA_HOME
variable value: 
c:\Program Files\Java\jre1.8.0_91\

variable name: 
PATH
variable value: 
%PATH%;%JAVA_HOME%\bin\

Mac OSX / Linux

除非您有意更改了 Java 路径，否则 Java 很可能安装在此处

/Library/Java/JavaVirtualMachines/<java version>/. 

将以下行添加到您的 ~/.bash_profile 以将 Java 添加到您的 PATH

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jre1.8.0_91/Contents/Home
export PATH=$JAVA_HOME/bin:$PATH

有关更多信息，请参阅：http://java.com/en/download/help/path.xml

Ruby

当使用 Ext JS 5 及更低版本构建主题时，Sencha Architect 在应用程序构建过程中使用 Ruby。

Sencha Architect 适用于 Ruby 1.9 和 2.0。

要检查 Ruby 是否正确安装，请运行以下命令

> ruby -v

如果安装正确，它应该输出类似于此的版本信息

> ruby -v
ruby 2.0.0p451 (2014-02-24 revision 45167) [universal.x86_64-darwin13]

Windows

Windows 用户将必须下载 Ruby。如果尚未安装 Ruby，您可以在此处下载。

确保以管理员权限运行 Ruby 安装程序。要启用管理员权限，请右键单击安装程序可执行文件并选择“以管理员身份运行”。在安装过程中，您需要标记要求允许将 Ruby 添加到您的 PATH 变量的复选框。

Mac OSX / Linux

Ruby 会自动安装在 Mac OSX 机器上。无需进一步操作。

完成第三方依赖项

Sencha Architect 还使用 Sencha Cmd 和 Sencha 框架。您无需安装 Sencha Cmd 或框架，因为它们与 Architect 一起提供。当其他依赖项正确安装后，运行 Sencha Architect 安装程序。

对于 Windows 用户，最好以与依赖项相同的管理员权限安装 Sencha Architect，以便 Sencha Architect 可以访问它们。

Sencha Cmd

Sencha Cmd 封装了一组非常有用的工具。您不仅可以构建应用程序，还可以构建主题、生成代码或使用内置的 Web 服务器 (Jetty)。

Sencha Architect 需要 Sencha Cmd 才能正确构建应用程序。由于 Sencha Architect 在 Sencha Cmd 之上运行，因此它们打包在一起，因此无需进一步安装。

注意：在 CMD 安装过程中，请务必选择 Compass Extension 组件。

启用 Sencha Cmd

Sencha Cmd 也需要在 Sencha Architect 中启用。这应该在首次保存时默认完成。

通过导航到以下位置验证 Sencha Cmd 是否可以手动启用

    Edit > Project Settings > Framework.

应该注意的是，当构建工具被禁用时，CDN 将用于框架。路径在检查器中的“库”节点下的“库基本路径”上设置。这只应为禁用构建工具的项目设置。如果用户清除路径作为默认值，则将使用 CDN 路径。

Sencha 框架

Architect 会自动下载并安装您需要的 Sencha 框架。这意味着您无需手动安装 Ext JS。

但是，您可以通过指定“许可证”下的位置来切换到其他受支持的 Ext JS 旧版本

您可以在下面找到更详细的说明。

应用程序许可证

Sencha 为通过您选择的框架许可您的应用程序提供了不同的选项。有关更多信息，请参阅 Sencha 许可证和政策。

注意： 这指的是您的应用程序的框架许可，而不是 Sencha Architect 的许可。

要更改应用程序许可证

1. 单击“编辑”>“项目设置”>“框架”。

2. 单击“构建工具”>“已启用” - 如果您禁用“构建工具”，Architect 会假定您将处理构建应用程序并自行设置其许可证。通过启用“构建工具”，Architect 为每个许可证选择提供最佳软件。

3. 单击许可证选择

   • 商业版 (Commercial)：免费或购买的应用程序的 Architect 默认许可证
   • 完整版或自定义路径 (Complete or Custom Path)：用于 Sencha Complete Bundle

4. 单击“保存”。

注意： 对于 Sencha Complete，单击“Sencha Complete 或自定义路径”，然后单击“浏览”按钮以找到 Ext JS 框架目录。

默认情况下，Ext JS 框架由 Sencha Complete 安装程序安装在以下目录中。

在以下地址中是用户名，是 Complete，n.n.n 是版本号，build 是构建号。

Mac OS X：

/Users/<User>/bin/Sencha/<pkg>/ext-n.n.n.build

Windows 7+：

C:\Users\<User>\bin\Sencha\<pkg>\ext-n.n.n.build

Ubuntu：

/home/user/bin/Sencha/<pkg>/ext-n.n.n.build

创建项目目录

您在其中创建目录的目录的位置和名称因操作系统和 Web 服务器而异。如果您使用的是本地 Web 服务器，则需要将目录存储在 localhost 的 Web 可访问区域内的某个位置。例如 XAMPP 的 htdocs 目录或 Linux 的 /var/www/html。

如果您使用的是 Sencha Cmd Web 服务器，则可以使用任何目录作为项目目录。

首次保存项目后，Architect 会在同一位置为项目创建一个新目录。将任何其他项目资产存储在 Architect 创建的目录中。这包括数据和附加资源，例如图像。

配置 IIS 以服务 JSON 文件

如果您正在运行 IIS Web 服务器，请确保添加 application/x-json 作为 MIME 类型。IIS 需要 MIME 类型设置才能正确服务 JSON 文件。如果未设置此项，JSON 文件将在
预览您的项目时返回错误。

另请参阅

• 如何允许下载带有 ASP.NET 的 .json 文件
• 配置 IIS 6.0 的 MIME 类型
• 让 IIS6 为 Inc. POST,GET 提供 JSON 文件

故障排除

Sencha Cmd Compass 组件问题

概述

本文档解决了与 Sencha Cmd 中缺少 Compass 组件相关的问题，这会导致在各种操作期间出错，例如停止 App Watch 或在 Sencha Architect 中升级应用程序。

问题描述

当在 Sencha Architect 中执行某些操作（例如停止 App Watch 或升级应用程序）时，用户可能会遇到错误，这是因为他们的 Sencha Cmd 安装中缺少所需的 Compass 组件。

解决方案

要解决此问题，用户需要重新安装 Sencha Cmd 并确保在安装过程中选择了 Compass 组件。重新安装带有 Compass 组件的 Sencha Cmd 后，用户应重新启动 Sencha Architect。

分步说明

1. 卸载 Sencha Cmd（如果当前已安装）

   • 使用卸载程序卸载 sencha cmd

2. 下载最新版本的 Sencha Cmd

   • 访问 Sencha Cmd 试用下载页面以下载所需的版本。
   • 访问 Sencha Cmd 许可下载页面以下载所需的版本。

3. 安装带有 Compass 组件的 Sencha Cmd

   • 运行安装程序并按照安装提示进行操作。
   • 请确保在安装过程中选择 Compass 组件。

   

4. 重新启动 Sencha Architect

   • 在安装了包含 Compass 组件的 Sencha Cmd 后，请重新启动 Sencha Architect，以确保更改生效。

Linux 22 或更高版本

安装

如果在 Ubuntu 操作系统安装期间 GPU 驱动程序未正确更新，可能会发生 GPU 错误，从而阻止 Sencha Architect 启动。要永久解决此问题，您需要重新安装操作系统并使用正确的 GPU 驱动程序。但是，作为临时解决方法，您可以使用以下命令安装 Sencha Architect

    ./installer_name.sh --disable-gpu-sandbox

运行 Sencha Architect

要启动 Sencha Architect，请使用以下命令

    ./Sencha\ Architect --disable-gpu-sandbox

如果您在使用沙盒时遇到任何问题，请使用以下命令运行 Sencha Architect

    ./Sencha\ Architect --no-sandbox

后续步骤

安装软件后，请继续进行

• 构建您的第一个桌面应用程序
• 构建您的第一个移动应用程序

现在您知道如何设置 Sencha Architect 以及处理其所有依赖项。我们希望这能帮助您快速入门，以便您可以直接开始构建。如果您想了解更多关于 Sencha 工具和框架的信息，您可以参加我们的 Sencha 培训课程之一，或者查看我们的 论坛 以获取大量有用的信息。