sencha touch 入门系列 (六)sencha touch运行及代码解析(下)

 接着上一讲,通过index.html里development.js对app.json里js资源文件的解析,app.js便被index.html引入了,

 app.js是整个项目的程序入口,在项目完成时使用sencha cmd打包压缩项目时,默认情况下所有的js文件都会被压缩成一行放置在app.js中,关于项目的打包我们会在后面的课程详细讲解,

 接下来我们来看下app.js,了解下整个项目是如何通过app.js来进行加载的。

  

 1 //用来实例化Ext.app.Application,这是项目中唯一一个只要创建一次且不需要通过Ext.create来进行实例化的类,
 2 //它会在Ext.application内部进行实例化,
 3 //Ext.app.Application用来定义 Models, Controllers, Profiles, Stores 和 Views模块类文件的集合,
 4 //当定义的这些文件被载入完毕时会触发里面的launch方法,
 5 //我们一般在launch方法中创建我们的主视图
 6 Ext.application({
 7 
 8     //name属性表示项目名称,这个名称不能有空格也不能有标点符号,
 9     //它将作为整个项目的全局命名空间,所有的类文件都必须以它开头,例如在这里我们的name为MyFirst,
10     //那么当我们定义其他类文件的时候 就必须用'MyFirst.model.User', 'MyFirst.controller.Users', 'MyFirst.view.Main' 等等
11     name: 'MyFirst',
12 
13     //因为我们调用的是sencha-touch.js核心库,所以当你需要使用的功能不在核心库中的时候
14     //我们需要使用requires来引入该功能对应的js文件,当我们使用用sencha cmd打包压缩项目文件时,cmd工具会自动关联该js文件并将其内容打包到
15     //app.js中,虽然在开发过程中,不引入对应的js文件程序能够正常运行,程序在找不到指定js的时候会到touch文件夹下去自动查找源码文件关联,
16     // 但在浏览器的console窗口中会报警告,且在最终打包项目后程序将无法运行,所以开发过程中确保你的浏览器窗口中没有requires的警告
17     // 使用requires还有一个作用就是延迟加载,
18     //requires属性可以在所有的类文件中定义,当使用了requires属性的类被实例化时,如果该类中requires的js没有被加载这时就会立刻加载该requires的js文件
19     requires: [
20         'Ext.MessageBox'
21     ],
22 
23     //引入视图组件类文件
24     views: [
25         'Main'
26     ],
27 
28     //定义应用程序图标,sencha cmd打包安装程序时有效
29     icon: {
30         '57': 'resources/icons/Icon.png',
31         '72': 'resources/icons/Icon~ipad.png',
32         '114': 'resources/icons/Icon@2x.png',
33         '144': 'resources/icons/Icon~ipad@2x.png'
34     },
35 
36     //设定ios图标的镜面效果
37     isIconPrecomposed: true,
38 
39     //设定应用程序启动图,这个属性只支持ios设备
40     startupImage: {
41         '320x460': 'resources/startup/320x460.jpg',
42         '640x920': 'resources/startup/640x920.png',
43         '768x1004': 'resources/startup/768x1004.png',
44         '748x1024': 'resources/startup/748x1024.png',
45         '1536x2008': 'resources/startup/1536x2008.png',
46         '1496x2048': 'resources/startup/1496x2048.png'
47     },
48 
49     //当application定义的资源文件都载入完毕时,
50     //会调用launch函数
51     launch: function() {
52         // 销毁启动动画,项目启动时的那三个闪烁点,可根据情况需要进行修改
53         Ext.fly('appLoadingIndicator').destroy();
54 
55         // 初始化主视图文件,在这里创建了view文件夹下的Main视图并添加到
56         //viewport视口中,viewport继承自container,默认全屏属性和card布局
57         //在项目启动时自动创建
58         Ext.Viewport.add(Ext.create('MyFirst.view.Main'));
59     },
60 
61     //项目使用sencha cmd的sencha app build production指令打包成webapp时会生成html5离线缓存文件
62     //当项目第一次访问后就会将项目缓存到本地,用户可以离线访问,
63     //在服务端的代码进行修改后重新打包成production发布时,浏览器端检测到代码更新后会调用
64     //该方法提示用户是否更新,确认更新后页面会自动刷新并缓存最新内容
65     onUpdated: function() {
66         Ext.Msg.confirm(
67             "Application Update",
68             "This application has just successfully been updated to the latest version. Reload now?",
69             function(buttonId) {
70                 if (buttonId === 'yes') {
71                     window.location.reload();
72                 }
73             }
74         );
75     }
76 });

 

Ext.application中用来定义Models, Controllers, Profiles, Stores 和 Views模块类文件的集合,

sencha cmd生成的项目代码中暂时只定义了view视图的资源文件,

views: [
        'Main'
    ],

这相当于在全局的命名空间下,给指定的文件名增加了一个子命名空间view,

所以这段代码对应的文件是定义的名称为MyFirst.view.Main类文件,

注意:文件夹下的js文件以及类名一定要对应,否则在启动项目时将找不到对应的js文件

例如我定义的类Ext.define("MyFirst.view.Main"),那么程序会到view文件夹下去查找Main.js文件,如果名称不匹配,那么会查找不到文件并报错

即app文件夹下的view文件夹下的Main.js文件,

如果我们定义的views如下:

views: [
        'my.Main'
    ]

那么,在application初始化的时候会到MyFirst项目下的app目录下的view文件夹下的my文件夹查找文件,按照层级结构来查找

默认情况下,这段代码定义的文件会去访问查找app文件夹下去查找对应文件夹,

你也可以通过在Ext.application里定义appFolder属性来重新指定这个文件夹,

例如我设定appFolder:"test",

那么上面的views属性定义的内容我们的程序将会到test文件夹下去查找

 

Main.js也就是创建我们打开项目时所看到的那个界面的文件了,

这个文件我们先不讲解,在没有对js的类文件系统有一定得了解前,有些内容可能难理解,

所以下一讲我们会详细介绍sencha touch的类系统,以便接下来我们对model,view,store,profile,controller这些模块的学习

posted on 2014-03-20 10:12  想啦牛肉面  阅读(1375)  评论(1编辑  收藏  举报

导航