跟我一起玩转Sencha Touch 移动 WebApp 开发（一）

1.目录

• 移动框架简介，为什么选择Sencha Touch？
• 环境搭建
• 创建项目框架，框架文件简介
• 创建简单Tabpanel案例
• 自定义图标的方式
• WebApp产品测试和发布
• HTML5离线缓存
• 发布成Android/IOS本地app应用

移动框架简介，为什么选择Sencha Touch？

目前市面上，移动应用web框架，也算是风生水起，不断涌现，各个都称自己最牛逼。常见的几个框架主要有jquery Mobile，Dojo Moble，Sencha Touch，我这里是极端推荐Sencha Touch，至于它多优秀，不是我说了算，只有你亲自用过，做过项目之后才能领悟他的魅力；至于从没用过的口水党，请绕道。

Sencha Touch是使用HTML5，CSS3和JavaScript来实现的，它可以在Android、IOS、WP、黑莓平台上使用，也可以在其他带有HTML5兼容的Web浏览器的平台上使用。更多详细介绍可以到官方阅读http://www.sencha.com/products/touch/，这里不罗嗦。

至于我为什么选择Sencha Touch，理由有如下几点：

• Sencha 旗下的产品，如果你熟练Extjs，几乎是零学习成本，平滑过渡到Touch开发，Sencha是一个非常活跃的组织，技术更新和支持都有很好的保障，世界财富100强里，50%都在用他们的产品
• 完美支持各大移动平台Android、IOS、WP、BlackBerry等，同时可以运行在任何HTML5兼容或以webkit为内核的浏览器上（chrome，safari，360|搜狗极速模式）等，一次编写，n次复用
• 采用超强的cmd压缩、Html5缓存和over-the-air技术，离线访问，解决您对流量的担忧
• 完美支持本地打包，一行命令即可将整个WebAPP打包成为NativeApp，非常方便，不需做任何变更（令我震惊的是可以直接通过ajax访问远程的服务没有跨域问题）
• MVC开发模式，充分解耦，层次分明
• 针对不同平台，区别对待，一个app，phone和tablet两种展现
• 便捷的Sencha Cmd命令工具，类似ruby的命令行，辅助开发
• 丰富的报表控件
• 业界最完备、精致的API文档，丰富的学习资料，几乎一看就懂，强大的forum支持
• 稳定性、JSONP、兼容性等小细节，堪称完美
• 等。
• 更多介绍请看API：http://docs.sencha.com/touch/2.2.1/

环境搭建

1.下载sencha Touch SDK包http://www.sencha.com/products/touch/download/

2.确认本机安装了jdk1.6+，1.7最好

3.Ruby1.9.3或者更早的版本，但一定不能安装2.0的，下载地址：http://rubyinstaller.org/downloads/

4.android-sdk-tools，如果你不想打包成nativeApp，可以不用下载

5.Sencha Cmd 下载地址：http://www.sencha.com/products/sencha-cmd/download

6.注意将jdk，ruby，sencha cmd都添加到环境变量

Sencha Cmd 能干什么？详见：http://docs.sencha.com/touch/2.2.1/#!/guide/command

创建项目框架

ok，环境搭建完毕，下面我们通过sencha cmd（一下简称cmd）的一行命令创建项目框架

#  首先确认进入到了sencha-touch-2-sdkcd /path/to/sencha-touch-2-sdksencha generate app MyApp /path/to/www/myapp

ok，很简单我们生成了自己的项目架构，以后所有的开发都在这个项目架构中开发。

框架文件简介

.sencha：cmd命令运行的一些配置参数

app：整个项目

resources：项目的资源文件，包括css，images，icons[app图标]，startup[启动闪屏图片]

touch：touch的核心包，源文件，资源文件等

app.js：整个项目的入口，配置了需要加载那些js文件等等

index.html：app启动页面

这里需要重点讲下app.json文件和packager.json文件

从st2.x开始，项目启动时候加载的js，css等并不像以前一样全都写在index.html，而是通过app.json配置的形式来动态加载

st2.x的启动加载方式有多种，你可以参考http://www.cnblogs.com/dowinning/archive/2012/03/23/2413071.html

之所以保持官方这种方式，是因为后期我们可以直接通过cmd命令对项目压缩发布，或者打包等，如果破坏了目录结构，cmd将无法执行。

更详细介绍请看官网：http://docs.sencha.com/touch/2.2.1/#!/guide/command_app

app.json浅析

