SenchaCmd3.0使用入门

无论 Sencha Touch 还是 Ext JS&＃xff0c;官方所提供的不单纯是源码、文档等那些固然已是重要的分发&＃xff0c;——一个强大可用的开发工具更是渐渐地被衍生出来&＃xff0c;——它是 Sencha Cmd&＃xff0c;一个伴随 JS 项目开发而研制的新型工具&＃xff0c;它不但走入了我们的视野&＃xff0c;而且一路发展&＃xff0c;愈渐成熟。Sencha Cmd 在 2.x 版本的时候称作 Secha Command&＃xff0c;它是纯命令行工具&＃xff0c;没有 GUI 界面&＃xff0c;不依附任何 IDE&＃xff0c;却又让我们程序员有对 IDE 那般的顺手和千般“依赖”。

安装过程 System Setup

v3.0 比 2.0 改进来得大&＃xff0c;所以我们一般推荐使用新版的 3.0。注意 3.x 版本从 Sencha Ext JS version 4.1.1a、Sencha Touch, version 2.1 Beta 3 开始支持。 

来说说简单的安装过程&＃xff0c;如下&＃xff1a;

1. 安装Jave Run-time Environment or JRE。要求版本 v1.6或以上&＃xff1b;
2. 为编辑样式&＃xff0c;需要安装 Compass&＃xff1b;
3. 下载、安装 Sencha Cmd.http://cdn.sencha.io/senchacmd/SenchaCmd-3.0.0.250-windows.exe.zip
4. 下载并解压缩 Ext JS SDK or Sencha Touch SDK.

因为多数用户使用 Win32 平台&＃xff0c;下面就已 Win CMD 命令台为例子进行说明。安装了 Sencha Cmd&＃xff0c;先测试一下是否安装成功。我们进入刚解压缩的 ExtJS / Sencha Touch 之 SDK 目录&＃xff08;或说 SDK 文件夹&＃xff09;&＃xff0c;注意不是 Sencha Cmd 的目录。在命令台通过 cd 进入 SDK 目录&＃xff0c;敲入 ”Sencha“ 试试&＃xff1a;

cd /path/to/sdk
sencha

如安装成功&＃xff0c;显示如下&＃xff1a;

Sencha Cmd v3.0.0
...

其实你在任意一个目录中运行 sencha.exe 程序都可以&＃xff0c;因为安装 Sencha Cmd 的时候已经为我们设置好 Sencha Cmd 的环境变量&＃xff0c;以方便调用。

基本命令 Command Basics

Sencha 本身就是可执行程序的名称&＃xff0c;也可看作一种集合&＃xff0c;其下面有许多模块供调用。用户输入命令的时候遵循一定的格式&＃xff0c;格式如下&＃xff1a;

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

不清楚某个模块怎么用&＃xff1f;使用 help 帮助命令吧&＃xff0c;所有命令皆可&＃xff0c;格式如下&＃xff1a;

sencha help [module] [action]

如果单纯敲入 sencha help&＃xff1a;

sencha help

那么将会出现各个命令使用方法的清单&＃xff0c;也就是“命令一览表”&＃xff1a;

Sencha Cmd v3.0.0OPTIONS* --debug, -d - Sets log level to higher verbosity 日志* --plain, -p - enables plain logging output (no highlighting) 不高亮* --quiet, -q - Sets log level to warnings and errors only 是否出现日志* --sdk-path, -s - sets the path to the target sdk 指定 sdk 目录所在CATEGORIES* compile - Compile sources to produce concatenated output and metadata 编译* generate - Generate code like models and controllers or raw templates 代码生成* theme - Builds a set of theme images from a given html page 主题* app - Perform various application build processes 构建程序COMMANDS* ant - Invoke Ant with helpful properties back to Sencha Cmd Java Ant 打包* build - Builds a project from a JSB3 file. 根据 JSB3 文件构建项目 * config - Loads a config file or sets a configuration property 加载配置文件* help - Get help on using Sencha Cmd 显示帮助信息

当前所在目录 Current Directory

