Cmd

显示私有类

App Build Process 内部

Sencha Cmd 提供的构建脚本是将 Sencha Cmd 的许多底层功能（例如编译器）捆绑在一起并实现自动化的组件。构建很少有万能的解决方案，因此构建脚本提供了许多选项来配置和自定义其行为。本指南将解释构建脚本背后的原理，以及您在需要定制构建过程以满足您的需求时应查看的位置。

先决条件

建议在继续阅读之前阅读以下指南

简介

在内部，sencha app build 命令执行基本验证并调用应用程序根目录 "build.xml" 中找到的 Apache Ant 构建脚本。具体来说，它调用此脚本的 "build" 目标。这意味着可以检查、扩展甚至修改整个构建过程。

由于 sencha app build 只是调用 Ant "build.xml" 文件的 "build" 目标，因此您可以等效地直接从 Ant 调用构建。这在 Eclipse 和 NetBeans 等 IDE 中调用构建以及在了解 Ant 的持续集成服务器（几乎所有服务器）中都很有用。

生成的 build.xml 是一个最小的 Ant 脚本，它使用 Ant import 任务导入 .sencha/app/build-impl.xml 以及其他几个文件。虽然 build.xml 旨在在生成后进行编辑，但 .sencha/app/*-impl.xml 文件不是。这些文件将被 sencha app upgrade 替换，不应编辑。这些文件非常适合参考，但不应修改，除非绝对必要。

构建目标

以下目标定义了从开始到结束的应用程序构建过程。除了 init 之外，每个目标都有一个属性可以设置为 1 以禁用该步骤。

init
refresh
resolve (默认为 1；设置 skip.resolve=0 以启用)
js
resources
sass
slice
page
native-package

除了 init 之外，这些目标中的每一个都可以通过使用以 "skip." 为前缀的目标名称的构建属性（见下文）从默认构建中删除。例如，要禁用 slice 目标

skip.slice=1

如果只需要该部分，也可以单独运行这些步骤。这通常对于仅重建 Sass 非常有用

sencha ant sass

注意： 如果您安装了 Ant 1.8 或更高版本，使用 sencha ant 相当于使用您自己的 Ant 版本。

配置

sencha app build 背后的构建脚本的大多数方面都由属性控制，这在 Ant 中很典型。在这种情况下，有两种属性：配置属性和构建属性。

配置属性

Sencha Cmd 配置属性可用于构建脚本，但也驱动 Sencha Cmd 的许多其他功能（如编译器）。要查看当前配置属性集，请运行以下命令

sencha diag show

在大多数情况下，您可以通过其前缀来判断每个属性的来源

app. -- 请参阅 "app.json" 和 ".sencha/app/sencha.cfg"。
workspace. -- 请参阅 "workspace.json" 和 ".sencha/workspace/sencha.cfg"。
framework. -- 请参阅 Ext JS 或 Sencha Touch SDK 中的 "cmd/sencha.cfg"。
cmd. -- 请参阅 Sencha Cmd 安装文件夹中的 "sencha.cfg"。

配置属性的使用比构建过程广泛得多，并在高级 Sencha Cmd 中详细讨论。

构建属性

构建脚本定义了许多其他特定于构建的属性。这些构建属性通常以 "build." 为前缀。

要查看这些属性的当前值，您可以从您的应用程序文件夹运行以下命令

sencha ant .props

设置构建属性

有很多方法可以配置构建属性。最简单的方法是编辑构建属性文件之一。要决定编辑哪个文件，了解每个文件的优先级以及在什么条件下加载它们很有帮助。

"local.properties" -- 如果存在，则首先加载此文件。此文件旨在仅在本地应用（到本地计算机）。它不应提交到源代码控制以供他人使用。这些设置优先于其他属性文件中以及当前配置属性中定义的任何属性。
Sencha Cmd 配置属性
".sencha/app/${build.environment}.properties" -- 根据 build.environment 属性的值，将加载以下文件中的一个。在这些文件中设置属性允许您根据正在运行的构建类型为属性设置不同的值。
- ".sencha/app/native.properties"
- ".sencha/app/package.properties"
- ".sencha/app/production.properties"
- ".sencha/app/testing.properties"
".sencha/app/build.properties" -- 这些属性接下来加载，并且优先级低于特定于构建环境的属性。这些是所有（或大多数）环境使用的属性。此文件用于自定义。
".sencha/app/defaults.properties" -- 这些属性是要加载的最后一个（默认）值。此文件由 Sencha Cmd “拥有”，并且每次发布新属性时都会更新。此文件用作已定义构建属性集的参考，但不应编辑；请编辑任何其他文件。

优先级高于 "local.properties" 的唯一属性是通过命令行传入的属性。

自定义

许多常见需求通过构建属性来解决，但不可能以这种方式解决所有用例。当配置选项无法完成任务时，下一个级别的自定义是扩展生成的 "build.xml" Ant 脚本。

除了 import 任务之外，"build.xml" 还包含一个注释块，描述了许多可用的扩展点。这些扩展点采用可选的 Ant 目标形式，并以其构建过程步骤命名，但带有 "-before-" 和 "-after-" 前缀。最常见的扩展点是以下这些

init
- -before-init
- -after-init
refresh
- -before-refresh
- -after-refresh
resolve
- -before-resolve
- -after-resolve
js
- -before-js
- -after-js
resources
- -before-resources
- -after-resources
sass
- -before-sass
- -after-sass
slice
- -before-slice
- -after-slice
page
- -before-page
- -after-page
native-package
- -before-native-package
- -after-native-package

要在任何构建步骤之前或之后执行其他处理，请将适当命名的目标添加到 "build.xml"。这些目标将由 sencha app build 调用。如果您使用 Ant 直接调用特定目标，也会调用这些目标。

这些扩展点的常见用途之一是对 "all-classes.js" 文件中的构建输出进行后处理。例如，使用一些预定义的 Ant 任务，我们可以在生成的文件生成后在其上放置版权标题

<target name="-after-page">
    <tstamp>
        <format property="THISYEAR" pattern="yyyy"/>
    </tstamp>

    <!--
    The build.classes.file property holds the full path to the "all-classes.js"
    file so we use that variable rather than hard-code the name.
    -->
    <move file="${build.classes.file}" tofile="${build.classes.file}.tmp"/>

    <concat destfile="${build.classes.file}">
        <header filtering="no" trimleading="yes">
/*
 * Copyright (C) ${THISYEAR}. All Rights Reserved.
 * My Company Name
 */
        </header>
        <fileset file="${build.classes.file}.tmp"/>
    </concat>

    <delete file="${build.classes.file}.tmp" />
</target>

目录

术语、图标和标签

访问级别

成员类型

成员语法

成员标志

类图标

成员图标

导航和功能

类成员快速导航菜单

Getter 和 Setter 方法

历史记录栏

搜索和过滤器

API 文档类元数据

展开和折叠示例及类成员

桌面 -vs- 移动视图

查看类源码

Cmd

目录