通过IIS或者VS的IIS Express可能无法加载该MIME类型，需要手工配置MIMEhttp://www.cnblogs.com/qidian10/p/3289816.html

  1 {  2     /**  3      * 程序名称，由cmd时候定义产生  4      */  5     "name": "HzyApp",  6     /**  7      * 起始页  8      */  9     "indexHtmlPath": "index.html", 10     /** 11      * The absolute URL to this application in development environment, i.e: the URL to run this application 12      * on your web browser during development, e.g: "http://localhost/myapp/index.html". 13      * 14      * This value is needed when build to resolve your application's dependencies if it requires server-side resources 15      * that are not accessible via file system protocol. 16      */ 17     "url": null, 18     /** 19      * List of all JavaScript assets in the right execution order. 20      * Each item is an object with the following format: 21      *      { 22      *          "path": "path/to/script.js" // Path to file, if local file it must be relative to this app.json file 23      *          "remote": true              // (Optional) 24      *                                      // - Defaults to undefined (falsey) to signal a local file which will be copied 25      *                                      // - Specify true if this file is a remote file which will not to be copied 26      *          "update": "delta"           // (Optional) 27      *                                      //  - If not specified, this file will only be loaded once, and 28      *                                      //    cached inside localStorage until this value is changed. 29      *                                      //  - "delta" to enable over-the-air delta update for this file 30      *                                      //  - "full" means full update will be made when this file changes 31      *          "x-bootstrap": true         // (Optional) 32      *                                      // Indicates a development mode only dependency.   33      *                                      // These files will not be copied into the build directory or referenced 34      *                                      // in the generate app.json manifest for the micro loader. 35      * 36      *      } 37      */ 38      /*应用中所需要的扩展的js文件*/ 39     "js": [ 40         { 41             "path": "touch/sencha-touch-all.js", 42             "x-bootstrap": true 43         },{ 44             "path":"common/Global.js", /*例如只是我自己定义的*/ 45             "update":"delta" 46         },{ 47             "path": "app.js", 48             "bundle": true, /*  Indicates that all class dependencies are concatenated into this file when build */ 49             "update": "delta" 50         } 51     ], 52     /** 53      * List of all CSS assets in the right inclusion order. 54      * Each item is an object with the following format: 55      *      { 56      *          "path": "path/to/item.css" // Path to file, if local file it must be relative to this app.json file 57      *          "remote": true             // (Optional) 58      *                                     // - Defaults to undefined (falsey) to signal a local file which will be copied 59      *                                     // - Specify true if this file is a remote file which will not to be copied 60      *          "update": "delta"          // (Optional) 61      *                                     //  - If not specified, this file will only be loaded once, and 62      *                                     //    cached inside localStorage until this value is changed to either one below 63      *                                     //  - "delta" to enable over-the-air delta update for this file 64      *                                     //  - "full" means full update will be made when this file changes 65      * 66      *      } 67      */ 68      /*应用中所需要的css文件*/ 69     "css": [ 70         { 71             "path": "resources/css/app.css", 72             "update": "delta" 73         },{ 74             "path": "resources/css/icons.css", /*例如只是我自己定义的图标css*/ 75             "update": "delta" 76         } 77     ], 78     /** 79      * HTML5的缓存配置 80      */ 81     "appCache": { 82         /** 83          * 缓存的东西，即使离线任然可用http://www.cnblogs.com/qidian10/p/3292876.html 84          */ 85         "cache": [ 86             "index.html" 87         ], 88         /** 89          * 不缓存的东西，离线不可用 90          */ 91         "network": [ 92             "*" 93         ], 94         /** 95          * 错误页面 96          */ 97         "fallback": [] 98     }, 99 100     /**101      * Extra resources to be copied along when build102      */103     "resources": [104         "resources/images",105         "resources/icons",106         "resources/startup"107     ],108 109     /**110      * cmd编译项目时候，自动忽略的文件111      */112     "ignore": [113         "/.svn$"114     ],115 116     /**117      * Directory path to store all previous production builds. Note that the content generated inside this directory118      * must be kept intact for proper generation of deltas between updates119      */120     "archivePath": "archive",121 122     /**123      * List of package names to require for the cmd build process124      */125     "requires": [126     ],127 128     /**129      * Uniquely generated id for this application, used as prefix for localStorage keys.130      * Normally you should never change this value.131      */132     "id": "3c292300-172c-4bee-bbaa-d2e783f75677"133 }

app.json文件中注意js部分，默认开发的时候采用的是sencha.js,这将导致整个app加载js的时候都是加载st的源代码文件，速度会非常慢，这里我改成sencha-all.js文件，直接加载他编译好的包，效率将大大提升

packager.json该文件是为了app打包用的，等到项目发布的部分再解析

创建简单Tabpanel案例

我们打开app文件夹，在view里面添加如下文件：

