1. #1
    Sencha User
    Join Date
    May 2011
    Location
    Northern California
    Posts
    255
    Vote Rating
    17
    BillHubbard has a spectacular aura about BillHubbard has a spectacular aura about BillHubbard has a spectacular aura about

      0  

    Default Where to start?

    Where to start?


    Is the JS Builder tool documented anywhere? All I've been able to find so far is a couple of readme files. It would be nice to have some examples, a getting started guide, and just some basic information about how the tool works. I must be overlooking something....

  2. #2
    Sencha User
    Join Date
    Feb 2009
    Posts
    2
    Vote Rating
    0
    kurt2305 is on a distinguished road

      0  

    Default where to start ?

    where to start ?


    The same question with you

  3. #3

  4. #4
    Sencha User
    Join Date
    May 2011
    Location
    Northern California
    Posts
    255
    Vote Rating
    17
    BillHubbard has a spectacular aura about BillHubbard has a spectacular aura about BillHubbard has a spectacular aura about

      0  

    Default


    Thanks for the reply, but that's basically where I started. There's a lot of assumptions in those sources, and not enough foundational information to glean an understanding.
    The Getting Started guide alludes to the SDK Tools download (beta), which is described as a compressed file that needs to be extracted under htdocs/extjs under the Apache folders, but what I got was a Windows installer for version 1.2.3 that doesn't appear to generate any index.html file that can be found at http://localhost/extjs/index.html like the docs indicate.
    Furthermore, after installing the tools, I try to make sense of the command shown in the guide:

    Code:
    sencha create jsb -a index.html -p app.jsb3
    But this doesn't fit with my environment, as there is no static index.html file to refer to. I am working with a complex system that embeds ExtJS apps within various pages, and the apps are all built using the MVC architecture. I tried to run the command on a standalone sample app that I built, and I just get errors, like:
    Code:
    undefined:0 ReferenceError: Can't find variable: jQuery
    undefined:0 ReferenceError: Can't find variable: Ext
    undefined:0 ReferenceError: Can't find variable: Sjs
    [ERROR] Ext is not defined, please verify that the library is loaded properly on the application's page
    undefined:0 ReferenceError: Can't find variable: Ext
    There just isn't enough information available for me to determine what it's doing, what it's expecting, how to use it within my environment, and how I can manipulate it to work within my environment. And I need to figure it out real soon here, as we're approaching a December product release.

    P.S. It would be good to have a reference app to run the tools against so I could at least get a look at the resulting output (JSB3 files?) to give me a point of reference to understand what this tool does.

  5. #5
    Sencha Premium Member
    Join Date
    Sep 2008
    Posts
    710
    Vote Rating
    6
    Bucs is on a distinguished road

      0  

    Default


    Wow, been away from ExtJS for a while and although all the changes look great, it's obvious that Sencha still suffers from a huge lack of appropriate documentation. If you are going to build an mammoth ext-all.js core file (over a meg now), knowing most newbie devs are just going to drop that file into their project and start developing, and then just "expect" they are going to find there way around the sparse documentation on JSBuilder to build the appropriately sized file for their project, you are sorely mistaken. Result...huge, fat-arse programs that won't hold a candle to your competitors in terms of speed and delivery times.

    Why is it so hard for Sencha to put together a comprehensive doc on using JSBuilder in Mac and Windows? Why do you insist on having everyone scour the web for the slightest of hints in order to use this product? It's really hard to believe the shortsightedness exhibited by Sencha on this topic...

  6. #6
    Sencha - Ext JS Dev Team evant's Avatar
    Join Date
    Apr 2007
    Location
    Sydney, Australia
    Posts
    17,065
    Vote Rating
    659
    evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute evant has a reputation beyond repute

      0  

    Default


    Not really sure what you mean, the builder, along with a tutorial/explanation is in the getting started guide:

    http://docs.sencha.com/ext-js/4-0/#!...etting_started
    Evan Trimboli
    Sencha Developer
    Twitter - @evantrimboli
    Don't be afraid of the source code!

  7. #7
    Sencha User bclinton's Avatar
    Join Date
    Nov 2007
    Posts
    285
    Vote Rating
    9
    bclinton will become famous soon enough

      0  

    Default


    Quote Originally Posted by evant View Post
    Not really sure what you mean, the builder, along with a tutorial/explanation is in the getting started guide:

    http://docs.sencha.com/ext-js/4-0/#!/guide/getting_started
    For the sake of making things easier to find, it might make sense to move the Deployment section from the Getting Started guide to its own section. I think many people reading the Getting Started guide get to the deployment section and think "I'll worry about that later." Then, when it's actually time to deploy their app, the Getting Started guide has receded far in the rear view mirror. It just doesn't seem logical to have a a passage that is basically about "Finishing up" in the "Getting Started" section of the docs.

  8. #8
    Sencha User
    Join Date
    May 2011
    Location
    Northern California
    Posts
    255
    Vote Rating
    17
    BillHubbard has a spectacular aura about BillHubbard has a spectacular aura about BillHubbard has a spectacular aura about

      0  

    Default


    Pretend that someone encountering this tool for the first time knows nothing about it. I think you guys are so close to the trees, you can't see the forest. The information in the getting started guide isn't even enough to get me started. There is zero visibility into this tool, and every attempt I have made to use it has failed with errors, with no reference info anywhere as to why, what to look for, how to troubleshoot it, etc., etc. and etc. It's very frustrating. I've opened a support ticket and have gotten no more input than I have received here.

    The getting started guide shows little more than a couple of commands...that do who-knows-what. There is no reference example that comes with the tool, I'm completely in the dark about what a "JSB" file is and what it contains or what its purpose is, and I can't understand why this is treated like a black box.

    This is as far as I have ever been able to get:
    Code:
    D:\temp\sencha>sencha create jsb -a http://localhost/Saba/Web/Social -p app.jsb3 
    [ERROR] Ext is not defined, please verify that the library is loaded properly on  the application's page undefined:0 ReferenceError: Can't find variable: Ext
    Dead end. Where do I go from here?

  9. #9
    Sencha User bclinton's Avatar
    Join Date
    Nov 2007
    Posts
    285
    Vote Rating
    9
    bclinton will become famous soon enough

      0  

    Default


    Quote Originally Posted by BillHubbard View Post
    I'm completely in the dark about what a "JSB" file is and what it contains or what its purpose is, and I can't understand why this is treated like a black box.
    Have you seen this thread? http://www.sencha.com/forum/showthre...l=1#post641450

    The 11th post (top of the second page) has an example of what a JSB file looks like. It's basically just a list of files that gets used by the "sencha create" command when it combines and compacts your .js files into one file and obfuscates your code. In that example, his file array is empty. It should be an array of file objects that looks something like this:

    Code:
                "files": [
                    {
                        "path": "app/model/",
                        "name": "Product.js"
                    },
                    {
                        "path": "app/store/",
                        "name": "Products.js"
                    },
                    {
                        "path": "app/view/product/",
                        "name": "Products.js"
                    },
                    {
                        "path": "app/controller/",
                        "name": "Products.js"
                    }
                ]
    Theoretically you could just make this file by hand, especially if your project is small. Then you could move on to the next step and maybe you will be able to get the "sencha create" command working.

    Quote Originally Posted by BillHubbard View Post
    This is as far as I have ever been able to get:
    Code:
    D:\temp\sencha>sencha create jsb -a http://localhost/Saba/Web/Social -p app.jsb3 
    [ERROR] Ext is not defined, please verify that the library is loaded properly on  the application's page undefined:0 ReferenceError: Can't find variable: Ext
    Dead end. Where do I go from here?
    Well, it obviously seems like some kind of path problem or script src include syntax issue. There are a few people who've had the same issue in the thread I linked and perhaps one of their solutions will work for you. On Windows servers, authentication seems to be a common culprit. If you continue to have trouble with it, perhaps you should post the HTML source of your http://localhost/Saba/Web/Social page.

  10. #10
    Sencha User
    Join Date
    May 2011
    Location
    Northern California
    Posts
    255
    Vote Rating
    17
    BillHubbard has a spectacular aura about BillHubbard has a spectacular aura about BillHubbard has a spectacular aura about

      0  

    Default


    Thanks, that was very helpful.
    As an experiment, I created a jsb3 file by hand and was able to generate a script file. But the deployment version is not getting compressed or obfuscated, even though I specified "compress": true in the JSON.
    Is there any documentation that describes all the features and options that can be specified in a JSB3 file? It took some experimentation to determine what the relative paths were relative to, and I'm not clear on what goes under "resources".

    It seems the problem in my environment is authentication. At least that's the problem at the front door. And I have no way around that, so the sencha create command is going to be of no use to me - I'm going to have to figure out some other way to generate and manage JSB3 files. As for figuring out what script files to create and what sources go into them, I'm probably on my own there, considering the complexity of our application. It seems Sencha is centered around a single SPI concept. It's a whole different ball game entirely when you're dynamically embedding ExtJS apps within a very large application...