Apollo For Adobe Flex Developers Pocket Guide

Pocket Guide

Apollo for Adobe® Flex Developers
TM

Mike Chambers, Robert L. Dixon, and Jeff Swartz

Adobe Apollo® for Flex™: Pocket Guide
by Mike Chambers, Robert L. Dixon, and Jeff Swartz
Copyright © 2007 Adobe Systems, Inc. All rights reserved. Printed in the United States of America. Published by O’Reilly Media, Inc., 1005 Gravenstein Highway North, Sebastopol, CA 95472. O’Reillybooks may be purchased for educational, business, or sales promotional use. Online editions are also available for most titles (safari.oreilly.com). For more information, contact our corporate/ institutional sales department: (800) 998-9938 or corporate@oreilly.com.

Editor: Steve Weiss Production Editor: Philip Dangler Indexer: Joe Wizda Printing History:
March 2007: First Edition.

CoverDesigner: Karen Montgomery Interior Designer: David Futato Illustrators: Robert Romano and Jessamyn Read

Nutshell Handbook, the Nutshell Handbook logo, and the O’Reilly logo are registered trademarks of O’Reilly Media, Inc. The Pocket Reference/Pocket Guide series designations, Adobe Apollo for Flex, the image of a bengal falcon, and related trade dress are trademarks of O’Reilly Media, Inc. Thiswork is licensed under the Creative Commons AttributionShareAlike 2.5 License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/2.5/ or send a letter to Creative Commons, 543 Howard Street, 5th Floor, San Francisco, California, 94105, USA. Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks. Where thosedesignations appear in this book, and O’Reilly Media, Inc. was aware of a trademark claim, the designations have been printed in caps or initial caps. While every precaution has been taken in the preparation of this book, the publisher and authors assume no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein.

ISBN-10: 0-596-51391-7ISBN-13: 978-0-596-51391-7 [C]

Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v 1. Introduction to Apollo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
A Short History of Web Applications Problems with Delivering Applications via the BrowserIntroducing the Apollo Runtime Primary Apollo Technologies 1 3 4 5

2. Getting Started with Apollo Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Installing the Apollo Alpha 1 Runtime What You Need in Order to Develop Apollo Applications Building a Sample Apollo Application Next Steps 13 14 17 25

3. Using HTML Within Flex-Based Apollo Applications . . . . . . . . . . . . .. . . . . . . 26
HTML Support in Apollo Using the Flex HTML Component Using the HTMLControl Class Script Bridging: Communicating Between ActionScript and JavaScript 26 28 35 37

4. Using the File System API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Security Model Accessing Files and Directories Asynchronous and Synchronous Versions of MethodsReading Directory Contents Getting File Information Copying and Moving Files and Directories Creating Files and Directories 42 43 45 47 47 48 48

iii

Deleting Files and Directories Reading and Writing Files

49 49

5. Apollo Mini-Cookbook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Working with the File System Working with HTML Using theWindowing API 54 68 71

A. Apollo Packages and Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 B. Apollo Command-Line Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

iv...