Table Of Contentwww.it-ebooks.info
www.it-ebooks.info
ffffiirrss..iinndddd iiii 1100//2277//1111 55::0044::5566 PPMM
BEGINNING PHONEGAP
INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
CHAPTER 1 Introducing PhoneGap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
CHAPTER 2 Installing and Confi guring PhoneGap . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
CHAPTER 3 Basic Walkthrough . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
CHAPTER 4 Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
CHAPTER 5 Working with the Device, the Network, and Notifi cations . . . . . . . . . . .59
CHAPTER 6 Accelerometer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
CHAPTER 7 Compass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85
CHAPTER 8 Geolocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99
CHAPTER 9 Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113
CHAPTER 10 Camera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
CHAPTER 11 Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
CHAPTER 12 Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
CHAPTER 13 Contacts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
CHAPTER 14 Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
CHAPTER 15 Creating a Note-Taking Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
APPENDIX A Answers to Exercises . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
APPENDIX B Tools for PhoneGap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .235
APPENDIX C PhoneGap .js . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
APPENDIX D PhoneGap Plug-ins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .333
INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
www.it-ebooks.info
ffffiirrss..iinndddd ii 1100//2277//1111 55::0044::5555 PPMM
www.it-ebooks.info
ffffiirrss..iinndddd iiii 1100//2277//1111 55::0044::5566 PPMM
BEGINNING
PhoneGap
Thomas Myer
John Wiley & Sons, Inc.
www.it-ebooks.info
ffffiirrss..iinndddd iiiiii 1100//2277//1111 55::0044::5566 PPMM
Beginning PhoneGap
Published by
John Wiley & Sons, Inc.
10475 Crosspoint Boulevard
Indianapolis, IN 46256
www.wiley.com
Copyright © 2012 by John Wiley & Sons, Inc., Indianapolis, Indiana
Published simultaneously in Canada
ISBN: 978-1-118-15665-0
ISBN: 978-1-118-22600-1 (ebk)
ISBN: 978-1-118-23932-2 (ebk)
ISBN: 978-1-118-25399-1 (ebk)
Manufactured in the United States of America
10 9 8 7 6 5 4 3 2 1
No part of this publication may be reproduced, stored in a retrieval system or transmitted in any form or by any means,
electronic, mechanical, photocopying, recording, scanning or otherwise, except as permitted under Sections 107 or 108
of the 1976 United States Copyright Act, without either the prior written permission of the Publisher, or authorization
through payment of the appropriate per-copy fee to the Copyright Clearance Center, 222 Rosewood Drive, Danvers,
MA 01923, (978) 750-8400, fax (978) 646-8600. Requests to the Publisher for permission should be addressed to the
Permissions Department, John Wiley & Sons, Inc., 111 River Street, Hoboken, NJ 07030, (201) 748-6011, fax (201)
748-6008, or online at http://www.wiley.com/go/permissions.
Limit of Liability/Disclaimer of Warranty: The publisher and the author make no representations or warranties with
respect to the accuracy or completeness of the contents of this work and specifi cally disclaim all warranties, including
without limitation warranties of fi tness for a particular purpose. No warranty may be created or extended by sales or
promotional materials. The advice and strategies contained herein may not be suitable for every situation. This work
is sold with the understanding that the publisher is not engaged in rendering legal, accounting, or other professional
services. If professional assistance is required, the services of a competent professional person should be sought. Neither
the publisher nor the author shall be liable for damages arising herefrom. The fact that an organization or Web site is
referred to in this work as a citation and/or a potential source of further information does not mean that the author or the
publisher endorses the information the organization or Web site may provide or recommendations it may make. Further,
readers should be aware that Internet Web sites listed in this work may have changed or disappeared between when this
work was written and when it is read.
For general information on our other products and services please contact our Customer Care Department within the
United States at (877) 762-2974, outside the United States at (317) 572-3993 or fax (317) 572-4002.
Wiley publishes in a variety of print and electronic formats and by print-on-demand. Some material included with
standard print versions of this book may not be included in e-books or in print-on-demand. If this book refers to media
such as a CD or DVD that is not included in the version you purchased, you may download this material at
http://booksupport.wiley.com. For more information about Wiley products, visit www.wiley.com.
Library of Congress Control Number: 2011939646
Trademarks: Wiley, the Wiley logo, Wrox, the Wrox logo, Programmer to Programmer, and related trade dress are
trademarks or registered trademarks of John Wiley & Sons, Inc. and/or its affi liates, in the United States and other
countries, and may not be used without written permission. Android is a trademark of Google. Blackberry is a registered
trademark of Research In Motion. All other trademarks are the property of their respective owners. John Wiley & Sons,
Inc., is not associated with any product or vendor mentioned in this book.
www.it-ebooks.info
ffffiirrss..iinndddd iivv 1100//2277//1111 55::0044::5577 PPMM
To my wife, Hope, for loving me anyway.
www.it-ebooks.info
ffffiirrss..iinndddd vv 1100//2277//1111 55::0044::5588 PPMM
www.it-ebooks.info
ffffiirrss..iinndddd vvii 1100//2277//1111 55::0044::5588 PPMM
ABOUT THE AUTHOR
THOMAS MYER works and lives in Austin, Texas. He’s been a PHP web developer for about ten
years, and a mobile apps developer for the past three. Until recently, he was the Top Dog of Triple
Dog Dare Media, but now works for Deal Management, LLC, out of Minnesota, where he builds
web and mobile apps. You can follow him at @myerman on Twitter.
ABOUT THE TECHNICAL EDITORS
BRIAN LEROUX is the lead software architect at Nitobi Inc. where he focuses on delivering web and
mobile apps and helping developers all over the world write their apps. He is a contributor to the
popular PhoneGap Open Source framework, and is the creator of XUI and Lawnchair.
DANNY LOWE was born in Huntington Beach, and raised in Southern California, but now calls
Austin, Texas, his home. He is a computer programming superhero who has been skillfully hiding
his secret identity since 1996. When he is not writing code and saving the careers of project
managers by leaping tall deadlines in a single bound, Lowe is playing music, writing fi ction
and poetry, or hanging out with his wife, Stephanie, and two sons. Follow him on Twitter at
@DannyInAustin.
www.it-ebooks.info
ffffiirrss..iinndddd vviiii 1100//2277//1111 55::0044::5588 PPMM
www.it-ebooks.info
ffffiirrss..iinndddd vviiiiii 1100//2277//1111 55::0044::5588 PPMM
Description:PhoneGap is a growing and leading open-source mobile web apps development framework that lets developers build JavaScript and HTML5-based web applications with native wrappers for more than six mobile platforms, including iOS, Android, and BlackBerry. This framework lets you build HTML- and JavaScri