Getting the Code

This entry is part 2 of 8 in the series Dojo Quick Start Guide

Note: The Dojo Quick Start Guide posts – while still relevant – are a bit dated. Please visit http://dojotoolkit.org/documentation/ for expert tutorials and API documentation to help you get up and running with Dojo.

Download the newest released version of the Dojo Toolkit. Or find a previous release if necessary.

The optimized “built” version is: dojo-release-x.y.z.zip, where x, y, and z are major, minor, and point release numbers, respectively. Or to run the complete suite of tests, you should download the SDK or -src version of Dojo.

Unpack the contents of the archive into a folder (preferably on a web server as this is always a good case for Ajax development). Let’s call it “js/”. You may also name your dojo directory “dojotoolkit” as the examples here will show. If you wish to version Dojo, you may leave it as dojo-release-x.y.z. You should now have a directory structure similar to this:

Dojo Source tree view

The most important thing to know when installing the Dojo Toolkit is where your copy of dojo.js is located. The package system handles the loading of all other dependencies and modules, once dojo.js has been loaded into the page.

You can verify your download and install is working by pointing your web browser to http://localhost/js/dojotoolkit/dojo/tests/runTests.html or browse the Dijit test pages at http://localhost/js/dojotoolkit/dijit/tests/

The Dojo Reference Guide, a freely available collection of guides and tutorials, provides a more in-depth description of the various ways to get the Dojo source and about the different releases available.

Bookmark and Share

7 Responses to “Getting the Code

  1. Gil says:

    Hi. Just downloaded dojo-release-1.3.2.zip, and I couldn’t find runTests.html anywhere. Any ideas?

  2. Saurabh says:

    Even i downloaded this and i could not find util folder in release version. also noe tests folder in dojo… Lot of other files seems missing too..
    Any ideas?

  3. Sergi says:

    Hi Gil and Saurabh it seems that the correct package to be downloaded is dojo-release-1.3.0-src.tar.gz. This one contanins dojo/tests and dijit/tests directories. The other package is a light production package.

    Hope that it helps ;)

  4. Fredrik says:

    To be even more specific. If you want to test with runTests.html you can NOT download the file without “src” in it.

    Download:
    dojo-release-1.4.0-src.tar.gz or
    dojo-release-1.4.0-src.zip

    And you find it here:
    http://download.dojotoolkit.org/release-1.4.0/

  5. Amr Darwish says:

    I would suggest to access http://download.dojotoolkit.org as a first step to get the latest version.

  6. Dylan says:

    Thanks for the suggestions, I’ve updated the guide to explain the difference between src and built versions of Dojo, and to update the links to be relevant to every release.

  7. argmin says:

    Great tutorial!

    Not all the tests work from runTests.html worked for me. I thought it would be great if you guys can use your expertise to explain the important tests that “must” work for a minimalistic dojo working on the webserver … so that beginners like me can keep learning without worrying too much :)

Tell Us What You Think

*
*