Answered: Docs appalling - how to actually get started?
Trying to get up and running with Touch has been a terrible experience. The quick start applies to 1.x:
The getting started page gives confusing (and conflicting?) information and requires the SDK Tools:
SDK Tools don't work (incorrect directory error), which apparently is because we require CMD (only discovered through Googling the SDK error message):
...which links to a page which links to a post which links to the docs which says I need JRE and Compass...
Seriously? Just to get started?
I just want to be able to do a quick 'Hello World' and I'm tearing my hair out because I don't even know if I'm following the right install instructions.
So is there an up-to-date guide? Can I get a bullet list?
Posted by bricemason
You will need:
Sencha Touch 2.1
This is the actual framework and can be downloaded here: http://www.sencha.com/products/touch/download/
Sencha Cmd 3.0
This is the system used to generate and build your Sencha Touch 2.1 apps. You can get that here:
There are some supporting tools that will need to exist on your system:
If you had previously installed the Sencha SDK Tools, I'd recommend uninstalling that first before installing Sencha Cmd as they share the same command 'sencha'.
- Ruby - Use this to install SASS and Compass if not already on your machine. If you're on Windows, you'll need to download Ruby. If you're on a Mac, it's already there.
- SASS - Manages the styles/theming of Sencha Touch, install this using Ruby
- Compass - Based on SASS, install this using Ruby
- JRE - Java is required for the Sencha Cmd
- Ant - Sencha Cmd is based on Ant
- A web server running locally for testing
- A modern browser to test in such as Google Chrome or Apple Safari
Once you have everything installed:
That's the 'hello world' app that is auto-generated.
- Open a command line
- Change directory to the root of your sencha touch 2.1 library
- Run the command sencha generate app MyApp [pathToTheApp] where [pathToTheApp] is a path to a web serverable directory. MyApp is the name of the application (it can be whatever you like)
- Run the app in your browser.
Try it out, if it fails post a reply with the errors you get or questions you have. There are a good group of people on this forum ready to help.