Architect 2 Sencha Docs

Release Notes for Architect 2.2.3

Sencha Architect 2.2.3 Build 1044 is the latest release of the Sencha Drag-and-Drop development tool for developing HTML5 applications that run on desktop and mobile platforms. The primary feature of this release is to support development of Sencha Touch 2.3 apps.

Sencha Framework Support

Sencha Architect 2.2.2 Build 1044 supports the following Sencha Frameworks versions:

  • Ext JS 4.0.x, 4.1.x, and 4.2.x for desktop apps
  • Sencha Touch 2.0.x, 2.1.x, 2.2.x, and 2.3 for mobile apps

See the Release History at the end of this guide for details about framework and Sencha Cmd support in earlier builds of Sencha Architect 2.2.

Supported Platforms

Sencha Architect 2.2 is available for these platforms:

  • Microsoft Windows (XP SP2 and all later releases) (32-bit and 64-bit)
  • Apple Mac OS X 10.6 (Snow Leopard) or newer (32-bit and 64-bit)
  • Ubuntu Linux 10.04 or newer, other equivalent Linux distributions (32-bit and 64-bit)

Note that Sencha Architect uses Chromium and so is constrained by its system requirements.

Downloading and Launching Architect 2.2

Download Architect 2.2 for Windows, Mac/OSX, 32-bit Linux, or 64-bit Linux here.

Architect 2.2.x for Linux systems is distributed as a .run file. To install, you must make the .run file you download executable either by right-clicking the file and selecting "Execute" under the "Permissions" tab or with the chmod +x command. Note that, on Linux systems, the Sencha Architect icon may not display properly in the desktop. This does not affect functionality.

The downloadable packages for Sencha Architect contain the latest stable build, including all enhancements and bug fixes that have been implemented and tested for this release. As we issue updated builds, the autoupdate feature prompts you to update your installed software. All customers running Sencha Architect with a valid license (including a trial license) are prompted to install the updated software when they launch Architect. For details about the released builds, see the Change Log.

View the Architect 2.2 documentation here.

Sencha Touch 2.3 Features

Architect 2.2.3, Build 1044 supports Sencha Touch 2.3 features. See the following for details:

The following features are of particular interest to Architect users:

  • Support for Cmd 4 native packaging and simulating, and supports sencha app build native
  • Support for new iOS7 and Android themes: Cupertino (iOS7), CupertinoClassic (pre-iOS7), and MountainView (Android)
  • Support for Internet Explorer 11

Not Supported in Architect 2.2.3

The following Sencha Touch 2.3 features cannot be accessed using Sencha Architect 2.2.3:

  • Support for BlackBerry 10 controls
  • Support for Touch Grids
  • Support for new mobile packaging using Cordova and PhoneGap
  • Support for Sencha Cmd 4 Cordova, PhoneGap, sencha app watch, sencha app refresh, and sencha app resolve

Supporting these features required fundamental modifications to the Sencha Architect infrastructure. These features will be supported in the upcoming Sencha Architect 3 release.

Continuing Support

Sencha Touch 2.3 continues to support the following Sencha Touch 2.2 features that were supported in earlier versions of Architect 2.2:

  • Support for Internet Explorer 10, including MS Surface Pro&RT and Windows Phone
  • You can switch between built-in themes for your project by going to the Inspector and clicking "Resources" and then "themes".
  • Custom themes created with the enhanced theme creation process can be included in your Architect project using the same method documented below for Ext JS. Note that configs specific to themes and platforms are not currently supported by Sencha Architect.
  • Application icons are handled only via CSS3 font-face rather than WebKit masking. For Architect, this means that iconMask is no longer a config on buttons because it is no longer required for buttons that use iconCls.
  • The ?showfps option can be added to the URL used to preview your application when debugging your application; this displays animation performance information.

Note that Sencha Touch 2.2 includes DOM changes so projects that were originally built for earlier versions of Touch 2.x may require some CSS tweaks such as increasing the value of the item-height config.

Earlier Architect 2.2 features

