Sencha Cmd 简介

Sencha Cmd 是一个跨平台的命令行工具，它为应用程序的整个生命周期提供了许多自动化任务，从生成新项目到将应用程序部署到生产环境。

了解 Sencha Cmd

Sencha Cmd 提供了一系列强大的、节省时间的功能，这些功能协同工作，并与 Sencha Ext JS 和 Sencha Touch 框架结合使用。Sencha Cmd 提供以下功能

• 代码生成工具：代码生成工具，用于生成整个应用程序，并使用新的 MVC 组件扩展这些应用程序。
• JS 编译器：一个框架感知的 JavaScript 编译器，它理解 Sencha 框架的语义，并且可以从您的源代码生成最小占用空间的构建。编译器可以优化 Sencha 框架提供的许多高级语义，以减少应用程序的加载时间。
• Web 服务器：提供一个轻量级 Web 服务器，用于从 localhost 提供文件。
• 包管理系统：分布式包管理系统，用于轻松集成由其他人或来自 Sencha 包存储库创建的包（例如 Ext JS 主题）。
• Sencha Web 应用程序管理器集成 - 轻松将新的应用程序版本发布到 Sencha Web 应用程序管理器服务器。
• 工作区管理：协助在多个应用程序之间共享框架、包和自定义代码。
• 构建脚本：为应用程序和包生成构建脚本，其中包含“before”和“after”扩展点，以便您可以自定义构建过程以适应您的特定需求。
• Cordova / PhoneGap 集成：本机打包，将 Web 应用程序转换为一流的移动应用程序，该应用程序可以访问设备功能并可以在应用商店中分发。
• 图像捕获：将 CSS3 功能（例如 border-radius 和 linear-gradient）转换为旧版浏览器的精灵图。
• 调整工具：强大的代码选择工具，用于调整应用程序最终构建中包含的内容，确定跨页面的通用代码，并使用高级集合操作来划分共享代码，以获得完全符合您要求的构建。
• 灵活的配置系统：允许在应用程序或工作区级别或跨机器上的所有工作区为命令选项指定默认值。
• 日志记录：强大的日志记录，可帮助您了解命令的内部工作原理并促进故障排除。
• 第三方软件：对于 Sencha Touch 和 Ext JS 5 及更早版本，Sencha Cmd 包括兼容版本的 Compass 和 Sass。
• 代码生成挂钩：可以是特定于一个页面，也可以由工作区中的所有页面共享，例如，在生成新模型时检查编码约定或指南）。

兼容性

Sencha Cmd 支持 Sencha Ext JS 4.1.1a 或更高版本和 Sencha Touch 2.1 或更高版本。Sencha Cmd 的许多功能需要框架支持，而这些支持仅在这些或更高版本级别上可用。一些底层命令可以用于旧版本的 Sencha 框架或通用 JavaScript。

如果您使用的是旧版本的 Ext JS，则可以使用 Sencha Cmd 的 build 命令通过 JSB 文件进行构建。换句话说，Sencha Cmd 可以替换 JSBuilder，以生成 JSB 文件中描述的文件的压缩构建。Sencha Cmd 不会更新您的 JSB 文件，就像已弃用的 SDK Tools v2 所做的那样。

Sencha Touch 2.0 和 Sencha Ext JS 4.0 需要已弃用的 SDK Tools v2，它不能与更高版本的 Touch 或 Ext JS 版本一起使用。

系统设置

Sencha Cmd 6 安装程序包含构建 Ext JS 6 应用程序所需的所有软件，因此只需下载 Sencha Cmd

• Sencha Cmd

使用旧框架

如果您使用的是旧版本的 Ext JS 或 Sencha Touch，则需要在安装程序中选中“Compass 扩展”选项

您还需要安装 Ruby 以编译使用 Sass 的主题和应用程序。Ruby 因操作系统而异

• Windows：从 rubyinstaller.org 下载 Ruby。获取软件的 ".exe" 文件版本并安装它。
• Mac OS：Ruby 已预先安装。您可以使用 Ruby -v 命令测试是否已安装 Ruby。
• Ubuntu：使用 sudo apt-get install ruby2.0.0 下载 Ruby。

如果您将使用 Cordova 或 PhoneGap，则这些工具可能还有其他要求。请参阅 与 Cordova 或 PhoneGap 集成。

安装程序会将条目添加到您的 PATH 环境变量中。

验证安装

要验证 Sencha Cmd 是否正常工作，请打开命令行，将目录更改为您的应用程序，然后键入 sencha 命令。

您应该看到类似如下的输出