各个部分代码如下：

 1 //<debug> 2 Ext.Loader.setPath({ 3     'Ext': 'touch/src' 4 }); 5 //</debug> 6 Ext.application({ 7     name: 'HzyApp', 8     requires: [ 9         'Ext.MessageBox'10     ],11     views: ['Main'],12     icon: {13         '57': 'resources/icons/Icon.png',14         '72': 'resources/icons/Icon~ipad.png',15         '114': 'resources/icons/Icon@2x.png',16         '144': 'resources/icons/Icon~ipad@2x.png'17     },18     isIconPrecomposed: true,19     startupImage: {20         '320x460': 'resources/startup/320x460.jpg',21         '640x920': 'resources/startup/640x920.png',22         '768x1004': 'resources/startup/768x1004.png',23         '748x1024': 'resources/startup/748x1024.png',24         '1536x2008': 'resources/startup/1536x2008.png',25         '1496x2048': 'resources/startup/1496x2048.png'26     },27     launch: function() {28         // Destroy the #appLoadingIndicator element29         Ext.fly('appLoadingIndicator').destroy();30         Ext.Viewport.add(Ext.create('HzyApp.view.Main'));31     },32    //html5缓存更新33     onUpdated: function() {34         Ext.Msg.confirm(35             "更新",36             "系统已经自动更新到最新版本，是否重新加载？",37             function(buttonId) {38                 if (buttonId === 'yes') {39                     window.location.reload();40                 }41             }42         );43     }44 });

 1 Ext.define('HzyApp.view.Main', { 2     extend: 'Ext.tab.Panel', 3     alias: 'widget.main', 4     requires: [ 5         'Ext.TitleBar', 6         'HzyApp.view.message.Main', 7         'HzyApp.view.history.Main', 8         'HzyApp.view.favorite.Main', 9         'HzyApp.view.system.Main',10         'HzyApp.view.user.Main'11     ],12     config: {13         id: 'hzyAppViewMain',14         fullscreen: true,15         tabBarPosition: 'bottom',16         items: [{17             xtype: 'messagemain'18         }, {19             xtype: 'systemmain'20         }, {21             xtype: 'favoritemain'22         }, {23             xtype: 'historymain'24         }, {25             xtype: 'usermain'26         }]27     }28 });

 1 Ext.define('HzyApp.view.favorite.Main', { 2     extend: 'Ext.NavigationView', 3     alias: 'widget.favoritemain', 4     config: { 5         title: '收藏夹', 6         iconCls: 'favorites', 7         autoDestroy: false, 8         defaultBackButtonText: '返回', 9         navigationBar: {10             items: [11                 {12                     iconMask: true,13                     iconCls: 'refresh',14                     action: 'refreshKB',15                     align: 'right'16                 },17                 {18                     hidden: true,19                     iconMask: true,20                     iconCls: 'chat',21                     action: 'toreply',22                     align: 'right'23                 },24                 {25                     hidden: true,26                     iconMask: true,27                     iconCls: 'compose',28                     action: 'toscore',29                     align: 'right'30                 }31             ]32         },33         items: [34             {35                 html: 'This will display favorite urls！'36             }37         ]38     }39 });

 其他文件夹的main文件和favorite的类似，只需要改下标题和iconCls即可，下载地址:http://files.cnblogs.com/qidian10/view.rar

当然这些view、store、model、controller文件，你完全可以通过cmd命令创建

cd /path/to/www/myappsencha generate model User id:int,name,email
如果知道命令参数，直接输入：sencha generate model

 ok，创建完成这些文件，你应该可以看到自己的界面了，但遗憾的是估计你看不到你的图标iconCls的图标，应为有两个图标是我自定义的。

SenchaTouch里如何使用自己定义的图标也是一门很大的学问，ST采用sass技术，图标在2.2里面全部改成了字体的形式，也就是你看到的图标其实是一个字体（例如A）

自定义图标的方式

 那么如何在Sencha Touch 2.2 里自定义icon图标呢？提供一种简单方法http://www.cnblogs.com/qidian10/p/3292669.html

 学会自定义icon后，将需要的icon，CSS加入到app.json的css块中

WebApp产品测试和发布

ok，不出意外，现在一个完整的demo应用已经展现在你面前了。

到目前为止，如果你不嫌费流量和加载效率的话，其实一个应用已经完成了，你可以直接用了。

但是Sencha给我们提供了更加优秀的app发布方式，可以直接将项目中需要的资源压缩打包，进行html5的离线缓存，这样，我们的应用程序在第一次加载完成后，在离线情况下也是可以使用的（数据访问除外）

Sencha给我们提供了4种发布方式

• testing:供测试，QA使用版本
• package：脱离web server，本地html文件资源包
• production：正是发布的webapp产品
• native：打包成android apk，或者ios app本地安装文件

我们只需要在cmd里，执行一行命令即可发布我们的产品:

#production,testing,native,package#进入到你的通过cmd生成的MyApp文件夹中sencha app build production

ok，项目成功build,你可到MyApp/build/MyApp/Production中看生成的文件，你直接打index.html你会发现瞬间app就打开了，因为cmd帮我们做了压缩工作，所有的css，js都压缩了，而且app的mvc核心文件都打包压缩到app.js里，减少了请求次数。