Architect 2.2.3 continues to support a number of features provided in all Architect 2.2 releases. See the Architect 2.2 Blog for a functional overview of this release. These features are summarized below.

Features for large-scale, collaborative projects

Architect 2.2 includes a number of features that result in significant performance improvements for large scale projects:

  • "Smart loading" loads only the components you are modifying; the Inspector panel shows which components are being modified within the context of the whole project.
  • The "Build" button is added to build the entire project.
  • The "Save" button now saves only the components you have modified rather than the entire project; for large projects, this greatly reduces the amount of time required to save ones work. For customers upgrading from earlier releases, this means that the function of the "Save" button has changed; any file that you do not load in your session, including files modified outside Architect and included as resources to your project, are incorporated only when you click on "Build", not when you click on "Save".
  • The Directory Watcher feature monitors the file system and project metadata to detect file collisions. When Architect detects a change that does not conflict with the current project, it updates the project; if it finds a conflict with the current project, the user is prompted to resolve it. Beginning with Architect 2.2.2 Build 971, users can disable this feature if they like by opening the "Settings" in the toolbar, selecting the "Application" tab, and chosing "Disable directory watching".

Internal testing on representative large projects indicate that Architect 2.2 uses 66-85% less memory than Architect 2.1 does for the same project. Projects that loaded in 30-50 seconds in Architect 2.1 load in 4-5 seconds on Architect 2.2.

Programming efficiency features

  • The "Quick Open" search box in the Inspector window helps you find and open components more quickly. This is especially useful when working on very large applications
  • The Canvas provides tabs that enable you to more easily move between different areas of your code.
  • The ProcessConfig configuration for Ext JS and the initialize configuration for Sencha Touch allow easier code insertion when creating a component.
  • The class override feature enables you to create overrides for standard components. To implement this, right-click on any item in the toolbox and choose "Create Override for this Class". This creates a JavaScript Resource with a pre-canned file body and the standard override format. The string "override" is prepended to the name so it is obvious that the created class is an override; overrides are stored as subfolders under the myapp/override directory.

Additional Data Features

  • The "Mock Data" feature allows you to pre-populate data as if it were loaded from the server side. This is useful to simulate data for testing when it is difficult or costly to access and store the real data, such as when additional information (such as a login token or geolocation) is required to access the real data. Unlike standard "dummy data" used to test applications, mock data does not appear in the generated code.
  • The createAlias and createClass configs allow easier integration of external resources.

Ext JS 4.2.1 Features

Architect 2.2.2 Build 991 supports Ext JS 4.2.1 features. See the following for details:

The following features are of particular interest to Architect users:

  • RTL (Right-to-Left) text feature
  • New buffered renderer plug-in component for grid panel
  • You can switch between built-in themes for your project by going to the Inspector and clicking "Resources" and then "themes".
  • Custom themes created with the enhanced theme creation process can be included in your Architect project. To add a Custom Theme to your Architect project:
    • Build your Theme package outside Architect using the Sencha Cmd tools; see the Theming Ext JS guide.
    • Select your Theme package from the Library node under Resources and add it as a css resource.
    • Disable css on the Library node under resources.

Sencha Cmd 4 and Sencha Cmd 3.1.2 Features

Sencha Architect 2.2.3 works best with Sencha Cmd 4 although it can be used with Sencha Cmd 3 as well. Cmd 4.0 includes a number of significant features, including:

  • Support for sencha generate workspace and sencha generate package to create a Sencha Architect user extension.
  • Support for sencha app watch that automatically updates applications
  • Internal restructuring of the build scripts so that Ext JS and Touch applications can share a single set of scripts and processes
  • The build properties in the file have been expanded, improved, and documented. The,, and are now used exclusively for user-defined settings.

The Sencha Cmd documentation contain complete information about using Sencha Cmd.

The standalone Cmd 3.1.2 Release notes are at:

Note that Sencha Cmd only works when using the Ext JS 4.1 and later or Sencha Touch 2.1 and later frameworks.

Other features