Sencha Cmd v6.0.0.202
...

显示的确切版本号应与您刚刚安装的版本匹配。

静默安装 Sencha Cmd

一些用户可能希望在没有安装程序的 GUI 的情况下安装 Sencha Cmd。如果您需要仅 CLI 的安装过程，只需从命令行工具运行以下命令即可

Mac OSX

SenchaCmd-6.x.y.z-osx.app/Contents/MacOS/JavaApplicationStub -q

Linux

SenchaCmd-6.x.y.z-linux(-i386|-amd64).sh -q

Windows

SenchaCmd-6.x.y.z-windows-(32|64)bit.exe -q

这将安装没有 GUI 安装程序的 Sencha Cmd。

更改安装路径

如果您需要更改安装路径，可以使用“dir”标志指定它。例如

sudo SenchaCmd-6.x.y.z-linux(-i386|-amd64).sh -q -dir "/opt"

注意： 您选择的安装路径可能需要权限更改。

升级 Sencha Cmd

sencha upgrade 功能允许您升级 Sencha Cmd。

检查 Sencha Cmd 的新更新

sencha upgrade --check

如果没有 --check 选项，如果您尚未拥有最新版本，则 sencha upgrade 命令将下载并安装最新版本

sencha upgrade

安装程序完成后，启动一个新的控制台或终端以获取对 PATH 环境变量的更改。

由于可以并排安装多个版本的 Sencha Cmd，因此您可以安全地尝试新版本，只需卸载它们（或调整 PATH 或符号链接）即可返回到以前的版本。但是，使用 sencha app upgrade 升级您的应用程序更像是一个源代码控制项目，如果您降级到旧版本的 Sencha Cmd，则可能需要“回滚”。

静默升级 Sencha Cmd

一些用户可能希望在没有安装程序的 GUI 的情况下升级 Sencha Cmd。如果您需要仅 CLI 的升级过程，只需从命令行工具运行以下命令即可

sencha upgrade --unattended

这将升级没有 GUI 安装程序的 Sencha Cmd。

Beta 版本

如果您想检查 Beta 版本，请使用

sencha upgrade --check --beta

要安装最新的 Beta 版本

sencha upgrade --beta

注意 最新的版本有可能位于“beta”或稳定通道中。也就是说，sencha upgrade --beta 可能会安装一个 beta 版本，该版本早于 sencha upgrade 将安装的当前版本。

命令基础知识

Sencha Cmd 功能按类别（或模块）和命令排列

sencha [category] [command] [options...] [arguments...]

可以使用 help 命令获得帮助。

sencha help [module] [action]

例如，尝试这个

sencha help

显示当前版本和可用的顶级命令。例如

Sencha Cmd v6.0.0.202
...

Options
  * --beta, -be - Enable beta package repositories
  * --cwd, -cw - Sets the directory from which commands should execute
  * --debug, -d - Sets log level to higher verbosity
  * --info, -i - Sets log level to default
  * --nologo, -n - Suppress the initial Sencha Cmd version display
  * --plain, -pl - enables plain logging output (no highlighting)
  * --quiet, -q - Sets log level to warnings and errors only
  * --sdk-path, -sd - The location of the SDK to use for non-app commands
  * --strict, -st - Treats warnings as errors, exiting with error if any warnings are present
  * --time, -ti - Display the execution time after executing all commands

Categories
  * app - Perform various application build processes
  * compile - Compile sources to produce concatenated output and metadata
  * cordova - Quick init Support for Cordova
  * diag - Perform diagnostic operations on Sencha Cmd
  * fs - Utility commands to work with files
  * generate - Generates models, controllers, etc. or an entire application
  * manager - Commands for interacting with Sencha Web Application Manager.
  * manifest - Extract class metadata
  * package - Manages local and remote packages
  * phonegap - Quick init support for PhoneGap
  * repository - Manage local repository and remote repository connections
  * template - Commands for working with templates
  * theme - Commands for low-level operations on themes
  * web - Manages a simple HTTP file server

Commands
  * ant - Invoke Ant with helpful properties back to Sencha Cmd
  * audit - Search from the current folder for Ext JS frameworks and report their license
  * build - Builds a project from a legacy JSB3 file.
  * config - Load a properties file or sets a configuration property
  * help - Displays help for commands
  * js - Executes arbitrary JavaScript file(s)
  * upgrade - Upgrades Sencha Cmd
  * which - Displays the path to the current version of Sencha Cmd

注意： 确切内容将取决于您安装的版本。

详细输出

Sencha Cmd 5 中显著减少了调试输出的级别。您可以通过在命令中包含 -info 标志来重新启用详细输出。例如

 sencha -info app watch

