# Dojo 0.4.2rc1 XDomain Web Build Tool

There are two ways to use this xdomain build:

- Use the XDomain Ajax Build directly from this web server. To see what modules are included in the Ajax build, go to the web build tool and select the "ajax" standard profile. You can build that profile and look at the output at the bottom of the page to see all of the files/modules in the build.
- Create a custom dojo.js build using the web build tool, and use the xdomain build on this server to load all other modules and associated files.

## XDomain Ajax Build

To use 0.4.2rc1 XDomain Ajax build, just include this script tag in your page:
<script type="text/javascript" src="http://build.dojotoolkit.org/0.4.2rc1/dojo.js"></script>
There are some modules that require some special setup to use in the xdomain build:

### Widget automatic loading

- xdomain loading does not support automatic loading of Dojo or custom widgets. You must explicitly include widgets you want to use by using dojo.require() statements for widgets you want to use.

### dojo.debugDeep()

- Save src/debug/deep.html to your local server and set djConfig.dojoDebugDeepHtmlUrl to the location of that file.

### dojo.flash

- This module uses document.write(), so you must do a custom web build that includes the following modules to use it:

- dojo.event.*
- dojo.flash

### dojo.io.createIFrame()

- Save iframe_history.html to your local server and set djConfig.dojoIframeHistoryUrl to the location of that file.

### dojo.rpc.YahooService

- Save yahoo.smd to your local server and set djConfig.yahooServiceSmdUrl to the location of that file.

### dojo.storage

- This module uses document.write(), so you must do a custom web build that includes the following modules to use it:

- dojo.event.*
- dojo.storage

### dojo.undo.browser

- Save iframe_history.html to your local server and set djConfig.dojoIframeHistoryUrl to the location of that file.
- If you do a custom build using the web tool and want to use dojo.undo.browser, be sure to include it in dojo.js. Do not load it after dojo.js loads, otherwise it will not work.

### dojo.widget.GoogleMap

- Does not seem to work even if you include dojo.widget.GoogleMap in a custom build.

### dojo.widget.Editor2, dojo.widget.Editor, dojo.widget.RichText

- Save richtextframe.html to your local server and set djConfig.dojoRichTextFrameUrl to the location of that file.

More information on XDomain builds: Cross Domain Resource Loading. If you use the dojo.js URL above for the xdomain ajax build, you do not need to set any djConfig parameters for it to work. You also do not need a local dojo installation on your server.

## Web Build Tool

To build a custom dojo.js with the modules you use the most, use the Web Build Tool (still experimental).
Save the dojo.js generated from the web build to your server, and for any modules that are not in that dojo.js, the xdomain ajax build mentioned above will be used to load them. The special setup for specific modules mentioned the XDomain Ajax Build section still apply, even if those modules are in your dojo.js file.