HTML5离线缓存

如果你将已发布好的app，放到remote server上，第一次打开index.html，然后切断网络，再次刷新index.html你会发现仍然可以显示。原因就是他采用了html5的离线缓存技术

Sencha Touch App每次打开都会检查服务器是否有变动，如果有变动，会自动触发app.js里的onUpdated方法，提醒用户更新

如果HTML5离线缓存小白的同学，赶紧补课：http://www.cnblogs.com/qidian10/p/3292876.html

哦对了，这里还需要添加MIME类型以支持html5的缓存变更文件cache.appcache，application/cache-manifest

发布成Android/IOS本地app应用

如果你觉得采用webapp的方式，仍然不够理想，那么可以用st的另一把利器，打包Sencha Touch webapp为本地native app

这里介绍如何将Sencha Touch 打包为Android的apk

首先确认安装了android-sdk-tools，jdk，下面开始本节的最后一个内容：

1.生成android证书

　　简单起见，我们将私钥仓库（keystore）建立在X:/目录，将私钥仓库（keystore），别名（alias） 和密码（password）都设为"hzyapp"。

$ keytool -genkey -v -keystore hzyapp.keystore -alias hzyapp -keyalg RSA -keysize 2048 -validity 10000

Enter keystore password: (I entered "hzyapp")What is your first and last name?  [Unknown]: jack chenWhat is the name of your organizational unit?  [Unknown]: itWhat is the name of your organization?  [Unknown]: hzyWhat is the name of your City or Locality?  [Unknown]: jiaxingWhat is the name of your State or Province?  [Unknown]:  zhejiangWhat is the two-letter country code for this unit?  [Unknown]:  CNIs CN=Patrick Chu, OU=Training, O=Sencha, L=Redwood City, ST=California, C=US correct?  [no]:  yGenerating 2,048 bit RSA key pair and self-signed certificate (SHA1withRSA) with a validity of 10,000 days    for: CN=jack chen, OU=it, O=hzy, L=jiaxing, ST=zhejiang, C=CNEnter key password for <hzyapp>    (RETURN if same as keystore password):  [Storing hzyapp.keystore]

 ok，这样你就产生了一个hzyapp.keystore证书，备用。

上面我们讲到还有一个文件packager.json没解析，这里解析下，该文件就是打包本地应用的配置文件，打开文件内容配置对android的配置如下：

{    "applicationName":"HzyApp",    "applicationId":"com.hwayifashiongroup.HzyApp",/*必须是包括两个点*/    "bundleSeedId":"KPXFEPZ6EF",    "versionString":"1.0",    "versionCode":"1",    "icon": {        "36":"resources/icons/Icon_Android36.png",        "48":"resources/icons/Icon_Android48.png",        "57":"resources/icons/Icon.png",        "72":"resources/icons/Icon~ipad.png",        "114":"resources/icons/Icon@2x.png",        "144":"resources/icons/Icon~ipad@2x.png"    },    "inputPath":"./",    "outputPath":"../build/",    "configuration":"Debug",    "platform":"Android",/*平台,还有IOS等类型*/    "certificatePath":"X:/hzyapp.keystore",/*证书*/    "certificateAlias":"hzyapp",/*证书别名*/    "certificatePassword":"hzyapp",/*证书密码*/    "sdkPath":"D:/GreenSoftWare/Android/android-sdk-windows",/*android-sdk路径*/    "androidAPILevel":"8",/*Android版本，我用了2.2*/    "permissions":[            "INTERNET",            "ACCESS_NETWORK_STATE",            "CAMERA",            "VIBRATE",            "ACCESS_FINE_LOCATION",            "ACCESS_COARSE_LOCATION",            "CALL_PHONE"        ]}

文件配置成功后，执行最关键的一步，打包命令

 如果全线飘绿，那恭喜你，你成功了，赶紧到/build/MyApp/native目录下找你的apk吧，哈哈

ok，安装到手机上，测试，一切正常，速度刚刚的，当然真正的和nativeapp比，必然会存在一些不足，但对于企业级的移动应用足够了。

文章最后再爆一料，默认产生的app，安装到android后，title bar是没有隐藏的，这个你只需要去更改cmd的模版文件即可

SenchaCmd/Sencha/Cmd/3.1.2.342/stbuild/st-res/android/AndroidManifest.xml，我想你该知道怎么做了吧！(*^__^*)

OK了，本节基本上贯穿了整个Sencha Touch开发的全貌。

下节课将会介绍真正的Sencha Touch细节开发了，深入到app里的各个层面（model，store，view，controller），注意事项，profile不同设备的适配等，敬请期待。

能坚持看完的朋友，别忘了支持下哦