Hybrid View

  1. #1
    Sencha User
    Join Date
    Dec 2012
    Posts
    11
    Vote Rating
    6
    airaid is on a distinguished road

      5  

    Default Answered: Docs appalling - how to actually get started?

    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:

    http://www.sencha.com/learn/sencha-touch-quick-start/

    The getting started page gives confusing (and conflicting?) information and requires the SDK Tools:

    http://www.sencha.com/learn/getting-...rted-section-3

    SDK Tools don't work (incorrect directory error), which apparently is because we require CMD (only discovered through Googling the SDK error message):

    http://www.sencha.com/forum/showthre...om-the-install

    ...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?

  2. 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:
    http://www.sencha.com/products/sencha-cmd/download

    There are some supporting tools that will need to exist on your system:
    • 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
    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'.

    Once you have everything installed:
    1. Open a command line
    2. Change directory to the root of your sencha touch 2.1 library
    3. 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)
    4. Run the app in your browser.
    That's the 'hello world' app that is auto-generated.

    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.

    Brice

  3. #2
    bricemason's Avatar
    Join Date
    Jan 2008
    Location
    Upstate NY
    Posts
    280
    Answers
    49
    Vote Rating
    44
    bricemason has a spectacular aura about bricemason has a spectacular aura about bricemason has a spectacular aura about

      6  

    Default


    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:
    http://www.sencha.com/products/sencha-cmd/download

    There are some supporting tools that will need to exist on your system:
    • 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
    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'.

    Once you have everything installed:
    1. Open a command line
    2. Change directory to the root of your sencha touch 2.1 library
    3. 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)
    4. Run the app in your browser.
    That's the 'hello world' app that is auto-generated.

    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.

    Brice
    Brice Mason
    Front End Developer
    Modus Create

    @bricemason
    bricemason.com

    Sencha Touch Screencasts
    Vimeo - Sencha Touch Channel

    Github Projects:
    Sencha Cordova Builder enables the automatic creation, building, and running of PhoneGap (Cordova) projects with Sencha Touch.

    Am I Sencha Touch Ready? checks your system to determine what you need to do to start Sencha Touch development. If you're having trouble getting up and running, try this out.

    Sencha Tools Bridge allows Sencha SDK Tools to co-exist with Sencha Cmd on the same system.

  4. #3
    Sencha User
    Join Date
    Dec 2012
    Posts
    11
    Vote Rating
    6
    airaid is on a distinguished road

      1  

    Default


    Brice, I'm hugely grateful. That's the most concise list of requirements I've seen and a lot more useful than any official docs I could find.

    I think I'm up and running, I've managed to generate an app and build a production version which has got to be a good start. Now I need to learn how to use it

    Thanks again.

  5. #4
    bricemason's Avatar
    Join Date
    Jan 2008
    Location
    Upstate NY
    Posts
    280
    Answers
    49
    Vote Rating
    44
    bricemason has a spectacular aura about bricemason has a spectacular aura about bricemason has a spectacular aura about

      1  

    Default


    That's great, glad to hear you're able to start digging in. Now that you've started coding, I have found the guides to be helpful to get started:

    http://docs.sencha.com/touch/2-1/#!/guide

    Keep using the forums too, I have found them very helpful.

    Brice
    Brice Mason
    Front End Developer
    Modus Create

    @bricemason
    bricemason.com

    Sencha Touch Screencasts
    Vimeo - Sencha Touch Channel

    Github Projects:
    Sencha Cordova Builder enables the automatic creation, building, and running of PhoneGap (Cordova) projects with Sencha Touch.

    Am I Sencha Touch Ready? checks your system to determine what you need to do to start Sencha Touch development. If you're having trouble getting up and running, try this out.

    Sencha Tools Bridge allows Sencha SDK Tools to co-exist with Sencha Cmd on the same system.

  6. #5
    Sencha User
    Join Date
    Dec 2012
    Posts
    10
    Vote Rating
    0
    loren.rogers is on a distinguished road

      0  

    Default


    That's great Brice. But I want to build a downloadable APK for Android. I don't want to run from my Web browser on my device. How do I do this?
    /Loren

  7. #6
    bricemason's Avatar
    Join Date
    Jan 2008
    Location
    Upstate NY
    Posts
    280
    Answers
    49
    Vote Rating
    44
    bricemason has a spectacular aura about bricemason has a spectacular aura about bricemason has a spectacular aura about

      2  

    Default


    If you want to use PhoneGap, you could try out my project which hooks into the the Sencha build process. You can learn more about it here:

    http://bricemason.github.com/sencha-cordova-builder/

    I have two screencasts there, the first is how to use it and the second is how to incorporate phonegap plugins in the build process if you should need them.

    You can also use the Sencha native build process, here is a link to the docs for that:

    http://docs.sencha.com/touch/2-1/#!/...tive_packaging

    Brice
    Brice Mason
    Front End Developer
    Modus Create

    @bricemason
    bricemason.com

    Sencha Touch Screencasts
    Vimeo - Sencha Touch Channel

    Github Projects:
    Sencha Cordova Builder enables the automatic creation, building, and running of PhoneGap (Cordova) projects with Sencha Touch.

    Am I Sencha Touch Ready? checks your system to determine what you need to do to start Sencha Touch development. If you're having trouble getting up and running, try this out.

    Sencha Tools Bridge allows Sencha SDK Tools to co-exist with Sencha Cmd on the same system.

Thread Participants: 2