Sencha Touch开发完整流程快速讲解

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-sdk
cd /path/to/sencha-touch-2-sdk
sencha 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

{
     /**
      * 程序名称，由cmd时候定义产生
      */
     "name": "HzyApp",
     /**
      * 起始页
      */
     "indexHtmlPath": "index.html",
     /**
      * The absolute URL to this application in development environment, i.e: the URL to run this application
      * on your web browser during development, e.g: "http://localhost/myapp/index.html".
      *
      * This value is needed when build to resolve your application's dependencies if it requires server-side resources
      * that are not accessible via file system protocol.
      */
     "url": null,
     /**
      * List of all JavaScript assets in the right execution order.
      * Each item is an object with the following format:
      *      {
      *          "path": "path/to/script.js" // Path to file, if local file it must be relative to this app.json file
      *          "remote": true              // (Optional)
      *                                      // - Defaults to undefined (falsey) to signal a local file which will be copied
      *                                      // - Specify true if this file is a remote file which will not to be copied
      *          "update": "delta"           // (Optional)
      *                                      //  - If not specified, this file will only be loaded once, and
      *                                      //    cached inside localStorage until this value is changed.
      *                                      //  - "delta" to enable over-the-air delta update for this file
      *                                      //  - "full" means full update will be made when this file changes
      *          "x-bootstrap": true         // (Optional)
      *                                      // Indicates a development mode only dependency.
      *                                      // These files will not be copied into the build directory or referenced
      *                                      // in the generate app.json manifest for the micro loader.
      *
      *      }
      */
      /*应用中所需要的扩展的js文件*/
     "js": [
         {
             "path": "touch/sencha-touch-all.js",
             "x-bootstrap": true
         },{
             "path":"common/Global.js", /*例如只是我自己定义的*/
             "update":"delta"
         },{
             "path": "app.js",
             "bundle": true, /*  Indicates that all class dependencies are concatenated into this file when build */
             "update": "delta"
         }
     ],
     /**
      * List of all CSS assets in the right inclusion order.
      * Each item is an object with the following format:
      *      {
      *          "path": "path/to/item.css" // Path to file, if local file it must be relative to this app.json file
      *          "remote": true             // (Optional)
      *                                     // - Defaults to undefined (falsey) to signal a local file which will be copied
      *                                     // - Specify true if this file is a remote file which will not to be copied
      *          "update": "delta"          // (Optional)
      *                                     //  - If not specified, this file will only be loaded once, and
      *                                     //    cached inside localStorage until this value is changed to either one below
      *                                     //  - "delta" to enable over-the-air delta update for this file
      *                                     //  - "full" means full update will be made when this file changes
      *
      *      }
      */
      /*应用中所需要的css文件*/
     "css": [
         {
             "path": "resources/css/app.css",
             "update": "delta"
         },{
             "path": "resources/css/icons.css", /*例如只是我自己定义的图标css*/
             "update": "delta"
         }
     ],
     /**
      * HTML5的缓存配置
      */
     "appCache": {
         /**
          * 缓存的东西，即使离线任然可用http://www.cnblogs.com/qidian10/p/3292876.html
          */
         "cache": [
             "index.html"
         ],
         /**
          * 不缓存的东西，离线不可用
          */
         "network": [
             "*"
         ],
         /**
          * 错误页面
          */
         "fallback": []
     },

     /**
      * Extra resources to be copied along when build
      */
     "resources": [
         "resources/images",
         "resources/icons",
         "resources/startup"
     ],

     /**
      * cmd编译项目时候，自动忽略的文件
      */
     "ignore": [
         "\.svn$"
     ],

     /**
      * Directory path to store all previous production builds. Note that the content generated inside this directory
      * must be kept intact for proper generation of deltas between updates
      */
     "archivePath": "archive",

     /**
      * List of package names to require for the cmd build process
      */
     "requires": [
     ],

     /**
      * Uniquely generated id for this application, used as prefix for localStorage keys.
      * Normally you should never change this value.
      */
     "id": "3c292300-172c-4bee-bbaa-d2e783f75677"
 }

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

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