Architect is built using Sencha Desktop Packager (SDP), thus improving performance. After installing Architect 2.2.2 Build 971 or later, auto-update is enabled for SDP so that it can be updated without reinstalling the full Architect package.

Known Issues in Architect 2.2.3 Build 1044

For more information, see the Known Bugs in Architect 2.2 Forum discussion.

  • Architect does not properly support UTF-8 characters in file names and paths.
  • Projects cannot be saved and loaded to a path whose name uses the standard Linux/Unix home directory path convention such as ~/projects. This may cause the Directory Watcher to arbitrarily remove project files. As a work around, specify the full pathname (for example, /Users/yourname/projects) when saving and loading projects.
  • In an Ext JS 4.2 Architect project, promoting a button's menu can lead to an error.
  • If the user creates a new resource in Architect (for example a my.css CSS resource) and sets the URL config before adding the file to the file system, then Architect will continue to believe it is a new file and overwrite the file on disk. As a workaround, click Reload when viewing the resource code in Architect to load the file into Architect.
  • CSS resources cannot be loaded from a server using a self-signed SSL certificate on Architect 2.2. You can load an external CSS resource using a real certificate or you can use plain HTTP.
  • Extremely rapid clicking between linked components can lead to an error when running Sencha Architect on Windows.
  • You may get a blank screen when you launch Sencha Architect by clicking the Architect icon on the Mac dock or the Launcher on the Linux Unity desktop. This is because Architect has a bootstrap that needs to be run. When you right-click and choose to 'Keep in Dock', it is actually pinning the application rather than the bootstrap, which does not work. On Mac OS X, you can launch Architect from the applications folder, from the Launchpad, or using a launcher such as Spotlight, Alfred, or Quicksilver. On the Linux Unity desktop, you can launch Architect from the dashboard, quicklist, or the desktop.

Known Issues Fixed in Architect 2.2.3 Build 1044

  • Fixed a rendering issue that appeared intermittently on Mac OS X. See the Forum discussion for more information.

Known Issues Fixed in Architect 2.2.3 Build 1039

  • Fixed timing problems that sometimes made saving a project unreliable. See the forum discussion.
  • Fixed issues that caused Architect to crash when it was launched behind a network proxy that uses auth or a .pac configuration.
  • Fixed problems that caused Ext Readers to exclude event bindings.
  • Fixed code generation problems that occurred when adding a listener to or reader. See forum discussion.
  • Fixed problem that required Architect to be restarted for a URL Prefix setting to take effect. See forum discussion.
  • Fixed error that occurred when trying to change the layout of a panel.
  • Boolean columns now have a unique icon. See forum discussion.
  • Visual SourceSafe files are no longer reported as bad metadata.
  • Model Validations now includes a matcher config. See forum discussion.
  • Missing params are added to renderer function of Touch Chart Axis.
  • Architect no longer deletes svn tmp folders. See the forum discussion.
  • Architect now removes region from a floating panel inside a border layout. See the forum discussion.
  • Missing params are added to renderer function of Touch Chart Axis.
  • Problems connecting to the Sencha licensing server using a proxy server have been resolved. If any Windows users experience proxy problems, please contact with your forum user name and MAC address to get an offline license.

Known Issues Resolved in Architect 2.2.2 Build 991

Build 991 resolves the following issues:

  • Problems that surfaced when upgrading a project from Architect 2.2.1 to Architect 2.2 have been resolved. One issue resulted in objects being randomly deleted; see the Forum discussion; another prevented the conversion from happening completely; see the Forum discussion.
  • The "layout" config for the "CheckboxGroup" and "RadioGroup" components is now exposed properly. See the Forum discussion for more background.
  • Fixed the problem that prevented the Directory Watcher dialog from running if the metadata files were modified outside Architect. The Directory Watcher interpreted such changes as invalid metadata.
  • The visual glitch that occurred on tab overflow is corrected.

Known Issues Resolved in Architect 2.2.2 Build 971

