This document provides an overview of the Dashcode development environment. It describes how to use Dashcode to create two types of projects:
Dashboard widgets—simple, lightweight applications that perform a single task in the Mac OS X Dashboard environment. Widgets are actually packaged webpages powered by standard web technologies such as Hypertext Markup Language (HTML), Cascading Style Sheets (CSS), and JavaScript.
Web applications—webpages that provide discrete functionality to users. Web applications also make use of web technologies such as HTML, CSS, and JavaScript. Dashcode helps you create mobile Safari web applications, which are also known as iPhone web applications (that is, web applications optimized to run in Safari on iPhone), and Safari web applications (that is, web applications optimized to run in Safari).
Dashcode’s integrated environment allows you to lay out, code, and even test widgets and web applications without opening any other applications. Its layout tools, composers, and editors simplify the process of creating all the resources these projects need. Dashcode also includes handy coding and debugging tools that help you manage and test the code you write.
Read Dashcode User Guide to learn how to use Dashcode to create web applications and Dashboard widgets. Developers who are new to either widget or web application creation learn how to build simple projects and find out more about Dashcode’s capabilities. Experienced developers learn how to speed up development using Dashcode.
This document contains the following chapters:
“Dashboard Widget Tutorial” walks you through creating your first Dashboard widget with Dashcode.
“Mobile Safari Web Application Tutorial” shows you how to create a simple mobile Safari web application with Dashcode.
“Dual-Product Web Application Tutorial” shows you how to create a project that produces both a mobile Safari web application and a Safari web application.
“Starting a Project” discusses the different starting points when working with Dashcode.
“Designing the User Interface of a Widget or Web Application” shows you the tools Dashcode provides for designing the user interface of a widget or web application.
“Adding Source Code and Creating Bindings” details the source code editing tools included with Dashcode.
“Testing and Sharing” includes information on testing, debugging, and distributing a widget or web application.
“Advanced Topics for Widgets” talks about localizing a widget using Dashcode and including a widget plug-in.
Dashcode User Guide also includes these appendixes:
“Dashcode Templates” describes the project templates included with Dashcode.
“Dashcode Parts” includes information on Dashcode-originated elements, called parts, and how to customize them.
Apple provides a comprehensive suite of developer tools (including Dashcode) for creating Mac OS X software on a Mac. The Xcode tools include applications to help you design, create, debug, and optimize your software. This tools suite also includes header files, sample code, and documentation for Apple technologies. You can download the Xcode tools from the Apple Developer Connection (ADC) website (http://developer.apple.com). Registration is required, but free.
After you download the Xcode tools, use the Xcode tools installer to install Dashcode on your Mac. After installation, you’ll find Dashcode in /Developer/Applications/
.
If you encounter bugs in Apple software or documentation, you are encouraged to report them to Apple. You can also file enhancement requests to describe features you would like to see in future revisions of a product or document. To file bugs or enhancement requests, go to the Bug Reporting page of the ADC website, which is at the following URL:
http://developer.apple.com/bugreporter/
You must have a valid ADC login name and password to file bugs. You can obtain a login name for free by following the instructions found on the Bug Reporting page. To file a bug for Dashcode, use the Dashcode component, version X.
For in-depth information on how to create web applications that work well on iPhone and iPod touch, see Safari Web Content Guide. For guidance on how to design the user interface of such an application, see iPhone Human Interface Guidelines for Web Applications.
Read Dashboard Programming Topics for information on the technologies available to you when creating a Dashboard widget. All of the Dashboard-specific information discussed in this document is covered in more depth in Dashboard Reference. Additional Dashboard documents and sample code can be found on the ADC topic page for Dashcode.
The Safari Dev Center contains useful information on WebKit, the technology that powers Dashboard widgets, and other Safari-related topics. For more information on the HTML, CSS, and JavaScript capabilities found in WebKit, consult:
Safari HTML Reference
Safari CSS Reference
Safari DOM Additions Reference
The XMLHttpRequest
object allows you to parse XML in JavaScript and use the results. Read the ADC article Dynamic HTML and XML: The XMLHttpRequest Object for more information.
Last updated: 2009-07-24