book

Pro Android 3

Name: Pro Android 3
ISBN: 9781430232223

by Satya Komatineni, Dave MacLean, Sayed Y. Hashimi

April 2011

Intermediate to advanced

1201 pages

31h 52m

English

Apress

Read now

Unlock full access

Copyright
Foreword
About the Authors
About the Technical Reviewer
Acknowledgments
Preface
1. Introducing the Android Computing Platform
1.1. A New Platform for a New Personal Computer1.2. Early History of Android1.3. Delving Into the Dalvik VM1.4. Understanding the Android Software Stack1.5. Developing an End-User Application with the Android SDK1.5.1. Android Emulator1.5.2. The Android UI1.5.3. The Android Foundational Components1.5.4. Advanced UI Concepts1.5.5. Android Service Components1.5.6. Android Media and Telephony Components1.5.7. Android Java Packages1.6. Taking Advantage of Android Source Code1.7. The Sample Projects in this Book1.8. Summary
2. Setting Up Your Development Environment
2.1. Setting Up Your Environment2.1.1. Downloading JDK 62.1.2. Downloading Eclipse 3.62.1.3. Downloading the Android SDK2.1.3.1. Updating Your PATH Environment Variable2.1.4. The Tools Window2.1.5. Installing Android Development Tools (ADT)2.2. Learning the Fundamental Components2.2.1. View2.2.2. Activity2.2.3. Intent2.2.4. Content Provider2.2.5. Service2.2.6. AndroidManifest.xml2.2.7. Android Virtual Devices2.3. Hello World!2.4. Android Virtual Devices2.5. Exploring the Structure of an Android Application2.6. Analyzing the Notepad Application2.6.1. Loading and Running the Notepad Application2.6.2. Dissecting the Application2.7. Examining the Application Lifecycle2.8. Debugging Your App2.8.1. Launching the Emulator2.8.2. StrictMode2.8.3. References2.9. Summary
3. Understanding Android Resources
3.1. Understanding Resources3.1.1. String Resources3.1.2. Layout Resources3.1.3. Resource Reference Syntax3.1.4. Defining Your Own Resource IDs for Later Use3.1.5. Compiled and Uncompiled Android Resources3.2. Enumerating Key Android Resources3.2.1.3.2.1.1. String Arrays3.2.1.2. Plurals3.2.1.3. More on String Resources3.2.1.4. Color Resources3.2.1.5. Dimension Resources3.2.1.6. Image Resources3.2.1.7. Color-Drawable Resources3.3. Working with Arbitrary XML Resource Files3.4. Working with Raw Resources3.5. Working with Assets3.6. Reviewing the Resources Directory Structure3.7. Resources and Configuration Changes3.8. Reference URLs3.9. Summary
4. Understanding Content Providers
4.1. Exploring Android's Built-in Providers4.1.1.4.1.1.1. Exploring Databases on the Emulator and Available Devices4.1.1.2. Quick SQLite Primer4.2. Architecture of Content Providers4.2.1.4.2.1.1. Structure of Android Content URIs4.2.1.2. Structure of Android MIME Types4.2.1.3. Reading Data Using URIs4.2.1.4. Using the Android Cursor4.2.1.5. Working with the where Clause4.2.1.5.1. Passing a where Clause Through a URI4.2.1.5.2. Using Explicit where Clauses4.2.1.6. Inserting Records4.2.1.7. Adding a File to a Content Provider4.2.1.8. Updates and Deletes4.3. Implementing Content Providers4.3.1.4.3.1.1. Planning a Database4.3.1.2. Extending ContentProvider4.3.1.3. Fulfilling MIME-Type Contracts4.3.1.4. Implementing the Query Method4.3.1.5. Implementing an Insert Method4.3.1.6. Implementing an Update Method4.3.1.7. Implementing a Delete Method4.3.1.8. Using UriMatcher to Figure Out the URIs4.3.1.9. Using Projection Maps4.3.1.10. Registering the Provider4.4. Exercising the Book Provider4.4.1. Adding A Book4.4.2. Removing a Book4.4.3. Getting a Count of the Books4.4.4. Displaying the List of Books4.5. Resources4.6. Summary