Build 971 implemented auto-update for the Sencha Desktop Packager (SDP), the ability to turn off the Directory Watching feature, a more convenient way to close the modal results window when publishing, and fixed several issues discovered for earlier releases:

  • Beginning with Architect 2.2.2 Build 971, Architect disables the UNC paths when the project is saved. This resolves the issue that projects could not be saved and loaded on a network share using Microsoft Windows UNC (Uniform Naming Convention) path names; the Directory Watcher did not work and some project files could be deleted randomly. The work around for earlier releases of Architect 2.2 is to map a network drive to that UNC path.
  • Fixes the problem that caused phantom tab-closures when many tabs were open.
  • Adds the "Plain" value to the Ext.Button UI config. See Forum discussion.
  • Resolves problems creating a function with the same name discussed here.
  • Resolves the issue that a Touch 2.x CheckBox added as a column editor retained its boxLabel value; see Forum discussion.
  • Fixes the Uncaught Reference Error reported on the Forum for Touch 2.2 projects.
  • The pack: justify is now supported for Hbox/Vbox container layout config for Touch 2.2 projects. See Forum discussion.
  • Problems that caused large projects to render slowly when loaded are fixed.
  • You can now get out of the modal results window when publishing by clicking somewhere outside the box rather than having to explicitly close the window. This was requested here.
  • Grid columns that are nested underneath other grid columns (subcolumns) are now sortable. See Forum discussion.
  • Projects that have spaces in class names should now build without error. See Forum discussion for details.
  • Proxy-related problems that sometimes caused Mac OS X to crash when opening Architect have been resolved. See Forum discussion.
  • Resolves issues that sometimes caused Windows systems to crash when opening Architect. If you continue to have problems, please post your information on Sencha Forum.
  • Fixes problems that caused blank previews for Sencha Touch projects on Android and iOS. The changes required modifying how Architect uses Cmd for mobile packaging.
  • The Project Inspector Tree collapse/expand state is now saved. See Forum Discussion.
  • The Directory watcher in Architect now handles temporary metadata files created by other applications.
  • Fixes problems that occasionally caused resources to disappear.
  • Architect now points to the right base library for Touch 2.2.

Release History

Sencha updates Architect 2.2 regularly; each version is identified by build number. The releases issued so far are:

  • Builds 1044 (this release) and 1039 contain critical bug fixes.
  • Build 1035 adds support for Sencha Touch 2.3 with a limited set of its features plus support for Cmd 4 and a few critical fixes.
  • Build 991 implements support for Ext JS 4.2.1 and Sencha Touch 2.2.2 and includes a few critical fixes.
  • Build 971 implements auto-update for the Sencha Desktop Packager and includes a number of critical fixes. It works with:
    • Ext JS JS 4.0.x, 4.1.x, and 4.2.1 for desktop apps
    • Sencha Touch 2.0.x, 2.1.x, and 2.2.0 for mobile apps
    • Sencha Cmd 3.1.1 Build 256 for publishing and packaging mobile apps that run on iOS and Android.
  • Build 951 added support for Sencha Touch 2.2, Sencha Cmd 3.1.1, and includes other fixes and enhancements. It works with:
    • Ext JS JS 4.0.x, 4.1.x, and 4.2.0 for desktop apps
    • Sencha Touch 2.0.x, 2.1.x, and 2.2.0 for mobile apps
    • Sencha Cmd 3.1.1 for publishing and packaging mobile apps that run on iOS and Android.
  • Build 908 fixed critical issues that were found in Build 894.
  • Build 894 was the first Architect 2.2 release. It works with:
    • Ext JS JS 4.0.x, 4.1.x, and 4.2.0 for desktop apps
    • Sencha Touch 2.0.x, and 2.1.x for mobile apps
    • Sencha Cmd 3.1 for publishing and packaging mobile apps that run on iOS and Android.

Sencha Architect 2.1 is still supported; it works with: - Ext JS 4.0.x, 4.1.x for desktop apps - Sencha Touch 2.0.x and 2.1.x for mobile apps - Sencha Cmd 3.0 for publishing and packaging mobile apps that run on iOS and Android.

See the Changelog for a listing of builds and features.