文档帮助

术语、图标和标签

许多类都有快捷名称,用于在使用配置对象创建(实例化)类时。快捷名称被称为 别名(如果类扩展了 Ext.Component,则称为 xtype)。别名/xtype 列在适用类的类名旁边,以便快速参考。

访问级别

框架类或其成员可以指定为 privateprotected。否则,类/成员为 publicPublicprotectedprivate 是访问描述符,用于传达类或类成员应该如何以及何时使用。

成员类型

成员语法

下面是一个类成员示例,我们可以对其进行剖析以展示类成员的语法(在本例中是从 Ext.button.Button 类查看的 lookupComponent 方法)。

lookupComponent ( item ) : Ext.Component
受保护 (protected)

当原始配置对象添加到此容器时调用,无论是在初始化 items 配置期间,还是在添加新项目 added) 或 {@link #insert 插入 时。

此方法将传递的对象转换为实例化的子组件。

当需要对子组件创建应用特殊处理时,可以在子类中覆盖此方法。

参数 (Parameters)

item :  Object

要添加的配置对象。

返回值 (Returns)
Ext.Component

要添加的组件。

让我们看一下成员行的每个部分

成员标志

API 文档使用许多标志来进一步传达类成员的功能和意图。标签可以用文本标签、缩写或图标表示。

类图标

- 表示框架类

- 单例框架类。*有关更多信息,请参阅单例标志

- 组件类型框架类(Ext JS 框架中扩展 Ext.Component 的任何类)

- 表示类、成员或指南在当前查看的版本中是新的

成员图标

- 表示 config 类型的类成员

- 表示 property 类型的类成员

- 表示 method 类型的类成员

- 表示 event 类型的类成员

- 表示 theme variable 类型的类成员

- 表示 theme mixin 类型的类成员

- 表示类、成员或指南在当前查看的版本中是新的

类成员快速导航菜单

在 API 文档页面上的类名正下方是一行按钮,对应于当前类拥有的成员类型。每个按钮显示按类型划分的成员计数(此计数会随着过滤器的应用而更新)。单击按钮将导航到该成员部分。将鼠标悬停在成员类型按钮上将显示该类型的所有成员的弹出菜单,以便快速导航。

Getter 和 Setter 方法

与类配置选项相关的 getter 和 setter 方法将显示在方法部分以及 API 文档和成员类型菜单的配置部分中,就在它们所作用的配置下方。getter 和 setter 方法文档将在配置行中找到,以便于参考。

历史记录栏

您的页面历史记录保存在本地存储中,并显示在顶部标题栏正下方(使用可用的实际空间)。默认情况下,仅显示与您当前查看的产品/版本匹配的搜索结果。您可以通过单击历史记录栏右侧的 按钮并选择“全部”单选按钮来扩展显示的内容。这将显示所有产品/版本在历史记录栏中的所有最近页面。

在历史记录配置菜单中,您还将看到最近访问页面的列表。结果按“当前产品/版本”和“全部”单选按钮过滤。单击 按钮将清除历史记录栏以及本地存储中保存的历史记录。

如果在历史记录配置菜单中选择“全部”,则将启用“在历史记录栏中显示产品详细信息”复选框选项。选中后,每个历史页面的产品/版本将与页面名称一起显示在历史记录栏中。将光标悬停在历史记录栏中的页面名称上也会将产品/版本显示为工具提示。

搜索和过滤器

可以使用页面顶部的搜索字段搜索 API 文档和指南。

在 API 文档页面上,还有一个过滤器输入字段,该字段使用过滤器字符串过滤成员行。除了按字符串过滤外,您还可以按访问级别、继承和只读过滤类成员。这可以通过使用页面顶部的复选框来完成。

API 类导航树底部的复选框过滤类列表以包含或排除私有类。

单击空的搜索字段将显示您最近的 10 次搜索,以便快速导航。

API 文档类元数据

每个 API 文档页面(JavaScript 原始类型页面除外)都有一个菜单视图,显示与该类相关的元数据。此元数据视图将具有以下一项或多项

展开和折叠示例和类成员

可运行的示例 (Fiddles) 默认在页面上展开。您可以使用代码块左上角的箭头单独折叠和展开示例代码块。您还可以使用页面右上角的切换按钮切换所有示例的折叠状态。切换所有状态将在页面加载之间记住。

类成员默认在页面上折叠。您可以使用成员行左侧的箭头图标或右上角的展开/折叠所有切换按钮全局展开和折叠成员。

桌面视图 vs 移动视图

在较窄的屏幕或浏览器上查看文档将导致针对较小外形尺寸优化的视图。桌面视图和“移动”视图之间的主要区别在于

查看类源代码

可以通过单击 API 文档页面顶部的类名称来查看类源代码。可以通过单击成员行右侧的“查看源代码”链接来查看类成员的源代码。

Architect 4.3


顶部

使用 Windows 8.x/10 构建原生 Android 应用

本指南旨在引导用户完成准备 Windows 8/8.1/10 以使用 Sencha Architect 构建原生 Android 应用的过程。本指南侧重于 Sencha Architect 的环境设置,但这些步骤对于构建没有 Architect 的原生现代应用程序也是必要的。

注意: 本指南适用于全新的 Windows 8 机器。如果您只是更新软件,则其中一些步骤可能是不必要的。

JAVA

我们要做的第一件事是确保安装了 JAVA JDK 1.7+,并在您的 JAVA_HOME 环境变量中正确映射。

让我们开始下载 JAVA JDK 1.8 (Java SE 1.8)。

  1. 单击“Java 平台,标准版”部分中 JDK 下的“下载”按钮。

  2. 此时,您需要选中“接受许可协议”单选按钮,然后单击相应的下载链接。Windows x86 适用于 32 位机器,而 Windows x64 适用于 64 位机器。

  3. 当显示保存警报时,按“运行”。

  4. 下载完成后,通过单击结果弹出窗口上的“是”来允许 Java 对您的机器进行更改。

  5. 单击“下一步”直到安装程序开始解压缩。解压缩后,您应该可以更改安装目录。确保您将目录更改为指向 C 盘的根目录。在 C:\Java\ 创建一个文件夹并将您的安装指向那里。

  6. 如果您被询问要将“jre7”安装在哪里,请确保您指定了另一个文件夹。如果未验证位置,JRE 已知会覆盖 JDK,这会在稍后导致重大问题。

  7. 通过从命令提示符发出以下命令来验证您的 JAVA 安装和版本

    java -version

您应该看到

java version 1.8.0_xx

JAVA_HOME 和路径变量

接下来,您需要修改 JAVA_HOME 环境变量。JAVA_HOME 需要指向您在上面设置的安装位置。

您可以通过执行以下步骤在 Windows 8/10 中设置环境变量

  1. 右键单击左下角的 Windows 按钮
  2. 单击系统 -> 高级系统设置(磁贴视图)
  3. 单击“高级”选项卡
  4. 单击窗口右下角的“环境变量”。

现在您已进入环境变量,让我们继续添加 JAVA_HOME。

  1. 单击“系统变量”下的“新建”按钮
  2. 输入“JAVA_HOME”作为变量名称,输入“C:\Java”作为变量值。
  3. 单击“确定”

接下来,让我们将 Java 的路径添加到系统的 Path 变量中

  1. 在“系统变量”下找到“Path”
  2. 单击编辑(在 Windows 10 上,您还必须单击“编辑文本”)并在当前变量值的末尾添加“;%JAVA_HOME%\bin”。请注意,路径由“;”分隔。添加新变量时,您始终需要使用分号。
  3. 单击“确定”接受更改,然后再次单击“确定”保存

注意: 请记住,此选项仅影响新的命令提示符窗口,而不影响现有的窗口。关闭以前打开的任何窗口以确保安装。此特定安装可能需要重新启动才能使所有更改生效。

Apache Ant

接下来,让我们继续进行 Apache Ant。如果您尚未安装 Apache Ant,您可以在 此处 找到二进制文件。

选择您首选的压缩格式。在本示例中,我下载了 .zip 存档,可在“Ant 当前版本”下找到。

单击链接后,单击“保存”并下载文件。虽然 Ant 可以放置在您机器上的任何位置,但我喜欢将此软件保存在 C:\ 目录中。

Windows 没有 Ant 安装程序。只需将内容解压缩到 C:\Ant。

ANT_HOME 和路径变量

一旦 Ant 就位,您就可以设置 ANT_HOME 环境变量。与 JAVA_HOME 环境变量不同,ANT_HOME 变量直接映射到 ant 目录的根目录。

像我们之前所做的那样打开您的环境设置,然后按照以下步骤操作

  1. 单击“系统变量”下的“新建”按钮
  2. 输入“ANT_HOME”作为变量名称,输入“C:\Ant”作为变量值。
  3. 单击“确定”

接下来,让我们将 Ant 的路径添加到系统的 Path 变量中

  1. 在“系统变量”下找到“Path”
  2. 单击编辑(在 Windows 10 上,您还必须单击“编辑文本”)并在当前变量值的末尾添加“;%ANT_HOME%\bin”。
  3. 单击“确定”接受更改,然后再次单击“确定”保存

您可以通过在命令提示符中发出以下命令来验证 Ant 是否已正确安装

ant -v

它应该返回

Apache Ant(™) version {version} compiled on {date}

注意: 请记住,此选项仅影响新的命令提示符窗口,而不影响现有的窗口。关闭以前打开的任何窗口以确保安装。

Ruby

接下来,让我们继续进行 Ruby。Ruby 最容易通过使用此 安装程序 安装。

下载最新的版本安装程序(在编写本文时为 Ruby 2.0.0-p481)。
运行安装程序,您应该会看到一个“选项”页面。

将您的 Ruby 安装路径设置为 C:\Ruby,然后确保选中标记为“将 Ruby 可执行文件添加到您的 PATH”的框。

这将自动化我们到目前为止手动执行的步骤。

通过打开一个新的命令提示符并键入来确保安装完成

ruby -v

它应该返回类似这样的内容

ruby 2.0.0p481 {build-date} {bit version}

注意: 请记住,此选项仅影响新的命令提示符窗口,而不影响现有的窗口。关闭以前打开的任何窗口以确保安装。

Android SDK

接下来,我们将需要 Android SDK。您可以通过访问 Android SDK 站点 下载它。

  1. 单击“其他下载选项”,然后在“仅 SDK 工具”下选择推荐的 .exe 文件。

  2. 同意条款和条件并下载您的文件。

  3. 运行可执行文件。首先,它将验证 Java 安装,根据我们上面的安装结果,这应该会通过。

  4. 接下来,选择您所需的安装范围。

  5. 将目标文件夹设置为 C:\Android,单击“下一步”,然后单击“安装”。

  6. 成功安装后,运行 Android SDK 管理器。您需要安装预先选中的框。这些内容包括 Android 构建工具的基本工具和一些最新的平台。

  7. 单击“安装 x 个软件包”并等待下载完成。

注意: 您也可以下载 ADT bundle,尽管它包含许多可能并非在所有情况下都需要的额外内容。

按照惯例,我们将需要创建 ANDROID_HOME 环境变量。

  1. 单击“系统变量”下的“新建”按钮
  2. 输入“ANDROID_HOME”作为变量名称,输入“C:\Android”作为变量值。
  3. 单击“确定”

最后,您将需要附加 ANDROID_HOME 环境变量。

  1. 在“系统变量”下找到“Path”
  2. 单击编辑(在 Windows 10 上,您还必须单击“编辑文本”)并在当前变量值的末尾添加“;%ANDROID_HOME%\tools;%ANDROID_HOME%\platforms;%ANDROID_HOME%\platform-tools”。
  3. 单击“确定”接受更改,然后再次单击“确定”保存

您可以通过从终端发出“android”命令来测试路径是否已正确设置。如果 SDK 工具已正确安装,则应启动 Android 管理器。

注意: 请记住,此选项仅影响新的命令提示符窗口,而不影响现有的窗口。关闭以前打开的任何窗口以确保安装。

NodeJS

要安装的最后一个依赖项是 NodeJS。首先下载 NodeJS 安装程序

  1. 启动 Node.js 安装程序并单击“下一步”
  2. 接受许可协议并单击“下一步”
  3. 选择 C:\nodejs 作为安装方向并继续,直到您可以单击“安装”

Node 会自动将其自身添加到系统路径,但您确实需要重新启动机器才能使所有新的映射生效。

重新启动机器后,打开命令提示符并通过发出以下命令来测试 NodeJS 安装

node -v

上面的命令应返回类似以下的内容

"v0.10.3x".

Cordova / PhoneGap

现在 NodeJS 已安装,您可以轻松地将 Cordova 和/或 PhoneGap 添加到您的机器。
这应该是到目前为止最简单的步骤。只需打开您的命令提示符并运行以下命令。

Cordova

npm install -g cordova

PhoneGap

npm install -g phonegap

您可以通过执行以下命令来验证安装

cordova -v
phonegap -v

如果它们已正确安装,两者都应返回版本号。Sencha Architect 中的工作流程

在 Architect 中打开现有项目后,您可以单击“保存”按钮开始。这将初始化您的项目并使用 Sencha Cmd 进行设置。

项目成功保存后,打开命令提示符。

导航到刚保存的项目文件夹并运行以下命令(APP_ID 和 APP_NAME 参数是可选的)。

sencha phonegap init com.mycompany.MyApp MyApp

sencha cordova init com.mycompany.MyApp MyApp

在上面的命令完成后,您现在应该在项目文件夹中看到一个 phonegap(或 cordova)目录。返回 Sencha Architect,您应该看到两个新的构建选项

  • 原生构建
  • 原生构建 & 模拟

您还应该在项目的 app.json 文件中看到 PhoneGap 或 Cordova 的块。app.json 位于项目的根目录。您可以在此处设置要构建的平台。

PhoneGap

"native": {
   "packager": "phonegap",
   "cordova": {
      "config": {
         "id": "com.domain.MyApp",
         "name": "MyApp",
         "platform": "android"
      }
   }
}

Cordova

"native": {
   "packager": "cordova",
   "cordova": {
      "config": {
         "id": "com.domain.MyApp",
         "name": "MyApp",
         "platforms": "android"
      }
   }
}

注意: 由于 Android 工具和模拟器,原生构建 & 模拟在 Windows 上完成 Android 构建需要很长时间。

结论

您的 Windows 8.x/10 环境现在应该已准备好使用 Sencha Architect 构建原生 Android 版本。有关更多信息,请参阅 PhoneGap 和 Cordova 指南

Architect 4.3