5. Understanding Intents
5.1. Basics of Android Intents5.2. Available Intents in Android5.3. Exploring Intent Composition5.3.1. Intents and Data URIs5.3.2. Generic Actions5.3.3. Using Extra Information5.3.4. Using Components to Directly Invoke an Activity5.3.5. Understanding Intent Categories5.3.6. Rules for Resolving Intents to Their Components5.3.6.1. Action5.3.6.2. Data5.3.6.3. Data Type5.3.6.4. Data Scheme5.3.6.5. Data Authority5.3.6.6. Data Path5.3.6.7. Intent Categories5.4. Exercising the ACTION_PICK5.5. Exercising the GET_CONTENT Action5.6. Introducing Pending Intents5.7. Resources5.8. Summary
6. Building User Interfaces and Using Controls
6.1. UI Development in Android6.1.1. Building a UI Completely in Code6.1.2. Building a UI Completely in XML6.1.3. Building a UI in XML With Code6.1.3.1. FILL_PARENT vs. MATCH_PARENT6.2. Understanding Android's Common Controls6.2.1. Text Controls6.2.1.1. TextView6.2.1.2. EditText6.2.1.3. AutoCompleteTextView6.2.1.4. MultiAutoCompleteTextView6.2.2. Button Controls6.2.2.1. The Button Control6.2.2.2. The ImageButton Control6.2.2.3. The ToggleButton Control6.2.2.4. The CheckBox Control6.2.2.5. The RadioButton Control6.2.3. The ImageView Control6.2.4. Date and Time Controls6.2.4.1. The DatePicker and TimePicker Controls6.2.4.2. The DigitalClock and AnalogClock Controls6.2.5. The MapView Control6.3. Understanding Adapters6.3.1. Getting to Know SimpleCursorAdapter6.3.2. Getting to Know ArrayAdapter6.4. Using Adapters With AdapterViews6.4.1. The Basic List Control: ListView6.4.1.1. Displaying Values in a ListView6.4.1.2. Clickable Items in a ListView6.4.1.3. Adding Other Controls With a ListView6.4.1.4. Another Way to Read Selections From a ListView6.4.2. The GridView Control6.4.3. The Spinner Control6.4.4. The Gallery Control6.4.5. Creating Custom Adapters6.4.6. Other Controls in Android6.5. Styles and Themes6.5.1. Using Styles6.5.2. Using Themes6.6. Understanding Layout Managers6.6.1. The LinearLayout Layout Manager6.6.1.1. Understanding Weight and Gravity6.6.1.2. android:gravity vs. android:layout_gravity6.6.2. The TableLayout Layout Manager6.6.3. The RelativeLayout Layout Manager6.6.4. The FrameLayout Layout Manager6.6.5. Customizing Layout for Various Device Configurations6.7. Debugging and Optimizing Layouts with the Hierarchy Viewer6.8. References6.9. Summary
7. Working with Menus
7.1. Understanding Android Menus7.1.1. Creating a Menu7.1.2. Working with Menu Groups7.2. Responding to Menu Items7.2.1.7.2.1.1. Responding to Menu Items through onOptionsItemSelected7.2.1.2. Responding to Menu Items through Listeners7.2.1.3. Using an Intent to Respond to Menu Items7.3. Creating a Test Harness for Testing Menus7.3.1.7.3.1.1. Creating an XML Layout7.3.1.2. Creating an Activity7.3.1.3. Setting Up the Menu7.3.1.4. Adding Regular Menu Items7.3.1.5. Adding Secondary Menu Items7.3.1.6. Responding to Menu Item Clicks7.3.1.7. Tweaking the AndroidManifest.xml File7.4. Working with Other Menu Types7.4.1. Expanded Menus7.4.2. Working with Icon Menus7.4.3. Working with Submenus7.4.4. Provisioning for System Menus7.4.5. Working with Context Menus7.4.5.1. Registering a View for a Context Menu7.4.5.2. Populating a Context Menu7.4.5.3. Responding to Context Menu Items7.4.6. Working with Alternative Menus7.4.7. Working with Menus in Response to Changing Data7.5. Loading Menus Through XML Files7.5.1. Structure of an XML Menu Resource File7.5.2. Inflating XML Menu Resource Files7.5.3. Responding to XML-Based Menu Items7.5.4. A Brief Introduction to Additional XML Menu Tags7.5.4.1. Group Category Tag7.5.4.2. Checkable Behavior Tags7.5.4.3. Tags to Simulate a Submenu7.5.4.4. Menu Icon Tag7.5.4.5. Menu Enabling/Disabling Tag7.5.4.6. Menu Item Shortcuts7.5.4.7. Menu Visibility7.6. Resource7.7. Summary
8. Working with Dialogs
8.1. Using Dialogs in Android8.1.1. Designing an Alert Dialog8.1.2. Designing a Prompt Dialog8.1.2.1. XML Layout File for the Prompt Dialog8.1.2.2. Setting Up an Alert-Dialog Builder with a User View8.1.2.3. Setting Up Buttons and Listeners8.1.2.4. Creating and Showing the Prompt Dialog8.1.2.5. Prompt Dialog Listener8.1.2.6. Putting It All Together8.1.3. Nature of Dialogs in Android8.1.4. Rearchitecting the Prompt Dialog8.2. Working with Managed Dialogs8.2.1. Understanding the Managed-Dialog Protocol8.2.2. Recasting the Nonmanaged Dialog as a Managed Dialog8.2.3. Simplifying the Managed-Dialog Protocol8.2.3.1. IDialogProtocol8.2.3.2. ManagedActivityDialog8.2.3.3. DialogRegistry8.2.3.4. ManagedDialogsActivity8.2.3.5. IDialogFinishedCallBack8.2.3.6. GenericManagedAlertDialog8.2.3.7. GenericPromptDialog8.3. Working with Toast8.4. Resources8.5. Summary
9. Working with Preferences and Saving State
9.1. Exploring the Preferences Framework9.1.1. Understanding ListPreference9.1.2. Understanding CheckBoxPreference9.1.3. Understanding EditTextPreference9.1.4. Understanding RingtonePreference9.2. Organizing Preferences9.3. Manipulating Preferences Programmatically9.4. Saving State with Preferences9.5. Reference9.6. Summary
10. Exploring Security and Permissions
10.1. Understanding the Android Security Model10.1.1. Overview of Security Concepts10.1.2. Signing Applications for Deployment10.1.2.1. Generating a Self-Signed Certificate Using the Keytool10.1.2.2. The Debug Keystore and the Development Certificate10.1.2.3. Using the Jarsigner Tool to Sign the .apk File10.1.2.4. Aligning Your Application with zipalign10.1.2.5. Installing Updates to an Application and Signing10.2. Performing Runtime Security Checks10.2.1. Understanding Security at the Process Boundary10.2.2. Declaring and Using Permissions10.2.3. Understanding and Using Custom Permissions10.2.4. Understanding and Using URI Permissions10.2.4.1. Passing URI Permissions in Intents10.2.4.2. Specifying URI Permissions in Content Providers10.3. References10.4. Summary
11. Building and Consuming Services
11.1. Consuming HTTP Services11.1.1. Using the HttpClient for HTTP GET Requests11.1.2. Using the HttpClient for HTTP POST Requests (a Multipart Example)11.1.3. SOAP, JSON, and XML Parsers11.1.4. Dealing with Exceptions11.1.5. Addressing Multithreading Issues11.1.6. Fun With Timeouts11.1.7. Using the HttpURLConnection11.1.8. Using the AndroidHttpClient11.1.9. Using Background Threads (AsyncTask)11.1.10. Handling Configuration Changes with AsyncTasks11.1.11. Getting Files Using DownloadManager11.2. Using Android Services11.2.1. Understanding Services in Android11.2.2. Understanding Local Services11.2.3. Understanding AIDL Services11.2.4. Defining a Service Interface in AIDL11.2.5. Implementing an AIDL Interface11.2.6. Calling the Service from a Client Application11.2.7. Passing Complex Types to Services11.3. Real-World Example Using Services11.3.1. Google Translate API11.3.2. Using the Google Translate API11.4. References11.5. Summary
12. Exploring Packages
12.1. Packages and Processes12.1.1. Details of a Package Specification12.1.2. Translating Package Name to a Process Name12.1.3. Listing Installed Packages12.1.4. Deleting a Package through the Package Browser12.2. Revisiting the Package Signing Process12.2.1. Understanding Digital Signatures: Scenario 112.2.2. Understanding Digital Signatures: Scenario 212.2.3. A Pattern for Understanding Digital Signatures12.2.4. So How Do You Digitally Sign?12.2.5. Implications of the Signing Process12.3. Sharing Data Among Packages12.3.1. The Nature of Shared User IDs12.3.2. A Code Pattern for Sharing Data12.4. Library Projects12.4.1. What Is a Library Project?12.4.2. Library Project Predicates12.4.3. Creating a Library Project12.4.4. Creating an Android Project That Uses a library12.5. References12.6. Summary
13. Exploring Handlers
13.1. Android Components and Threading13.1.1. Activities Run on the Main Thread13.1.2. Broadcast Receivers run on the Main Thread13.1.3. Services Run on the Main Thread13.1.4. Content Provider Runs on the Main Thread13.1.5. Implications of a Singular Main Thread13.1.6. Thread Pools, Content Providers, External Service Components13.1.7. Thread Utilities: Discover Your Threads13.2. Handlers13.2.1. Implications of Holding the Main Thread13.2.2. Using a Handler to Defer Work on the Main Thread13.2.3. A Sample Handler Source Code That Defers Work13.2.4. Constructing a Suitable Message Object13.2.5. Sending Message Objects to the Queue13.2.6. Responding to the handleMessage Callback13.3. Using Worker Threads13.3.1. Invoking a Worker Thread from a Menu13.3.2. Communicating Between the Worker and the Main Threads13.3.2.1. WorkerThreadRunnable Implementation13.3.2.2. ReportStatusHandler Implementation13.3.3. A Quick Overview of Thread Behavior13.4. Handler Example Driver classes13.4.1. Driver Activity File13.4.2. Layout File13.4.3. Menu File13.4.4. Manifest File13.5. Component and Process Lifetimes13.5.1. Activity Life Cycle13.5.2. Service Life Cycle13.5.3. Receiver Life Cycle13.5.4. Provider Life Cycle13.6. Instructions for Compiling the Code13.6.1. Creating the Project from the ZIP File13.6.2. Creating the Project from the Listings13.7. References13.8. Summary
14. Broadcast Receivers and Long-Running Services
14.1. Broadcast Receivers14.1.1. Sending a Broadcast14.1.2. Coding a Simple Receiver: Sample Code14.1.3. Registering a Receiver in the Manifest File14.1.4. Sending a Test Broadcast14.1.5. Accommodating Multiple Receivers14.1.6. A Project for Out-of-Process Receivers14.2. Using Notifications from a Receiver14.2.1. Monitoring Notifications Through the Notification Manager14.2.2. Sending a Notification14.3. Long-Running Receivers and Services14.3.1. Long-Running Broadcast Receiver Protocol14.3.2. IntentService14.3.3. IntentService Source Code14.4. Extending IntentService for a Broadcast Receiver14.4.1. Long-Running Broadcast Service Abstraction14.4.2. A Long-Running Receiver14.4.3. Abstracting a Wake Lock with LightedGreenRoom14.4.3.1. A Lighted Green Room14.4.3.2. Lighted Green Room Implementation14.5. Long-Running Service Implementation14.5.1. Details of a Nonsticky Service14.5.2. Details of a Sticky Service14.5.3. A Variation of Nonsticky: Redeliver Intents14.5.4. Specifying Service Flags in OnStartCommand14.5.5. Picking Suitable Stickiness14.5.6. Controlling the Wake Lock from Two Places14.5.7. Long-Running Service Implementation14.5.8. Testing Long Running Services14.6. Instructions for Compiling the Code14.6.1. Creating the Projects from the ZIP File14.6.2. Creating the Project from the Listings14.6.2.1. TestBCR Project files14.6.2.2. Stand-Alone BCR Project Files14.7. References14.8. Summary
15. Exploring the Alarm Manager
15.1. Alarm Manager Basics: Setting Up a Simple Alarm15.1.1. Obtaining the Alarm Manager15.1.2. Setting Up the Time for the Alarm15.1.3. Setting Up a Receiver for the Alarm15.1.4. Creating a PendingIntent Suitable for an Alarm15.1.5. Setting the Alarm15.1.6. Test Project15.2. Exploring Alarm Manager Alternate Scenarios15.2.1. Setting Off an Alarm Repeatedly15.2.1.1. Compiling Code for This Example15.2.2. Cancelling an Alarm15.2.2.1. Compiling code for this example15.2.3. Working with Multiple Alarms15.2.3.1. Compiling Code for This Example15.2.4. Intent Primacy in Setting Off Alarms15.2.5. Persistence of Alarms15.3. Alarm Manager Predicates15.4. References15.5. Summary
16. Exploring 2D Animation
16.1. Frame-by-Frame Animation16.1.1. Planning for Frame-by-Frame Animation16.1.2. Creating the Activity16.1.3. Adding Animation to the Activity16.2. Layout Animation16.2.1. Basic Tweening Animation Types16.2.2. Planning the Layout Animation Test Harness16.2.3. Creating the Activity and the ListView16.2.4. Animating the ListView16.2.5. Using Interpolators16.3. View Animation16.3.1. Understanding View Animation16.3.2. Adding Animation16.3.3. Using Camera to Provide Depth Perception in 2D16.3.4. Exploring the AnimationListener Class16.3.5. Some Notes on Transformation Matrices16.4. Resources16.5. Summary
17. Exploring Maps and Location-based Services
17.1. Understanding the Mapping Package17.1.1. Obtaining a map-api Key from Google17.1.2. Understanding MapView and MapActivity17.1.3. Adding Markers Using Overlays17.2. Understanding the Location Package17.2.1. Geocoding with Android17.2.2. Geocoding with Background Threads17.2.3. Understanding the LocationManager Service17.2.3.1. How to Enable Location Providers17.2.3.2. What Can You Do With a Location?17.2.3.3. Sending Location Updates to Your Application During Development17.2.3.4. Sending Location Updates From the Emulator Console17.2.3.5. Alternate Ways of Getting Location Updates17.2.4. Showing Your Location Using MyLocationOverlay17.2.4.1. Customizing MyLocationOverlay17.2.5. Using Proximity Alerts17.3. References17.4. Summary
18. Using the Telephony APIs
18.1. Working with SMS18.1.1. Sending SMS Messages18.1.2. Monitoring Incoming SMS Messages18.1.3. Working with SMS Folders18.1.4. Sending E-mail18.2. Working with the Telephony Manager18.3. Session Initiation Protocol (SIP)18.4. References18.5. Summary
19. Understanding the Media Frameworks
19.1. Using the Media APIs19.1.1. Using SD Cards19.2. Playing Media19.2.1. Playing Audio Content19.2.1.1. Understanding the setDataSource Method19.2.1.2. Use SoundPool for Simultaneous Track Playing19.2.1.3. Playing Sounds with JetPlayer19.2.1.4. Playing Background Sounds with AsyncPlayer19.2.1.5. Low-level Audio Playback Using AudioTrack19.2.1.6. Understanding the MediaPlayer Oddities19.2.2. Playing Video Content19.3. Recording Media19.3.1. Exploring Audio Recording with MediaRecorder19.3.2. Recording Audio with AudioRecord19.3.3. Exploring Video Recording19.3.3.1. Camera and Camcorder Profiles19.3.4. Exploring the MediaStore Class19.3.5. Recording Audio Using an Intent19.3.6. Adding Media Content to the Media Store19.3.7. Triggering MediaScanner for the Entire SD Card19.3.8. References19.4. Summary
20. Programming 3D Graphics with OpenGL
20.1. Understanding the History and Background of OpenGL20.1.1. OpenGL ES20.1.2. OpenGL ES and Java ME20.1.3. M3G: Another Java ME 3D Graphics Standard20.2. Fundamentals of OpenGL20.2.1. Essential Drawing with OpenGL ES20.2.1.1. glVertexPointer and Specifying Drawing Vertices20.2.1.2. glDrawElements20.2.1.3. glClear20.2.1.4. glColor20.2.2. Understanding OpenGL Camera and Coordinates20.2.2.1. gluLookAt and the Camera Symbolism20.2.2.2. glFrustum and the Viewing Volume20.2.2.3. glViewport and Screen Size20.3. Interfacing OpenGL ES with Android20.3.1. Using GLSurfaceView and Related Classes20.3.2. Implementing the Renderer20.3.3. Using GLSurfaceView from an Activity20.3.4. Changing Camera Settings20.3.5. Using Indices to Add Another Triangle20.3.6. Animating the Simple OpenGL Triangle20.3.6.1. AnimatedSimpleTriangleRenderer20.4. Braving OpenGL: Shapes and Textures20.4.1. Drawing a Rectangle20.4.2. Working with Shapes20.4.2.1. A Regular Polygon as a Shape20.4.2.2. Implementing the RegularPolygon Shape20.4.2.3. Rendering a Square Using RegularPolygon20.4.2.4. Animating RegularPolygons20.4.3. Working with Textures20.4.3.1. Understanding Textures20.4.3.2. Normalized Texture Coordinates20.4.3.3. Abstracting Common Texture Handling20.4.3.4. Drawing Using Textures20.4.4. Drawing Multiple Figures20.5. OpenGL ES 2.020.5.1. Java Bindings for OpenGL ES 2.020.5.2. Rendering Steps20.5.3. Understanding Shaders20.5.4. Compiling Shaders into a Program20.5.5. Getting Access to the Shader Program Variables20.5.6. A Simple ES 2.0 Triangle20.5.7. Further Reading on OpenGL ES 2.020.6. Instructions for Compiling the Code20.6.1. References20.7. Summary
21. Exploring Live Folders
21.1. Exploring Live Folders21.1.1. How a User Experiences Live Folders21.1.2. Building a Live Folder21.1.2.1. AndroidManifest.xml21.1.2.2. AllContactsLiveFolderCreatorActivity.java21.1.2.3. MyContactsProvider.java21.1.2.4. MyCursor.java21.1.2.5. BetterCursorWrapper.java21.1.2.6. Exercising Live Folders21.2. Instructions for Compiling the Code21.3. References21.4. Summary
22. Home Screen Widgets
22.1. Architecture of Home Screen Widgets22.1.1. What Are Home Screen Widgets?22.1.2. User Experience with Home Screen Widgets22.1.2.1. Creating a Widget Instance on the Home Screen22.1.2.2. Understanding Widget Configurator22.1.3. Life Cycle of a Widget22.1.3.1. Widget Definition Phase22.1.3.2. Widget Instance Creation Phase22.1.3.3. onUpdate Phase22.1.3.4. Widget View Mouse Click Event Callbacks22.1.3.5. Deleting a Widget Instance22.1.3.6. Uninstalling Widget Packages22.2. A Sample Widget Application22.2.1. Defining the Widget Provider22.2.2. Defining Widget Size22.2.3. Widget Layout-Related Files22.2.3.1. Widget Layout File22.2.3.2. Widget Background Shape File22.2.4. Implementing a Widget Provider22.2.5. Implementing Widget Models22.2.5.1. Interface for a Widget Model22.2.5.2. Abstract Implementation of a Widget Model22.2.5.3. Implementation of a Widget Model for Birthday Widget22.2.5.4. A Few Date-Related Utilities22.2.6. Implementing Widget Configuration Activity22.3. Widget Limitations and Extensions22.4. Resources22.5. Summary
23. Android Search
23.1. Android Search Experience23.1.1. Exploring Android Global Search23.1.2. Enabling Suggestion Providers for Global Search23.1.2.1. Working with Search Settings in Android Release 2.223.1.2.2. Working with Search Settings in Android Release 2.323.2. Activities and Search Key Interaction23.2.1. Behavior of Search Key on a Regular Activity23.2.2. Behavior of an Activity that Disables Search23.2.3. Explicitly Invoking Search Through a Menu23.2.4. Understanding Local Search and Related Activities23.2.5. Enabling Type-to-Search23.3. Implementing a Simple Suggestion Provider23.3.1. Planning the Simple Suggestions Provider23.3.2. Simple Suggestions Provider Implementation Files23.3.3. Implementing the SimpleSuggestionProviderclass23.3.3.1. Responsibilities of a Simple Suggestion Provider23.3.3.2. Complete Source Code of SimpleSuggestionProvider23.3.3.3. Understanding SearchRecentSuggestionsProvider Database Modes23.3.3.4. Declaring the Suggestion Provider in the Manifest File23.3.4. Understanding Simple Suggestions Provider Search Activity23.3.4.1. Complete Source Code of a Search Activity23.3.4.2. Checking the Action and Retrieving the Query23.3.4.3. Understanding onCreate() and onNewIntent()23.3.4.4. Testing for onNewIntent()23.3.4.5. Saving the Query Using SearchRecentSuggestionsProvider23.3.4.6. Search Metadata23.3.5. Search Invoker Activity23.3.6. Simple Suggestion Provider User Experience23.4. Implementing a Custom Suggestion Provider23.4.1. Planning the Custom Suggestion Provider23.4.2. SuggestURLProvider Project Implementation Files23.4.3. Implementing the SuggestUrlProvider Class23.4.3.1. Responsibilities of a Suggestion Provider23.4.3.2. Overall Source Code for SuggestUrlProvider23.4.3.3. Understanding Suggestion Provider URIs23.4.3.4. Implementing getType() and Specifying MIME Types23.4.3.5. Passing Query to the Suggestion Provider: The Selection Argument23.4.3.6. Exploring Search Metadata for Custom Suggestion Providers23.4.3.7. Suggestion Cursor Columns23.4.3.8. Populating and Returning the List of Columns23.4.4. Implementing a Search Activity for a Custom Suggestion Provider23.4.4.1. SearchActivity for a Custom Suggestion Provider23.4.4.2. Details of SearchActivity Invocation23.4.4.3. Responding to ACTION_SEARCH and ACTION_VIEW23.4.4.4. Search Activity Layout23.4.4.5. Corresponding strings.xml23.4.4.6. Responding to onCreate() and onNewIntent()23.4.4.7. Notes on Finishing a Search Activity23.4.5. Custom Suggestions Provider Manifest File23.4.6. Custom Suggestion User Experience23.5. Using Action Keys and Application-Specific Search Data23.5.1. Using Action Keys in Android Search23.5.2. Working with Application-Specific Search Context23.6. Resources23.7. Implications for Tablets23.8. Summary
24. Exploring Text to Speech
24.1. The Basics of Text-to-Speech Capabilities in Android24.2. Using Utterances to Keep Track of Our Speech24.3. Using Audio Files for Your Voice24.4. Advanced Features of the TTS Engine24.4.1. Setting Audio Streams24.4.2. Using Earcons24.4.3. Playing Silence24.4.4. Choosing a Different Text-to-Speech Engine24.4.5. Using Language Methods24.5. References24.6. Summary
25. Touch Screens
25.1. Understanding MotionEvents25.1.1. The MotionEvent Object25.1.2. Recycling MotionEvents25.1.3. Using VelocityTracker25.1.4. Exploring Drag and Drop25.2. Multitouch25.2.1. Multitouch Before Android 2.225.2.2. Multitouch Since Android 2.225.3. Touches with Maps25.4. Gestures25.4.1. The Pinch Gesture25.4.2. GestureDetector and OnGestureListeners25.4.3. Custom Gestures25.4.4. The Gestures Builder Application25.5. References25.6. Summary
26. Using Sensors
26.1. What Is a Sensor?26.1.1. Detecting Sensors26.1.2. What Can We Know About a Sensor?26.2. Getting Sensor Events26.2.1. Issues with Getting Sensor Data26.2.1.1. onAccuracyChanged() Always Says the Same Thing26.2.1.2. No Direct Access to Sensor Values26.2.1.3. Sensor Values not Sent Fast Enough26.2.1.4. Sensors Turn Off with Screen in Android 2.126.2.1.4.1. The Unregister/Register Technique for Continual Sensor Updates26.2.1.4.2. The Keep-the-Screen-On Technique for Continual Sensor Updates26.3. Interpreting Sensor Data26.3.1. Light Sensors26.3.2. Proximity Sensors26.3.3. Temperature Sensors26.3.4. Pressure Sensors26.3.5. Gyroscope Sensors26.3.6. Accelerometers26.3.6.1. Accelerometers and Display Orientation26.3.6.2. Accelerometers and Gravity26.3.6.3. Using Accelerometers to Measure the Device's Angle26.3.7. Magnetic Field Sensors26.3.8. Using Accelerometers and Magnetic Field Sensors Together26.3.9. Orientation Sensors26.3.10. Magnetic Declination and GeomagneticField26.3.11. Gravity Sensors26.3.12. Linear Acceleration Sensors26.3.13. Rotation Vector Sensors26.3.14. Near Field Communication Sensors26.3.14.1. Enabling The NFC Sensor26.3.14.2. Routing NFC Tags26.3.14.3. Receiving NFC Tags26.3.14.4. Reading NFC Tags26.3.14.5. NFC Card Emulation26.3.14.6. NFC Peer-to-Peer (P2P)26.3.14.7. Testing NFC with NFCDemo26.4. References26.5. Summary
27. Exploring the Contacts API
27.1. Understanding Accounts27.1.1. A Quick Tour of Account Screens27.1.2. Relevance of Accounts to Contacts27.1.3. Enumerating Accounts27.2. Understanding Contacts Application27.2.1. Show Contacts27.2.2. Show Contact Detail27.2.3. Edit Contact Details27.2.4. Setting a Contact's Photo27.2.5. Exporting Contacts27.2.6. Various Contact Data Types27.3. Understanding Contacts27.3.1. Examining the Contents SQLite Database27.3.2. Raw Contacts27.3.3. Data Table27.3.4. Aggregated Contacts27.3.5. view_contacts27.3.6. contact_entities_view27.4. Working with the Contacts API27.4.1. Exploring Accounts27.4.1.1. The Menu file27.4.1.2. Account Function Tester-Related files27.4.1.2.1. IReportBack.java27.4.1.2.2. BaseTester.java27.4.1.2.3. AccountsFunctionTester.java27.4.1.3. Driver Activity Classes27.4.1.3.1. DebugActivity.java27.4.1.3.2. debug_layout_activity.java27.4.1.3.3. TestContactsDriverActivity.java27.4.1.3.4. Manifest File27.4.1.4. Running the Program27.4.2. Exploring Aggregated Contacts27.4.3. Exploring Raw Contacts27.4.4. Exploring Raw Contact Data27.4.5. Adding a Contact and Its Details27.5. Controlling Aggregation27.6. Impacts of Syncing27.7. References27.8. Summary
28. Deploying Your Application: Android Market and Beyond
28.1. Becoming a Publisher28.1.1. Following the Rules28.1.2. Developer Console28.2. Preparing Your Application for Sale28.2.1. Testing for Different Devices28.2.2. Supporting Different Screen Sizes28.2.3. Preparing AndroidManifest.xml for Uploading28.2.4. Localizing Your Application28.2.5. Preparing Your Application Icon28.2.6. Considerations for Making Money From Apps28.2.7. Directing Users Back to the Market28.2.8. The Android Licensing Service28.2.9. Preparing Your .apk File for Uploading28.3. Uploading Your Application28.4. User Experience on Android Market28.5. Beyond Android Market28.6. References28.7. Summary
29. Fragments for Tablets and More
29.1. What is a Fragment?29.1.1. When to Use Fragments29.1.2. The Structure of a Fragment29.1.3. A Fragment's Lifecycle29.1.3.1. The onInflate() Callback29.1.3.2. The onAttach() Callback29.1.3.3. The onCreate() Callback29.1.3.4. The onCreateView() Callback29.1.3.5. The onActivityCreated() Callback29.1.3.6. The onStart() Callback29.1.3.7. The onResume() Callback29.1.3.8. The onPause() Callback29.1.3.9. The onStop() Callback29.1.3.10. The onDestroyView() Callback29.1.3.11. The onDestroy() Callback29.1.3.12. The onDetach() Callback29.1.3.13. Using setRetainInstance()29.1.4. Sample Fragment App Showing the Lifecycle29.2. FragmentTransactions and the Fragment Back Stack29.2.1. Fragment Transaction Transitions and Animations29.3. The FragmentManager29.3.1. Caution When Referencing Fragments29.3.2. ListFragments and <fragment>29.3.3. Invoking a Separate Activity When Needed29.3.4. Persistence of Fragments29.4. Understanding Dialog Fragments29.4.1. DialogFragment Basics29.4.1.1. Constructing a Dialog Fragment29.4.1.1.1. Overriding onCreateView29.4.1.1.2. Overriding onCreateDialog29.4.1.2. Displaying a Dialog Fragment29.4.1.3. Dismissing a Dialog Fragment29.4.1.4. Implications of a Dialog Dismiss29.4.2. DialogFragment Sample Application29.4.2.1. Dialog Sample: MainActivity29.4.2.2. Dialog Sample: OnDialogDoneListener29.4.2.3. Dialog Sample: PromptDialogFragment29.4.2.4. Dialog Sample: HelpDialogFragment29.4.2.5. Dialog Sample: AlertDialogFragment29.4.2.6. Dialog Sample: Main Layout main.xml29.5. More Communications with Fragments29.5.1. Using startActivity() and setTargetFragment()29.6. Custom Animations with ObjectAnimator29.7. References29.8. Summary
30. Exploring ActionBar
30.1. Anatomy of an Action Bar30.2. Tabbed Navigation Action Bar Activity30.2.1. Implementing Base Activity Classes30.2.2. Assigning Uniform Behavior for the ActionBar30.2.3. Implementing the Tabbed Listener30.2.4. Implementing the Tabbed Action Bar Activity30.2.4.1. Obtaining an Action Bar Instance30.2.4.2. Action Bar Navigation Modes30.2.5. Scrollable Debug Text View Layout30.2.6. Action Bar and Menu Interaction30.2.6.1. Displaying the Menu30.2.6.2. Menu Items as Actions30.2.7. Android Manifest File30.2.8. Examining the Tabbed Action Bar Activity30.3. List Navigation Action Bar Activity30.3.1. Creating a SpinnerAdapter30.3.2. Creating a List Listener30.3.3. Setting Up a List Action Bar30.3.4. Making Changes to BaseActionBarActivity30.3.5. Making Changes to AndroidManifest.xml30.3.6. Examining the List Action Bar Activity30.4. Standard Navigation Action Bar Activity30.4.1. StandardNavigationActionBarActivity30.4.2. Making Changes to BaseActionBarActivity30.4.3. Making Changes to AndroidManifest.xml30.4.4. Examining the Standard Action Bar activity30.5. References30.6. Summary
31. Additional Topics in 3.0
31.1. List-Based Home Screen Widgets31.1.1. New Remote Views in 3.031.1.2. Working with Lists in Remote Views31.1.2.1. Preparing a Remote Layout31.1.2.2. Loading a Remote Layout31.1.2.3. Setting up RemoteViewsService31.1.2.4. Setting up RemoteViewsFactory31.1.2.4.1. RemoteViewsFactory Constructor31.1.2.4.2. onCreate() Callback31.1.2.4.3. onDestroy() Callback31.1.2.4.4. getCount() Callback31.1.2.4.5. getViewAt() Callback31.1.2.4.6. getLoadingView() Callback31.1.2.4.7. getViewTypeCount() Callback31.1.2.4.8. getItemId() Callback31.1.2.4.9. hasStableIds() Callback31.1.2.4.10. onDataSetChanged() Callback31.1.2.5. Setting up onClick Events31.1.2.6. Responding to onClick Events31.1.3. Working Sample: Test Home Screen List Widget31.1.3.1. Creating the Test Widget Provider31.1.3.2. Creating the Remote Views Factory31.1.3.3. Coding Remote Views Service31.1.3.4. Main Widget Layout file31.1.3.4.1. Layout for the Individual List Items31.1.3.5. Widget Provider Metadata31.1.3.6. AndroidManifest.xml31.1.4. Testing the Test List Widget31.2. Drag and Drop31.2.1. Basics of Drag and Drop in 3.031.2.2. Drag and Drop Sample Application31.2.2.1. List of Files31.2.2.2. Laying out the Sample Drag and Drop Application31.2.2.3. Responding to onDrag in the Drop Zone31.2.2.4. Setting up the Drag Source Views31.2.3. Testing the Sample Drag-and-Drop Application31.3. References31.4. Summary

Content preview from Pro Android 3

Chapter 27. Exploring the Contacts API

In Chapter 4, which covered content providers, we listed the benefits of exposing data through content provider abstraction and showed that such abstracted data is exposed as a series of URLs that can be used to read, query, update, insert, and delete. These URLs and their corresponding cursors become the API for that content provider.

The Contact API is one such content provider API for working with the contact data. Contacts in Android are maintained in a database and exposed through a content provider whose authority is rooted at

content://com.android.contacts

The Android SDK documents the various contracts offered by this contact content provider using a set of java interfaces and classes that are rooted ...

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

Read now

Unlock full access

More than 5,000 organizations count on O’Reilly

O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.

Julian F.

Head of Cybersecurity

I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.

Addison B.

Field Engineer

I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.

Amir M.

Data Platform Tech Lead

I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.

Mark W.

Embedded Software Engineer

Publisher Resources

ISBN: 9781430232223Purchase book

Cloud Computing

Data Engineering

Data Science

AI & ML

Programming Languages

Software Architecture

IT/Ops

Security

Design

Business

Soft Skills

Pro Android 3

by Satya Komatineni, Dave MacLean, Sayed Y. Hashimi

Chapter 27. Exploring the Contacts API

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.