为了让了 Sencha Cmd 获取 SDK 的相关信息&＃xff0c;通常我们要指定好当前所在的目录。

要运行下列命令&＃xff0c;Sencha Cmd 必须事先晓得 SDK 之所在。你可以每次手动指定&＃xff08;在 sdk 当前命令下运行 sencha.exe 即可&＃xff09;&＃xff0c;或者一次性确定。若不指定&＃xff0c;将会报错“[ERROR] Failed to determine framework name.  Please ensure this command was issued from either a framework or application directory”&＃xff1a;

* &＃96;sencha generate app&＃96;
* &＃96;sencha compile&＃96;

只要解压缩 SDK&＃xff0c;有了 SDK 之所在&＃xff08;有目录了&＃xff09;于是便可以让 Sencha Cmd 确定 SDK 在哪&＃xff0c;确定一次后则不用以后多次重复输入了。附带 -sdk 参数指定便可&＃xff1a;

sencha -sdk /path/to/sdk ...

要运行下列命令&＃xff0c;Sencha Cmd 必须事先晓得当前项目之所在&＃xff0c;否则会报错。

* &＃96;sencha generate ...&＃96; (除了 &＃96;app&＃96; and &＃96;workspace&＃96;这两个命令&＃xff0c;这两个例外)
* &＃96;sencha app ...&＃96;
“generate” 是 Sencha Cmd 其中一大模块&＃xff0c;字面上就是动词“生成”的意思&＃xff0c;“sencha generate app” 的话明显是导出一个空程序&＃xff0c;因此我们说新建一个程序、生成一个新的项目也是发轫于此。该命令的第一个参数“MyApp”是项目名称&＃xff0c;第二参数是项目的路径所在。 

sencha generate app MyApp /path/to/MyApp

加 -p 参数亦然&＃xff1a;

sencha generate app -pa d:\project\myapp\www

通过该命令&＃xff0c;Sencha Cmd 把运行 程序最基本的要素&＃xff0c;——整个程序结构&＃xff0c;包括 js/css/html……还有相关的配置文件都生成到指定的地方。据官方指南说&＃xff0c;如果基于 ExtJS SDK 生成的&＃xff0c;其生成的项目只能运行在桌面上&＃xff1b;如果基于 Sencha touch  SDK 生成的&＃xff0c;则其生成的项目只能运行在手机上。

好&＃xff0c;今天就这里止笔吧。

打包你的项目

执行打包的过程依赖 compass 编译样式。这是 v3 较 v2 新增的地方&＃xff0c;v2 不需要 compass。关于 compass 工具的简介可以参考我以前写过的一篇文章《Sencha SDK工具之Slicer简介》后半部分。compass 是一个 Ruby 项目&＃xff0c;因此我们先安装、设置 Ruby&＃xff0c;这里使用 RailsInstaller.exe。安装之后会在系统的环境变量中加入 gem.exe /ruby.exe&＃xff0c;所以我们可立马安装 compass&＃xff1a;

gem install compass

安装 compass 成功之后如下图所示&＃xff1a;

更新程序 Upgrading Your Application

开发人员通过 Sencha Cmd 生成一个“空的项目”&＃xff0c;等于为项目准备了一份 Sencha Touch 的副本。 那么当有新的 Senchat ouch 版本更新出来&＃xff0c;例如从版本 ver 2.0.1 升级到 ver 2.1.0 的时候&＃xff0c;那么我们开发人员将如何更新框架及其源码呢&＃xff1f;Sencha Cmd 早为我们考虑到更新 SDK 的需求——整个更新过程跟创建新项目使用类似&＃xff0c;首先还是要通过命令行进入到新版本的 SDK 目录中&＃xff0c;然后敲入 sencha app upgrade &＃xff08;您项目所在的文件夹&＃xff09;/path/to/your_application 进行更新即可。

cd /path/to/new_version_of_sdk
sencha app upgrade /path/to/your_application

若执行命令完毕表示无缝升级框架成功&＃xff0c;完成了新版本对旧版本的覆盖。