此命令将提供有关初始化期间和文件系统更新时发生的后台进程的更多信息。

-info 标志可以与任何生成输出的 Sencha 命令一起使用。

当前目录

在许多情况下，Sencha Cmd 要求您设置特定的当前目录。或者它可能只是需要知道有关相关 Sencha SDK 的详细信息。当从生成的应用程序文件夹或对于某些命令从提取的 SDK 文件夹运行时，SDK（或“框架”）可以由 Sencha Cmd 自动确定。

重要提示 对于以下命令，Sencha Cmd 需要从生成的应用程序的根文件夹运行。如果不是从应用程序的根文件夹运行，命令将失败。

* `sencha generate ...` (for commands other than `app`, `package` and `workspace`)
* `sencha app ...`

包也是如此。当运行 sencha package build 等命令时，当前目录必须是所需的包文件夹。

Sencha Cmd 文档

Sencha Cmd 的许多指南经过组织，旨在帮助您建立理解，建议您遵循此顺序。跳过前面的指南可能会导致混淆，因为高级指南通常假设理解早期指南的内容。

每个指南的开头都有指向该指南任何先决条件的链接。此外，大多数指南都以一组链接结尾，供进一步阅读。

超越基础知识

还有许多与使用 Sencha Cmd 相关的其他详细信息可能很有用。help 命令是一个很好的参考，但是如果您想了解所有重点，请查阅 高级 Sencha Cmd。

故障排除

以下是一些解决使用 Sencha Cmd 时遇到的常见问题的技巧。

Java 堆空间

如果您在执行 Cmd 命令后收到“java heap space”错误，则可能需要增加 Java 分配的内存使用量。

Mac & Linux

将以下内容添加到 ~/.bash_profile

export _JAVA_OPTIONS="-Xms1024m -Xmx2048m"

Windows

您可以将变量添加为环境变量，也可以将以下内容添加到 startup.bat

set _JAVA_OPTIONS="-Xms1024m -Xmx2048m"

命令未找到

如果在 OSX/Linux 上运行 sencha 导致错误消息 sencha: command not found，或者在 Windows 上导致 'sencha' is not recognized as an internal or external command, operable program or batch file，请按照以下步骤操作

• 关闭终端/命令提示符窗口并打开一个新的窗口。
• 确保 Sencha Cmd 已正确安装
  • 安装目录存在。默认情况下，安装路径为
    • Windows: C:\Users\Me\bin\Sencha\Cmd\{version}
    • Mac OS X: ~/bin/Sencha/Cmd/{version}
    • Linux: ~/bin/Sencha/Cmd/{version}
  • Sencha Cmd 目录的路径已添加到您的 PATH 环境变量中。从终端，在 Windows 上运行 echo %PATH%，在 Mac 或 Linux 上运行 echo $PATH。Sencha Cmd 目录应显示在输出的一部分中。如果不是这种情况，请手动将其添加到您的 PATH 中。

找不到 Ruby

如果您看到与无法识别或找到 "ruby" 相关的错误，则可能是因为未安装 Ruby 或 Ruby 不在您的 PATH 中。请参阅前面的 系统设置 部分。

您不应该在使用 Ext JS 6 时看到此消息，因为使用了 Fashion 而不是 Compass，并且 Fashion 不需要 Ruby。

错误的当前目录

一个常见的错误是执行一个命令，该命令要求当前目录是提取的 SDK 目录或应用程序目录，但尚未设置这样的目录。如果未满足此要求，Sencha Cmd 将显示错误并退出。

注意 有效的应用程序目录是由 Sencha Cmd 生成的目录。

解析依赖项时出错

sencha app build 命令的工作原理是读取您的 index.html 和 app.json 文件并扫描所需的类。如果您的应用程序未正确声明它需要的类，则构建通常会完成，但不会包含您的应用程序所需的所有类。

为确保您已指定所有必需的类，请始终在启用调试器控制台的情况下进行开发（IE/Chrome 中的“开发者工具”、FireFox 中的 FireBug 和 Safari 中的 Web Inspector），并解决出现的所有警告和错误消息。

每当您看到这样的警告时

[Ext.Loader] Synchronously loading 'Ext.foo.Bar'; consider adding 'Ext.foo.Bar'
explicitly as a require of the corresponding class

您应该将 'Ext.foo.Bar' 添加到依赖项来源类的 requires 数组属性中。如果是应用程序范围的依赖项，请将其添加到 app.js 中 Ext.application(...) 语句内的 requires 数组属性中。