创建简单Tabpanel案例

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

各个部分代码如下：

//<debug>
 Ext.Loader.setPath({
     'Ext': 'touch/src'
 });
 //</debug>
 Ext.application({
     name: 'HzyApp',
     requires: [
         'Ext.MessageBox'
     ],
     views: ['Main'],
     icon: {
         '57': 'resources/icons/Icon.png',
         '72': 'resources/icons/Icon~ipad.png',
         '114': 'resources/icons/Icon@2x.png',
         '144': 'resources/icons/Icon~ipad@2x.png'
     },
     isIconPrecomposed: true,
     startupImage: {
         '320x460': 'resources/startup/320x460.jpg',
         '640x920': 'resources/startup/640x920.png',
         '768x1004': 'resources/startup/768x1004.png',
         '748x1024': 'resources/startup/748x1024.png',
         '1536x2008': 'resources/startup/1536x2008.png',
         '1496x2048': 'resources/startup/1496x2048.png'
     },
     launch: function() {
         // Destroy the #appLoadingIndicator element
         Ext.fly('appLoadingIndicator').destroy();
         Ext.Viewport.add(Ext.create('HzyApp.view.Main'));
     },
    //html5缓存更新
     onUpdated: function() {
         Ext.Msg.confirm(
             "更新",
             "系统已经自动更新到最新版本，是否重新加载？",
             function(buttonId) {
                 if (buttonId === 'yes') {
                     window.location.reload();
                 }
             }
         );
     }
 });

Ext.define('HzyApp.view.Main', {
     extend: 'Ext.tab.Panel',
     alias: 'widget.main',
     requires: [
         'Ext.TitleBar',
         'HzyApp.view.message.Main',
         'HzyApp.view.history.Main',
         'HzyApp.view.favorite.Main',
         'HzyApp.view.system.Main',
         'HzyApp.view.user.Main'
     ],
     config: {
         id: 'hzyAppViewMain',
         fullscreen: true,
         tabBarPosition: 'bottom',
         items: [{
             xtype: 'messagemain'
         }, {
             xtype: 'systemmain'
         }, {
             xtype: 'favoritemain'
         }, {
             xtype: 'historymain'
         }, {
             xtype: 'usermain'
         }]
     }
 });

Ext.define('HzyApp.view.favorite.Main', {
     extend: 'Ext.NavigationView',
     alias: 'widget.favoritemain',
     config: {
         title: '收藏夹',
         iconCls: 'favorites',
         autoDestroy: false,
         defaultBackButtonText: '返回',
         navigationBar: {
             items: [
                 {
                     iconMask: true,
                     iconCls: 'refresh',
                     action: 'refreshKB',
                     align: 'right'
                 },
                 {
                     hidden: true,
                     iconMask: true,
                     iconCls: 'chat',
                     action: 'toreply',
                     align: 'right'
                 },
                 {
                     hidden: true,
                     iconMask: true,
                     iconCls: 'compose',
                     action: 'toscore',
                     align: 'right'
                 }
             ]
         },
         items: [
             {
                 html: 'This will display favorite urls！'
             }
         ]
     }
 });

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

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

cd /path/to/www/myapp
sencha 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 chen
What is the name of your organizational unit?
  [Unknown]: it
What is the name of your organization?
  [Unknown]: hzy
What is the name of your City or Locality?
  [Unknown]: jiaxing
What is the name of your State or Province?
  [Unknown]:  zhejiang
What is the two-letter country code for this unit?
  [Unknown]:  CN
Is CN=Patrick Chu, OU=Training, O=Sencha, L=Redwood City, ST=California, C=US correct?
  [no]:  y

Generating 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=CN
Enter 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吧，哈哈

(注意：有时候打包会报错，要注意配置文件中的路径，配置文件使用的是"/"斜杠，而windows地址使用的是"\"斜杠，在写地址时如果斜杠搞错方向就无法打包成功)

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

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

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

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