Retired Document
Important: This document may not represent best practices for current development. Links to downloads and other resources may no longer be valid.
Introduction to Dashcode User Guide
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 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.
Who Should Read This Document?
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.
Organization of This Document
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.
Getting and Running Dashcode
To obtain Dashcode, download it from http://developer.apple.com. Registration is required, but free.
Reporting Bugs
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: http://developer.apple.com/bugreporter/
You must have a valid 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.
See Also
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 iOS Human Interface Guidelines.
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.
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:
The XMLHttpRequest
object allows you to parse XML in JavaScript and use the results. Read Dynamic HTML and XML: The XMLHttpRequest Object for more information.
Copyright © 2012 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2012-02-16