1 page.title= 2 @jd:body 3 <div id="qv-wrapper"> 4 <div id="qv"> 5 <h2> </h2> 6 <ul> 7 <li> Android .</li> 8 <li> 9 . 10 </li> 11 <li> 12 . 13 </li> 14 </ul> 15 <h2> </h2> 16 <ol> 17 <li> 18 <a href="#InformationTypes"> </a> 19 </li> 20 <li> 21 <a href="#RawContactBasics"> </a> 22 </li> 23 <li> 24 <a href="#DataBasics"></a> 25 </li> 26 <li> 27 <a href="#ContactBasics"></a> 28 </li> 29 <li> 30 <a href="#Sources">, </a> 31 </li> 32 <li> 33 <a href="#Permissions"> </a> 34 </li> 35 <li> 36 <a href="#UserProfile"> </a> 37 </li> 38 <li> 39 <a href="#ContactsProviderMetadata"> </a> 40 </li> 41 <li> 42 <a href="#Access"> </a> 43 <li> 44 </li> 45 <li> 46 <a href="#SyncAdapters"> </a> 47 </li> 48 <li> 49 <a href="#SocialStream"> </a> 50 </li> 51 <li> 52 <a href="#AdditionalFeatures"> </a> 53 </li> 54 </ol> 55 <h2> </h2> 56 <ol> 57 <li>{@link android.provider.ContactsContract.Contacts}</li> 58 <li>{@link android.provider.ContactsContract.RawContacts}</li> 59 <li>{@link android.provider.ContactsContract.Data}</li> 60 <li>{@code android.provider.ContactsContract.StreamItems}</li> 61 </ol> 62 <h2> </h2> 63 <ol> 64 <li> 65 <a href="{@docRoot}resources/samples/ContactManager/index.html"> 66 67 </a> 68 </li> 69 <li> 70 <a href="{@docRoot}resources/samples/SampleSyncAdapter/index.html"> 71 </a> 72 </li> 73 </ol> 74 <h2>. :</h2> 75 <ol> 76 <li> 77 <a href="{@docRoot}guide/topics/providers/content-provider-basics.html"> 78 79 </a> 80 </li> 81 </ol> 82 </div> 83 </div> 84 <p> 85 Android, 86 , . , 87 . 88 . 89 , 90 . API 91 - , , 92 . 93 </p> 94 <p> 95 : 96 </p> 97 <ul> 98 <li> 99 ; 100 </li> 101 <li> 102 ; 103 </li> 104 <li> 105 ; 106 </li> 107 <li> 108 , , 109 . 110 </li> 111 </ul> 112 <p> 113 , Android. 114 Android 115 <a href="{@docRoot}guide/topics/providers/content-provider-basics.html"> 116 </a>. 117 <a href="{@docRoot}resources/samples/SampleSyncAdapter/index.html"> </a> 118 119 , - Google. 120 </p> 121 <h2 id="InformationTypes"> </h2> 122 <p> 123 Android. 124 , , , 125 1. 126 </p> 127 <img src="{@docRoot}images/providers/contacts_structure.png" alt="" height="364" id="figure1" /> 128 <p class="img-caption"> 129 <strong>1.</strong> . 130 </p> 131 <p> 132 -. 133 URI , . 134 </p> 135 <dl> 136 <dt> 137 {@link android.provider.ContactsContract.Contacts} 138 </dt> 139 <dd> 140 , . 141 </dd> 142 <dt> 143 {@link android.provider.ContactsContract.RawContacts} 144 </dt> 145 <dd> 146 , . 147 </dd> 148 <dt> 149 {@link android.provider.ContactsContract.Data} 150 </dt> 151 <dd> 152 , . . 153 </dd> 154 </dl> 155 <p> 156 , - {@link android.provider.ContactsContract}, 157 , 158 , . 159 </p> 160 <h2 id="RawContactBasics"> </h2> 161 <p> 162 , 163 . -, 164 . 165 166 . 167 </p> 168 <p> 169 170 {@link android.provider.ContactsContract.RawContacts}. 171 {@link android.provider.ContactsContract.Data}. 172 {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID Data.RAW_CONTACT_ID}, 173 {@code android.provider.BaseColumns#_ID RawContacts._ID} 174 {@link android.provider.ContactsContract.RawContacts}. 175 </p> 176 <h3 id="RawContactsColumns"> </h3> 177 <p> 178 1 {@link android.provider.ContactsContract.RawContacts}, 179 . , . 180 </p> 181 <p class="table-caption" id="table1"> 182 <strong>1.</strong> . 183 </p> 184 <table> 185 <tr> 186 <th scope="col"> </th> 187 <th scope="col"></th> 188 <th scope="col"></th> 189 </tr> 190 <tr> 191 <td> 192 {@link android.provider.ContactsContract.SyncColumns#ACCOUNT_NAME} 193 </td> 194 <td> 195 , . 196 , Google . Gmail 197 . 198 . 199 {@link android.provider.ContactsContract.SyncColumns#ACCOUNT_TYPE}. 200 </td> 201 <td> 202 . 203 .. 204 </td> 205 </tr> 206 <tr> 207 <td> 208 {@link android.provider.ContactsContract.SyncColumns#ACCOUNT_TYPE} 209 </td> 210 <td> 211 , . , 212 Google <code>com.google</code>. 213 , . 214 . 215 </td> 216 <td> 217 , , , 218 . 219 </tr> 220 <tr> 221 <td> 222 {@link android.provider.ContactsContract.RawContactsColumns#DELETED} 223 </td> 224 <td> 225 deleted . 226 </td> 227 <td> 228 , 229 , 230 . 231 </td> 232 </tr> 233 </table> 234 <h4></h4> 235 <p> 236 237 {@link android.provider.ContactsContract.RawContacts}. 238 </p> 239 <ul> 240 <li> 241 242 {@link android.provider.ContactsContract.RawContacts}. 243 {@link android.provider.ContactsContract.Data} 244 {@link android.provider.ContactsContract.CommonDataKinds.StructuredName}. 245 {@link android.provider.ContactsContract.Data} . 246 </li> 247 <li> 248 <strong>!</strong> , 249 , {@link android.accounts.AccountManager}. 250 . 251 , . 252 <p> 253 , , - 254 {@code com.example.dataservice}, 255 :{@code becky.sharp (a] dataservice.example.com}, 256 ({@code com.example.dataservice}) 257 ({@code becky.smart (a] dataservice.example.com}) . 258 , 259 , . 260 . 261 </li> 262 </ul> 263 <h3 id="RawContactsExample"> </h3> 264 <p> 265 , , Emily Dickinson, 266 : 267 </p> 268 <ul> 269 <li><code>emily.dickinson (a] gmail.com</code>;</li> 270 <li><code>emilyd (a] gmail.com</code>;</li> 271 <li> belle_of_amherst Twitter</li> 272 </ul> 273 <p> 274 <em> </em> 275 <em></em>. 276 </p> 277 <p> 278 , Emily Dickinson , Gmail 279 <code>emily.dickinson (a] gmail.com</code>, 280 Thomas Higginson. Gmail 281 <code>emilyd (a] gmail.com</code> Thomas Higginson, 282 . colonel_tom ( Thomas Higginson Twitter) 283 Twitter. 284 </p> 285 <p> 286 : 287 </p> 288 <ol> 289 <li> 290 Thomas Higginson <code>emily.dickinson (a] gmail.com</code>. 291 Google. 292 </li> 293 <li> 294 Thomas Higginson <code>emilyd (a] gmail.com</code>. 295 Google. , 296 , 297 . 298 </li> 299 <li> 300 Thomas Higginson belle_of_amherst. 301 Twitter. 302 </li> 303 </ol> 304 <h2 id="DataBasics"></h2> 305 <p> 306 , 307 {@link android.provider.ContactsContract.Data}, 308 <code>_ID</code> . 309 (, . ). , 310 Thomas Higginson {@code emilyd (a] gmail.com} ( Thomas Higginson, 311 Google <code>emilyd (a] gmail.com</code>) . 312 <code>thigg (a] gmail.com</code> . 313 <code>thomas.higginson (a] gmail.com</code>, 314 . . 315 </p> 316 <p> 317 , . , 318 , ., , - 319 {@link android.provider.ContactsContract.Data}. 320 {@link android.provider.ContactsContract.Data} , 321 . , 322 , 323 . 324 </p> 325 <h3 id="DescriptiveColumns"> </h3> 326 <p> 327 : 328 </p> 329 <dl> 330 <dt> 331 {@link android.provider.ContactsContract.Data#RAW_CONTACT_ID} 332 </dt> 333 <dd> 334 <code>_ID</code> . 335 </dd> 336 <dt> 337 {@link android.provider.ContactsContract.Data#MIMETYPE} 338 </dt> 339 <dd> 340 , , MIME. 341 MIME, 342 {@link android.provider.ContactsContract.CommonDataKinds}. MIME , 343 , . 344 </dd> 345 <dt> 346 {@link android.provider.ContactsContract.DataColumns#IS_PRIMARY} 347 </dt> 348 <dd> 349 , 350 {@link android.provider.ContactsContract.DataColumns#IS_PRIMARY} 351 , . , 352 <strong> </strong>, 353 {@link android.provider.ContactsContract.Data} 354 {@link android.provider.ContactsContract.DataColumns#IS_PRIMARY} 355 , . 356 </dd> 357 </dl> 358 <h3 id="GenericColumns"> </h3> 359 <p> 360 15 (<code>DATA1</code><code>DATA15</code>) 361 362 (<code>SYNC1</code><code>SYNC4</code>), 363 . , , 364 . 365 </p> 366 <p> 367 <code>DATA1</code> . 368 , , , . , 369 . .. 370 </p> 371 <p> 372 <code>DATA15</code> 373 (BLOB), . 374 </p> 375 <h3 id="TypeSpecificNames"> </h3> 376 <p> 377 378 , 379 {@link android.provider.ContactsContract.CommonDataKinds}. 380 , 381 . 382 </p> 383 <p> 384 , {@link android.provider.ContactsContract.CommonDataKinds.Email} 385 {@link android.provider.ContactsContract.Data}, 386 MIME 387 {@link android.provider.ContactsContract.CommonDataKinds.Email#CONTENT_ITEM_TYPE 388 Email.CONTENT_ITEM_TYPE}. 389 {@link android.provider.ContactsContract.CommonDataKinds.Email#ADDRESS} 390 .. 391 {@link android.provider.ContactsContract.CommonDataKinds.Email#ADDRESS} data1, 392 . 393 </p> 394 <p class="caution"> 395 <strong>!</strong> 396 {@link android.provider.ContactsContract.Data} , 397 MIME. 398 . , MIME 399 {@link android.provider.ContactsContract.CommonDataKinds.Email#CONTENT_ITEM_TYPE 400 Email.CONTENT_ITEM_TYPE}, 401 <code>DATA1</code> . . MIME, 402 , . 403 </p> 404 <p> 405 2 , 406 {@link android.provider.ContactsContract.Data}, 407 . 408 </p> 409 <img src="{@docRoot}images/providers/data_columns.png" alt="How type-specific column names map to generic column names" height="311" id="figure2" /> 410 <p class="img-caption"> 411 <strong> 2.</strong> . 412 </p> 413 <h3 id="ColumnMaps"> </h3> 414 <p> 415 2 . 416 </p> 417 <p class="table-caption" id="table2"> 418 <strong> 2.</strong> </p> 419 <table> 420 <tr> 421 <th scope="col"> </th> 422 <th scope="col"> </th> 423 <th scope="col"></th> 424 </tr> 425 <tr> 426 <td>{@link android.provider.ContactsContract.CommonDataKinds.StructuredName}</td> 427 <td> , .</td> 428 <td> .</td> 429 </tr> 430 <tr> 431 <td>{@link android.provider.ContactsContract.CommonDataKinds.Photo}</td> 432 <td> , .</td> 433 <td> .</td> 434 </tr> 435 <tr> 436 <td>{@link android.provider.ContactsContract.CommonDataKinds.Email}</td> 437 <td> . , .</td> 438 <td> ..</td> 439 </tr> 440 <tr> 441 <td>{@link android.provider.ContactsContract.CommonDataKinds.StructuredPostal}</td> 442 <td> , .</td> 443 <td> .</td> 444 </tr> 445 <tr> 446 <td>{@link android.provider.ContactsContract.CommonDataKinds.GroupMembership}</td> 447 <td>, .</td> 448 <td> 449 . 450 <a href="#Groups"> </a>. 451 </td> 452 </tr> 453 </table> 454 <h3 id="ContactBasics"></h3> 455 <p> 456 457 <strong></strong>. , 458 . 459 , . , 460 , . 461 </p> 462 <p class="note"> 463 <strong>.</strong> 464 {@link android.content.ContentResolver#insert(Uri,ContentValues) insert()}, 465 {@link java.lang.UnsupportedOperationException}. , 466 , . 467 </p> 468 <p> 469 , 470 , . , 471 , , 472 . , 473 <em></em> , 474 . 475 </p> 476 <p> 477 478 <code>_ID</code> 479 {@link android.provider.ContactsContract.Contacts Contacts}. <code>CONTACT_ID</code> 480 {@link android.provider.ContactsContract.RawContacts} <code>_ID</code> 481 , . 482 </p> 483 <p> 484 {@link android.provider.ContactsContract.Contacts} 485 {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY}, 486 . , 487 {@code android.provider.BaseColumns#_ID} 488 . , URI 489 {@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI}, 490 {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} , 491 - , 492 {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 493 . , 494 {@code android.provider.BaseColumns#_ID}. 495 </p> 496 <p> 497 3 . 498 </p> 499 <img src="{@docRoot}images/providers/contacts_tables.png" alt="Contacts provider main tables" height="514" id="figure4" /> 500 <p class="img-caption"> 501 <strong>3</strong>. , . 502 </p> 503 <h2 id="Sources">, </h2> 504 <p> 505 , 506 - <strong> </strong>, 507 . 508 , 509 {@link android.content.ContentResolver}. 510 </p> 511 <p> 512 Android -, , . 513 , 514 . 515 <a href="#RawContactsExample"> </a>. 516 . 517 </p> 518 <dl> 519 <dt> 520 521 </dt> 522 <dd> 523 , . 524 . , Google , 525 <code>google.com</code>. , 526 {@link android.accounts.AccountManager}. 527 </dd> 528 <dt> 529 530 </dt> 531 <dd> 532 . Google 533 , Google, .. 534 , , . 535 </dd> 536 </dl> 537 <p> 538 . Google 539 ; , 540 , . 541 . 542 . 543 </p> 544 <p> 545 , 546 . 547 <a href="#SyncAdapters"> </a>. 548 </p> 549 <p> 550 4 , 551 . , sync adapters, . 552 </p> 553 <img src="{@docRoot}images/providers/ContactsDataFlow.png" alt="Flow of data about people" height="252" id="figure5" /> 554 <p class="img-caption"> 555 <strong>4</strong>. . 556 </p> 557 <h2 id="Permissions"> </h2> 558 <p> 559 , , 560 . 561 </p> 562 <dl> 563 <dt> </dt> 564 <dd> 565 {@link android.Manifest.permission#READ_CONTACTS}, 566 <code>AndroidManifest.xml</code> 567 <code><a href="{@docRoot}guide/topics/manifest/uses-permission-element.html"> 568 <uses-permission></a></code> 569 <code><uses-permission android:name="android.permission.READ_CONTACTS"></code>. 570 </dd> 571 <dt> </dt> 572 <dd> 573 {@link android.Manifest.permission#WRITE_CONTACTS}, 574 <code>AndroidManifest.xml</code> 575 <code><a href="{@docRoot}guide/topics/manifest/uses-permission-element.html"> 576 <uses-permission></a></code> 577 <code><uses-permission android:name="android.permission.WRITE_CONTACTS"></code>. 578 </dd> 579 </dl> 580 <p> 581 . 582 583 <a href="#UserProfile"> </a> . 584 </p> 585 <p> 586 , . , 587 , . 588 , , 589 . 590 </p> 591 <h2 id="UserProfile"> </h2> 592 <p> 593 {@link android.provider.ContactsContract.Contacts} , 594 . <code>user</code> , 595 . 596 , . 597 . 598 {@link android.provider.ContactsContract.Profile}. 599 </p> 600 <p> 601 . 602 {@link android.Manifest.permission#READ_CONTACTS} 603 {@link android.Manifest.permission#WRITE_CONTACTS}, , 604 {@code android.Manifest.permission#READ_PROFILE} 605 {@code android.Manifest.permission#WRITE_PROFILE} 606 . 607 </p> 608 <p> 609 , . 610 {@code android.Manifest.permission#READ_PROFILE} 611 . , 612 . 613 </p> 614 <p> 615 , 616 {@link android.content.ContentResolver#query(Uri,String[], String, String[], String) 617 ContentResolver.query()}. URI 618 {@link android.provider.ContactsContract.Profile#CONTENT_URI} 619 . URI URI 620 . . 621 </p> 622 <pre> 623 // Sets the columns to retrieve for the user profile 624 mProjection = new String[] 625 { 626 Profile._ID, 627 Profile.DISPLAY_NAME_PRIMARY, 628 Profile.LOOKUP_KEY, 629 Profile.PHOTO_THUMBNAIL_URI 630 }; 631 632 // Retrieves the profile from the Contacts Provider 633 mProfileCursor = 634 getContentResolver().query( 635 Profile.CONTENT_URI, 636 mProjection , 637 null, 638 null, 639 null); 640 </pre> 641 <p class="note"> 642 <strong>.</strong> , 643 , 644 {@link android.provider.ContactsContract.ContactsColumns#IS_USER_PROFILE} . 645 1, . 646 </p> 647 <h2 id="ContactsProviderMetadata"> </h2> 648 <p> 649 , 650 . , 651 , , 652 {@link android.provider.ContactsContract.Settings} 653 {@link android.provider.ContactsContract.SyncState}. 654 . 655 </p> 656 <p class="table-caption" id="table3"> 657 <strong> 3.</strong> </p> 658 <table> 659 <tr> 660 <th scope="col"></th> 661 <th scope="col"></th> 662 <th scope="col"></th> 663 <th scope="col"></th> 664 </tr> 665 <tr> 666 <td rowspan="2">{@link android.provider.ContactsContract.RawContacts}</td> 667 <td rowspan="2">{@link android.provider.ContactsContract.SyncColumns#DIRTY}</td> 668 <td>0 .</td> 669 <td rowspan="2"> 670 , 671 . 672 Android. 673 <p> 674 , , URI 675 676 {@link android.provider.ContactsContract#CALLER_IS_SYNCADAPTER}. . 677 , , , 678 , . 679 </p> 680 </td> 681 </tr> 682 <tr> 683 <td>1 , .</td> 684 </tr> 685 <tr> 686 <td>{@link android.provider.ContactsContract.RawContacts}</td> 687 <td>{@link android.provider.ContactsContract.SyncColumns#VERSION}</td> 688 <td> .</td> 689 <td> 690 691 . 692 </td> 693 </tr> 694 <tr> 695 <td>{@link android.provider.ContactsContract.Data}</td> 696 <td>{@link android.provider.ContactsContract.DataColumns#DATA_VERSION}</td> 697 <td> .</td> 698 <td> 699 700 . 701 </td> 702 </tr> 703 <tr> 704 <td>{@link android.provider.ContactsContract.RawContacts}</td> 705 <td>{@link android.provider.ContactsContract.SyncColumns#SOURCE_ID}</td> 706 <td> 707 , , 708 . 709 </td> 710 <td> 711 , 712 . Android 713 , . 714 , 715 {@link android.provider.ContactsContract.SyncColumns#SOURCE_ID}. 716 <p> 717 , <strong></strong> 718 . 719 </p> 720 <ul> 721 <li> 722 : . 723 , . 724 , <em></em> 725 . , Thomas Higginson 726 {@code emily.dickinson (a] gmail.com} 727 , Thomas Higginson 728 {@code emilyd (a] gmail.com}. 729 </li> 730 <li> 731 : - 732 . , 733 , , 734 . , 735 . 736 </li> 737 </ul> 738 </td> 739 </tr> 740 <tr> 741 <td rowspan="2">{@link android.provider.ContactsContract.Groups}</td> 742 <td rowspan="2">{@link android.provider.ContactsContract.GroupsColumns#GROUP_VISIBLE}</td> 743 <td>0 , , Android.</td> 744 <td> 745 , 746 . 747 </td> 748 </tr> 749 <tr> 750 <td>1 , , .</td> 751 </tr> 752 <tr> 753 <td rowspan="2">{@link android.provider.ContactsContract.Settings}</td> 754 <td rowspan="2"> 755 {@link android.provider.ContactsContract.SettingsColumns#UNGROUPED_VISIBLE}</td> 756 <td> 757 0 , , 758 Android. 759 </td> 760 <td rowspan="2"> 761 , 762 ( 763 {@link android.provider.ContactsContract.CommonDataKinds.GroupMembership} 764 {@link android.provider.ContactsContract.Data}). 765 {@link android.provider.ContactsContract.Settings} 766 , , - . 767 , . 768 </td> 769 </tr> 770 <tr> 771 <td> 772 1 , , 773 Android. 774 </td> 775 776 </tr> 777 <tr> 778 <td>{@link android.provider.ContactsContract.SyncState}</td> 779 <td>()</td> 780 <td> 781 . 782 </td> 783 <td> 784 785 . 786 </td> 787 </tr> 788 </table> 789 <h2 id="Access"> </h2> 790 <p> 791 , , 792 : 793 </p> 794 <ul> 795 <li> 796 ; 797 </li> 798 <li> 799 ; 800 </li> 801 <li> 802 ; 803 </li> 804 <li> 805 . 806 </li> 807 </ul> 808 <p> 809 810 <a href="#SyncAdapters"> </a>. 811 </p> 812 <h3 id="Entities"> </h3> 813 <p> 814 , 815 . , 816 , , 817 {@link android.provider.ContactsContract.RawContacts} 818 {@link android.provider.ContactsContract.Contacts} 819 {@link android.provider.ContactsContract.CommonDataKinds.Email} 820 {@link android.provider.ContactsContract.RawContacts}. , 821 <strong></strong>, 822 . 823 </p> 824 <p> 825 , . 826 827 . {@link android.database.Cursor}, 828 . , 829 {@link android.provider.ContactsContract.Contacts.Entity} 830 {@link android.provider.ContactsContract.CommonDataKinds.Email} , 831 , {@link android.database.Cursor}, 832 {@link android.provider.ContactsContract.CommonDataKinds.Email}. 833 </p> 834 <p> 835 . 836 , , 837 . , 838 , 839 . 840 </p> 841 <p class="note"> 842 <strong>.</strong> 843 . , 844 , {@link java.lang.Exception}. 845 </p> 846 <p> 847 . 848 , : . 849 ; 850 . {@link android.provider.ContactsContract.Contacts.Entity} 851 , , 852 . 853 </p> 854 <p> 855 : 856 </p> 857 <pre> 858 ... 859 /* 860 * Appends the entity path to the URI. In the case of the Contacts Provider, the 861 * expected URI is content://com.google.contacts/#/entity (# is the ID value). 862 */ 863 mContactUri = Uri.withAppendedPath( 864 mContactUri, 865 ContactsContract.Contacts.Entity.CONTENT_DIRECTORY); 866 867 // Initializes the loader identified by LOADER_ID. 868 getLoaderManager().initLoader( 869 LOADER_ID, // The identifier of the loader to initialize 870 null, // Arguments for the loader (in this case, none) 871 this); // The context of the activity 872 873 // Creates a new cursor adapter to attach to the list view 874 mCursorAdapter = new SimpleCursorAdapter( 875 this, // the context of the activity 876 R.layout.detail_list_item, // the view item containing the detail widgets 877 mCursor, // the backing cursor 878 mFromColumns, // the columns in the cursor that provide the data 879 mToViews, // the views in the view item that display the data 880 0); // flags 881 882 // Sets the ListView's backing adapter. 883 mRawContactList.setAdapter(mCursorAdapter); 884 ... 885 @Override 886 public Loader<Cursor> onCreateLoader(int id, Bundle args) { 887 888 /* 889 * Sets the columns to retrieve. 890 * RAW_CONTACT_ID is included to identify the raw contact associated with the data row. 891 * DATA1 contains the first column in the data row (usually the most important one). 892 * MIMETYPE indicates the type of data in the data row. 893 */ 894 String[] projection = 895 { 896 ContactsContract.Contacts.Entity.RAW_CONTACT_ID, 897 ContactsContract.Contacts.Entity.DATA1, 898 ContactsContract.Contacts.Entity.MIMETYPE 899 }; 900 901 /* 902 * Sorts the retrieved cursor by raw contact id, to keep all data rows for a single raw 903 * contact collated together. 904 */ 905 String sortOrder = 906 ContactsContract.Contacts.Entity.RAW_CONTACT_ID + 907 " ASC"; 908 909 /* 910 * Returns a new CursorLoader. The arguments are similar to 911 * ContentResolver.query(), except for the Context argument, which supplies the location of 912 * the ContentResolver to use. 913 */ 914 return new CursorLoader( 915 getApplicationContext(), // The activity's context 916 mContactUri, // The entity content URI for a single contact 917 projection, // The columns to retrieve 918 null, // Retrieve all the raw contacts and their data rows. 919 null, // 920 sortOrder); // Sort by the raw contact ID. 921 } 922 </pre> 923 <p> 924 {@link android.app.LoaderManager} 925 {@link android.app.LoaderManager.LoaderCallbacks#onLoadFinished(Loader, D) 926 onLoadFinished()}. 927 {@link android.database.Cursor} . 928 {@link android.database.Cursor} . 929 </p> 930 <h3 id="Transactions"> </h3> 931 <p> 932 , 933 {@link java.util.ArrayList} 934 {@link android.content.ContentProviderOperation} 935 {@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()}. 936 937 {@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()} 938 , 939 . 940 . 941 </p> 942 <p class="note"> 943 <strong>.</strong> <em></em> , 944 . 945 946 <a href="#Intents"> </a>. 947 </p> 948 <h4></h4> 949 <p> 950 , 951 . 952 953 , <strong></strong> . 954 {@link android.content.ContentProviderOperation}, 955 {@link android.content.ContentProviderOperation#isYieldAllowed()} 956 <code>true</code>. , 957 , . , 958 {@link java.util.ArrayList} 959 . 960 </p> 961 <p> 962 963 {@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()} . 964 . 965 , , 966 , , 967 . 968 </p> 969 <p> 970 . 971 , . , 972 . 973 974 . 975 </p> 976 <h4> </h4> 977 <p> 978 979 {@link android.content.ContentProviderOperation} 980 981 {@code android.provider.BaseColumns#_ID} 982 {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}. 983 , {@link android.content.ContentProviderOperation} 984 , 985 {@link android.content.ContentProviderOperation} . , 986 {@link android.content.ContentProviderOperation.Builder} 987 {@link android.content.ContentProviderOperation.Builder#withValueBackReference(String, int) withValueBackReference()}. 988 989 . 990 </p> 991 <p> 992 {@link android.content.ContentProviderOperation.Builder#withValueBackReference(String, int) withValueBackReference()} 993 : 994 </p> 995 <dl> 996 <dt> 997 <code>key</code> 998 </dt> 999 <dd> 1000 -. 1001 , . 1002 </dd> 1003 <dt> 1004 <code>previousResult</code> 1005 </dt> 1006 <dd> 1007 , 0, 1008 {@link android.content.ContentProviderResult} 1009 {@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()}. 1010 1011 . <code>previousResult</code> 1012 , 1013 <code>key</code>. 1014 {@code android.provider.BaseColumns#_ID}, 1015 {@link android.provider.ContactsContract.Data}. 1016 <p> 1017 1018 {@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()}. 1019 {@link java.util.ArrayList} 1020 {@link android.content.ContentProviderOperation}. 1021 <code>null</code>, 1022 1023 {@link android.content.ContentProviderOperation.Builder#withValueBackReference(String, int) withValueBackReference()} 1024 {@link java.lang.Exception}. 1025 1026 </p> 1027 </dd> 1028 </dl> 1029 <p> 1030 . 1031 , . 1032 <code>createContacEntry()</code>, 1033 <code>ContactAdder</code> 1034 <code><a href="{@docRoot}resources/samples/ContactManager/index.html"> 1035 Contact Manager</a></code>. 1036 </p> 1037 <p> 1038 . 1039 , . 1040 </p> 1041 <pre> 1042 // Creates a contact entry from the current UI values, using the currently-selected account. 1043 protected void createContactEntry() { 1044 /* 1045 * Gets values from the UI 1046 */ 1047 String name = mContactNameEditText.getText().toString(); 1048 String phone = mContactPhoneEditText.getText().toString(); 1049 String email = mContactEmailEditText.getText().toString(); 1050 1051 int phoneType = mContactPhoneTypes.get( 1052 mContactPhoneTypeSpinner.getSelectedItemPosition()); 1053 1054 int emailType = mContactEmailTypes.get( 1055 mContactEmailTypeSpinner.getSelectedItemPosition()); 1056 </pre> 1057 <p> 1058 1059 {@link android.provider.ContactsContract.RawContacts}: 1060 </p> 1061 <pre> 1062 /* 1063 * Prepares the batch operation for inserting a new raw contact and its data. Even if 1064 * the Contacts Provider does not have any data for this person, you can't add a Contact, 1065 * only a raw contact. The Contacts Provider will then add a Contact automatically. 1066 */ 1067 1068 // Creates a new array of ContentProviderOperation objects. 1069 ArrayList<ContentProviderOperation> ops = 1070 new ArrayList<ContentProviderOperation>(); 1071 1072 /* 1073 * Creates a new raw contact with its account type (server type) and account name 1074 * (user's account). Remember that the display name is not stored in this row, but in a 1075 * StructuredName data row. No other data is required. 1076 */ 1077 ContentProviderOperation.Builder op = 1078 ContentProviderOperation.newInsert(ContactsContract.RawContacts.CONTENT_URI) 1079 .withValue(ContactsContract.RawContacts.ACCOUNT_TYPE, mSelectedAccount.getType()) 1080 .withValue(ContactsContract.RawContacts.ACCOUNT_NAME, mSelectedAccount.getName()); 1081 1082 // Builds the operation and adds it to the array of operations 1083 ops.add(op.build()); 1084 </pre> 1085 <p> 1086 , .. 1087 </p> 1088 <p> 1089 1090 {@link android.content.ContentProviderOperation.Builder#withValueBackReference(String, int) withValueBackReference()} 1091 1092 {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}. 1093 {@link android.content.ContentProviderResult} , 1094 1095 {@code android.provider.BaseColumns#_ID}. 1096 {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID} 1097 {@link android.provider.ContactsContract.RawContacts}, . 1098 </p> 1099 <p> 1100 {@link android.content.ContentProviderOperation.Builder}, ., 1101 {@link android.content.ContentProviderOperation.Builder#withYieldAllowed(boolean) 1102 withYieldAllowed()}, : 1103 </p> 1104 <pre> 1105 // Creates the display name for the new raw contact, as a StructuredName data row. 1106 op = 1107 ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI) 1108 /* 1109 * withValueBackReference sets the value of the first argument to the value of 1110 * the ContentProviderResult indexed by the second argument. In this particular 1111 * call, the raw contact ID column of the StructuredName data row is set to the 1112 * value of the result returned by the first operation, which is the one that 1113 * actually adds the raw contact row. 1114 */ 1115 .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0) 1116 1117 // Sets the data row's MIME type to StructuredName 1118 .withValue(ContactsContract.Data.MIMETYPE, 1119 ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE) 1120 1121 // Sets the data row's display name to the name in the UI. 1122 .withValue(ContactsContract.CommonDataKinds.StructuredName.DISPLAY_NAME, name); 1123 1124 // Builds the operation and adds it to the array of operations 1125 ops.add(op.build()); 1126 1127 // Inserts the specified phone number and type as a Phone data row 1128 op = 1129 ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI) 1130 /* 1131 * Sets the value of the raw contact id column to the new raw contact ID returned 1132 * by the first operation in the batch. 1133 */ 1134 .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0) 1135 1136 // Sets the data row's MIME type to Phone 1137 .withValue(ContactsContract.Data.MIMETYPE, 1138 ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE) 1139 1140 // Sets the phone number and type 1141 .withValue(ContactsContract.CommonDataKinds.Phone.NUMBER, phone) 1142 .withValue(ContactsContract.CommonDataKinds.Phone.TYPE, phoneType); 1143 1144 // Builds the operation and adds it to the array of operations 1145 ops.add(op.build()); 1146 1147 // Inserts the specified email and type as a Phone data row 1148 op = 1149 ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI) 1150 /* 1151 * Sets the value of the raw contact id column to the new raw contact ID returned 1152 * by the first operation in the batch. 1153 */ 1154 .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0) 1155 1156 // Sets the data row's MIME type to Email 1157 .withValue(ContactsContract.Data.MIMETYPE, 1158 ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE) 1159 1160 // Sets the email address and type 1161 .withValue(ContactsContract.CommonDataKinds.Email.ADDRESS, email) 1162 .withValue(ContactsContract.CommonDataKinds.Email.TYPE, emailType); 1163 1164 /* 1165 * Demonstrates a yield point. At the end of this insert, the batch operation's thread 1166 * will yield priority to other threads. Use after every set of operations that affect a 1167 * single contact, to avoid degrading performance. 1168 */ 1169 op.withYieldAllowed(true); 1170 1171 // Builds the operation and adds it to the array of operations 1172 ops.add(op.build()); 1173 </pre> 1174 <p> 1175 1176 {@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()} 1177 . 1178 </p> 1179 <pre> 1180 // Ask the Contacts Provider to create a new contact 1181 Log.d(TAG,"Selected account: " + mSelectedAccount.getName() + " (" + 1182 mSelectedAccount.getType() + ")"); 1183 Log.d(TAG,"Creating contact: " + name); 1184 1185 /* 1186 * Applies the array of ContentProviderOperation objects in batch. The results are 1187 * discarded. 1188 */ 1189 try { 1190 1191 getContentResolver().applyBatch(ContactsContract.AUTHORITY, ops); 1192 } catch (Exception e) { 1193 1194 // Display a warning 1195 Context ctx = getApplicationContext(); 1196 1197 CharSequence txt = getString(R.string.contactCreationFailure); 1198 int duration = Toast.LENGTH_SHORT; 1199 Toast toast = Toast.makeText(ctx, txt, duration); 1200 toast.show(); 1201 1202 // Log exception 1203 Log.e(TAG, "Exception encountered while inserting contact: " + e); 1204 } 1205 } 1206 </pre> 1207 <p> 1208 <strong> </strong>. 1209 . 1210 , , 1211 . , , 1212 . 1213 </p> 1214 <p> 1215 , , 1216 . , 1217 , , . 1218 </p> 1219 <p> 1220 1221 {@link android.provider.ContactsContract.RawContacts}. 1222 </p> 1223 <ol> 1224 <li> 1225 {@link android.provider.ContactsContract.SyncColumns#VERSION} 1226 , , . 1227 </li> 1228 <li> 1229 {@link android.content.ContentProviderOperation.Builder}, 1230 , 1231 {@link android.content.ContentProviderOperation#newAssertQuery(Uri)}. URI 1232 {@link android.provider.ContactsContract.RawContacts#CONTENT_URI 1233 RawContacts.CONTENT_URI}, 1234 {@code android.provider.BaseColumns#_ID} . 1235 </li> 1236 <li> 1237 {@link android.content.ContentProviderOperation.Builder} 1238 {@link android.content.ContentProviderOperation.Builder#withValue(String, Object) 1239 withValue()}, {@link android.provider.ContactsContract.SyncColumns#VERSION} 1240 , . 1241 </li> 1242 <li> 1243 {@link android.content.ContentProviderOperation.Builder} 1244 {@link android.content.ContentProviderOperation.Builder#withExpectedCount(int) 1245 withExpectedCount()}, , . 1246 </li> 1247 <li> 1248 {@link android.content.ContentProviderOperation.Builder#build()}, 1249 {@link android.content.ContentProviderOperation}, 1250 {@link java.util.ArrayList}, 1251 {@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()}. 1252 </li> 1253 <li> 1254 . 1255 </li> 1256 </ol> 1257 <p> 1258 1259 , assert {@link android.content.ContentProviderOperation} 1260 . 1261 . 1262 </p> 1263 <p> 1264 , assert 1265 {@link android.content.ContentProviderOperation} 1266 {@link android.content.CursorLoader}. 1267 </p> 1268 <pre> 1269 /* 1270 * The application uses CursorLoader to query the raw contacts table. The system calls this method 1271 * when the load is finished. 1272 */ 1273 public void onLoadFinished(Loader<Cursor> loader, Cursor cursor) { 1274 1275 // Gets the raw contact's _ID and VERSION values 1276 mRawContactID = cursor.getLong(cursor.getColumnIndex(BaseColumns._ID)); 1277 mVersion = cursor.getInt(cursor.getColumnIndex(SyncColumns.VERSION)); 1278 } 1279 1280 ... 1281 1282 // Sets up a Uri for the assert operation 1283 Uri rawContactUri = ContentUris.withAppendedId(RawContacts.CONTENT_URI, mRawContactID); 1284 1285 // Creates a builder for the assert operation 1286 ContentProviderOperation.Builder assertOp = ContentProviderOperation.netAssertQuery(rawContactUri); 1287 1288 // Adds the assertions to the assert operation: checks the version and count of rows tested 1289 assertOp.withValue(SyncColumns.VERSION, mVersion); 1290 assertOp.withExpectedCount(1); 1291 1292 // Creates an ArrayList to hold the ContentProviderOperation objects 1293 ArrayList ops = new ArrayList<ContentProviderOperationg>; 1294 1295 ops.add(assertOp.build()); 1296 1297 // You would add the rest of your batch operations to "ops" here 1298 1299 ... 1300 1301 // Applies the batch. If the assert fails, an Exception is thrown 1302 try 1303 { 1304 ContentProviderResult[] results = 1305 getContentResolver().applyBatch(AUTHORITY, ops); 1306 1307 } catch (OperationApplicationException e) { 1308 1309 // Actions you want to take if the assert operation fails go here 1310 } 1311 </pre> 1312 <h3 id="Intents"> </h3> 1313 <p> 1314 , , 1315 . , 1316 . : 1317 <ul> 1318 <li> ;</li> 1319 <li> ;</li> 1320 <li> ;</li> 1321 <li> .</li> 1322 </ul> 1323 <p> 1324 , , 1325 . 1326 </p> 1327 <p> 1328 , , 1329 . 1330 . , , 1331 , 1332 , . 1333 </p> 1334 <p> 1335 1336 <a href="{@docRoot}guide/topics/providers/content-provider-basics.html"> </a> 1337 . 4 , 1338 MIME , . 1339 , 1340 {@link android.content.Intent#putExtra(String, String) putExtra()}, 1341 {@link android.provider.ContactsContract.Intents.Insert}. 1342 </p> 1343 <p class="table-caption" id="table4"> 1344 <strong> 4.</strong> . 1345 </p> 1346 <table style="width:75%"> 1347 <tr> 1348 <th scope="col" style="width:10%"></th> 1349 <th scope="col" style="width:5%"></th> 1350 <th scope="col" style="width:10%"></th> 1351 <th scope="col" style="width:10%"> MIME</th> 1352 <th scope="col" style="width:25%"></th> 1353 </tr> 1354 <tr> 1355 <td><strong> </strong></td> 1356 <td>{@link android.content.Intent#ACTION_PICK}</td> 1357 <td> 1358 : 1359 <ul> 1360 <li> 1361 {@link android.provider.ContactsContract.Contacts#CONTENT_URI Contacts.CONTENT_URI} 1362 ( ); 1363 </li> 1364 <li> 1365 {@link android.provider.ContactsContract.CommonDataKinds.Phone#CONTENT_URI Phone.CONTENT_URI} 1366 ( ); 1367 </li> 1368 <li> 1369 {@link android.provider.ContactsContract.CommonDataKinds.StructuredPostal#CONTENT_URI 1370 StructuredPostal.CONTENT_URI} 1371 ( ); 1372 </li> 1373 <li> 1374 {@link android.provider.ContactsContract.CommonDataKinds.Email#CONTENT_URI Email.CONTENT_URI} 1375 ( . ). 1376 </li> 1377 </ul> 1378 </td> 1379 <td> 1380 1381 </td> 1382 <td> 1383 ( 1384 URI ). 1385 <p> 1386 1387 {@link android.app.Activity#startActivityForResult(Intent, int) startActivityForResult()}, 1388 URI . URI 1389 URI , <code>LOOKUP_ID</code> . 1390 , , URI 1391 , . 1392 <a href="{@docRoot}guide/topics/providers/content-provider-basics.html"> 1393 </a>. 1394 </p> 1395 </td> 1396 </tr> 1397 <tr> 1398 <td><strong> </strong></td> 1399 <td>{@link android.provider.ContactsContract.Intents.Insert#ACTION Insert.ACTION}</td> 1400 <td>/</td> 1401 <td> 1402 {@link android.provider.ContactsContract.RawContacts#CONTENT_TYPE 1403 RawContacts.CONTENT_TYPE}, MIME . 1404 </td> 1405 <td> 1406 <strong> </strong> , . 1407 , . 1408 {@link android.app.Activity#startActivityForResult(Intent, int) startActivityForResult()} 1409 URI 1410 {@link android.app.Activity#onActivityResult(int, int, Intent) onActivityResult()} 1411 {@link android.content.Intent} 1412 data. , {@link android.content.Intent#getData()}. 1413 </td> 1414 </tr> 1415 <tr> 1416 <td><strong> </strong></td> 1417 <td>{@link android.content.Intent#ACTION_EDIT}</td> 1418 <td> 1419 {@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI} 1420 . , 1421 . 1422 </td> 1423 <td> 1424 {@link android.provider.ContactsContract.Contacts#CONTENT_ITEM_TYPE 1425 Contacts.CONTENT_ITEM_TYPE}, .</td> 1426 <td> 1427 . 1428 , . <strong></strong> 1429 , . 1430 </td> 1431 </tr> 1432 <tr> 1433 <td><strong> , </strong></td> 1434 <td>{@link android.content.Intent#ACTION_INSERT_OR_EDIT}</td> 1435 <td> 1436 / 1437 </td> 1438 <td> 1439 {@link android.provider.ContactsContract.Contacts#CONTENT_ITEM_TYPE} 1440 </td> 1441 <td> 1442 . 1443 . , 1444 , 1445 . , . , 1446 , 1447 . 1448 <p class="note"> 1449 <strong>.</strong> , 1450 . , 1451 , , 1452 , . 1453 , . 1454 </p> 1455 </td> 1456 </tr> 1457 </table> 1458 <p> 1459 , , 1460 . 1461 {@link android.content.ContentResolver#delete(Uri, String, String[]) ContentResolver.delete()} 1462 {@link android.content.ContentProviderOperation#newDelete(Uri) 1463 ContentProviderOperation.newDelete()}. 1464 </p> 1465 <p> 1466 , 1467 . 1468 </p> 1469 <pre> 1470 // Gets values from the UI 1471 String name = mContactNameEditText.getText().toString(); 1472 String phone = mContactPhoneEditText.getText().toString(); 1473 String email = mContactEmailEditText.getText().toString(); 1474 1475 String company = mCompanyName.getText().toString(); 1476 String jobtitle = mJobTitle.getText().toString(); 1477 1478 // Creates a new intent for sending to the device's contacts application 1479 Intent insertIntent = new Intent(ContactsContract.Intents.Insert.ACTION); 1480 1481 // Sets the MIME type to the one expected by the insertion activity 1482 insertIntent.setType(ContactsContract.RawContacts.CONTENT_TYPE); 1483 1484 // Sets the new contact name 1485 insertIntent.putExtra(ContactsContract.Intents.Insert.NAME, name); 1486 1487 // Sets the new company and job title 1488 insertIntent.putExtra(ContactsContract.Intents.Insert.COMPANY, company); 1489 insertIntent.putExtra(ContactsContract.Intents.Insert.JOB_TITLE, jobtitle); 1490 1491 /* 1492 * Demonstrates adding data rows as an array list associated with the DATA key 1493 */ 1494 1495 // Defines an array list to contain the ContentValues objects for each row 1496 ArrayList<ContentValues> contactData = new ArrayList<ContentValues>(); 1497 1498 1499 /* 1500 * Defines the raw contact row 1501 */ 1502 1503 // Sets up the row as a ContentValues object 1504 ContentValues rawContactRow = new ContentValues(); 1505 1506 // Adds the account type and name to the row 1507 rawContactRow.put(ContactsContract.RawContacts.ACCOUNT_TYPE, mSelectedAccount.getType()); 1508 rawContactRow.put(ContactsContract.RawContacts.ACCOUNT_NAME, mSelectedAccount.getName()); 1509 1510 // Adds the row to the array 1511 contactData.add(rawContactRow); 1512 1513 /* 1514 * Sets up the phone number data row 1515 */ 1516 1517 // Sets up the row as a ContentValues object 1518 ContentValues phoneRow = new ContentValues(); 1519 1520 // Specifies the MIME type for this data row (all data rows must be marked by their type) 1521 phoneRow.put( 1522 ContactsContract.Data.MIMETYPE, 1523 ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE 1524 ); 1525 1526 // Adds the phone number and its type to the row 1527 phoneRow.put(ContactsContract.CommonDataKinds.Phone.NUMBER, phone); 1528 1529 // Adds the row to the array 1530 contactData.add(phoneRow); 1531 1532 /* 1533 * Sets up the email data row 1534 */ 1535 1536 // Sets up the row as a ContentValues object 1537 ContentValues emailRow = new ContentValues(); 1538 1539 // Specifies the MIME type for this data row (all data rows must be marked by their type) 1540 emailRow.put( 1541 ContactsContract.Data.MIMETYPE, 1542 ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE 1543 ); 1544 1545 // Adds the email address and its type to the row 1546 emailRow.put(ContactsContract.CommonDataKinds.Email.ADDRESS, email); 1547 1548 // Adds the row to the array 1549 contactData.add(emailRow); 1550 1551 /* 1552 * Adds the array to the intent's extras. It must be a parcelable object in order to 1553 * travel between processes. The device's contacts app expects its key to be 1554 * Intents.Insert.DATA 1555 */ 1556 insertIntent.putParcelableArrayListExtra(ContactsContract.Intents.Insert.DATA, contactData); 1557 1558 // Send out the intent to start the device's contacts app in its add contact activity. 1559 startActivity(insertIntent); 1560 </pre> 1561 <h3 id="DataIntegrity"> </h3> 1562 <p> 1563 , , , 1564 , . 1565 . 1566 : 1567 </p> 1568 <dl> 1569 <dt> 1570 {@link android.provider.ContactsContract.CommonDataKinds.StructuredName} 1571 {@link android.provider.ContactsContract.RawContacts}. 1572 </dt> 1573 <dd> 1574 {@link android.provider.ContactsContract.Data} {@link android.provider.ContactsContract.RawContacts} 1575 {@link android.provider.ContactsContract.CommonDataKinds.StructuredName}, 1576 1577 . 1578 </dd> 1579 <dt> 1580 {@link android.provider.ContactsContract.Data} 1581 {@link android.provider.ContactsContract.RawContacts}. 1582 </dt> 1583 <dd> 1584 {@link android.provider.ContactsContract.Data}, 1585 {@link android.provider.ContactsContract.RawContacts}, 1586 , , . 1587 </dd> 1588 <dt> 1589 , . 1590 </dt> 1591 <dd> 1592 , 1593 . , 1594 , , , , 1595 . 1596 </dd> 1597 <dt> 1598 1599 , URI , URI, , MIME 1600 {@link android.provider.ContactsContract.CommonDataKinds.CommonColumns#TYPE} , {@link android.provider.ContactsContract} . 1601 </dt> 1602 <dd> 1603 . , 1604 . 1605 </dd> 1606 </dl> 1607 <h3 id="CustomData"> </h3> 1608 <p> 1609 MIME, , , 1610 {@link android.provider.ContactsContract.Data} . 1611 , 1612 {@link android.provider.ContactsContract.DataColumns}, 1613 . , , 1614 , 1615 . , 1616 . 1617 </p> 1618 <p> 1619 <code>contacts.xml</code>, 1620 <code><ContactsAccountType></code> 1621 <code><ContactsDataKind></code> . 1622 <a href="#SocialStreamDataKind"><code><ContactsDataKind> element</code></a>. 1623 </p> 1624 <p> 1625 MIME 1626 <a href="{@docRoot}guide/topics/providers/content-provider-creating.html"> 1627 </a>. 1628 </p> 1629 <h2 id="SyncAdapters"> </h2> 1630 <p> 1631 <strong></strong> 1632 . 1633 . 1634 , 1635 . , 1636 , . 1637 </p> 1638 <p> 1639 , Android 1640 , : 1641 <ul> 1642 1643 <li> 1644 ; 1645 </li> 1646 <li> 1647 ; 1648 </li> 1649 <li> 1650 . 1651 </li> 1652 </ul> 1653 <p> 1654 . 1655 , . 1656 . 1657 </p> 1658 <h3 id="SyncClassesFiles"> </h3> 1659 <p> 1660 1661 {@link android.content.AbstractThreadedSyncAdapter} 1662 Android. 1663 , XML, . XML 1664 - , 1665 . , 1666 1667 . 1668 , . 1669 </p> 1670 <p class="note"> 1671 <strong>.</strong> 1672 , 1673 . , - Google 1674 <code>com.google</code>. Google, 1675 ; 1676 . 1677 </p> 1678 <p> 1679 , , 1680 Android , 1681 . 1682 , 1683 {@link android.accounts.AbstractAccountAuthenticator}. 1684 : 1685 <ol> 1686 <li> 1687 (<strong> </strong> 1688 ). 1689 </li> 1690 <li> 1691 . 1692 </li> 1693 <li> 1694 , , . 1695 </li> 1696 </ol> 1697 <p> 1698 , 1699 . 1700 {@link android.accounts.AccountManager} , 1701 , , OAuth2. 1702 </p> 1703 <p> 1704 , . 1705 , Android . 1706 </p> 1707 <h3 id="SyncAdapterImplementing"> </h3> 1708 <p> 1709 , 1710 Android, . 1711 </p> 1712 <dl> 1713 <dt> 1714 {@link android.app.Service}, 1715 . 1716 </dt> 1717 <dd> 1718 , 1719 {@link android.app.Service#onBind(Intent) onBind()} , 1720 {@link android.os.IBinder} . 1721 . 1722 <p> 1723 1724 <a href="{@docRoot}resources/samples/SampleSyncAdapter/index.html"> </a> 1725 <code>com.example.android.samplesync.syncadapter.SyncService</code>. 1726 </p> 1727 </dd> 1728 <dt> 1729 , 1730 {@link android.content.AbstractThreadedSyncAdapter}. 1731 </dt> 1732 <dd> 1733 , 1734 . 1735 {@link android.content.AbstractThreadedSyncAdapter#onPerformSync( 1736 Account, Bundle, String, ContentProviderClient, SyncResult) 1737 onPerformSync()}. . 1738 <p> 1739 1740 <a href="{@docRoot}resources/samples/SampleSyncAdapter/index.html"> </a> 1741 <code>com.example.android.samplesync.syncadapter.SyncAdapter</code>. 1742 </p> 1743 </dd> 1744 <dt> 1745 {@link android.app.Application}. 1746 </dt> 1747 <dd> 1748 . 1749 {@link android.app.Application#onCreate()}, , 1750 get, 1751 {@link android.app.Service#onBind(Intent) onBind()} 1752 . 1753 </dd> 1754 <dt> 1755 <strong>:</strong> {@link android.app.Service}, 1756 . 1757 </dt> 1758 <dd> 1759 {@link android.accounts.AccountManager} , 1760 . {@link android.app.Service#onCreate()} 1761 . 1762 , 1763 {@link android.app.Service#onBind(Intent) onBind()} , 1764 {@link android.os.IBinder} . 1765 . 1766 <p> 1767 1768 <a href="{@docRoot}resources/samples/SampleSyncAdapter/index.html"> </a> 1769 <code>com.example.android.samplesync.authenticator.AuthenticationService</code>. 1770 </p> 1771 </dd> 1772 <dt> 1773 <strong>:</strong> 1774 {@link android.accounts.AbstractAccountAuthenticator}, 1775 . 1776 </dt> 1777 <dd> 1778 , {@link android.accounts.AccountManager} 1779 . 1780 , . , 1781 . 1782 <p> 1783 1784 <a href="{@docRoot}resources/samples/SampleSyncAdapter/index.html"> </a> 1785 <code>com.example.android.samplesync.authenticator.Authenticator</code>. 1786 </p> 1787 </dd> 1788 <dt> 1789 XML, . 1790 </dt> 1791 <dd> 1792 1793 1794 <code><<a href="{@docRoot}guide/topics/manifest/service-element.html">service</a>></code> 1795 . 1796 1797 <code><<a href="{@docRoot}guide/topics/manifest/meta-data-element.html">meta-data</a>></code> 1798 , 1799 . 1800 <ul> 1801 <li> 1802 1803 <code><<a href="{@docRoot}guide/topics/manifest/meta-data-element.html">meta-data</a>></code> 1804 1805 XML <code>res/xml/syncadapter.xml</code>. , 1806 URI - , 1807 -. 1808 </li> 1809 <li> 1810 <strong>:</strong> 1811 <code><<a href="{@docRoot}guide/topics/manifest/meta-data-element.html">meta-data</a>></code> 1812 XML 1813 <code>res/xml/authenticator.xml</code>. , 1814 , , , 1815 . , 1816 , , 1817 . 1818 </li> 1819 </ul> 1820 </dd> 1821 </dl> 1822 <h2 id="SocialStream"> </h2> 1823 <p> 1824 {@code android.provider.ContactsContract.StreamItems} 1825 1826 {@code android.provider.ContactsContract.StreamItemPhotos}. , 1827 , 1828 . . 1829 Android . 1830 </p> 1831 <h3 id="StreamText"> </h3> 1832 <p> 1833 . 1834 {@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID} 1835 <code>_ID</code> . 1836 . 1837 </p> 1838 <p> 1839 : 1840 </p> 1841 <dl> 1842 <dt> 1843 {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE} 1844 </dt> 1845 <dd> 1846 <strong>.</strong> , 1847 . . 1848 </dd> 1849 <dt> 1850 {@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME} 1851 </dt> 1852 <dd> 1853 <strong>.</strong> , 1854 . . 1855 </dd> 1856 <dt> 1857 1858 </dt> 1859 <dd> 1860 <strong>.</strong> 1861 . 1862 <ul> 1863 <li> 1864 {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}: 1865 {@code android.provider.BaseColumns#_ID} , 1866 . 1867 </li> 1868 <li> 1869 {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}: 1870 {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} , 1871 . 1872 </li> 1873 <li> 1874 {@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}: 1875 {@code android.provider.BaseColumns#_ID} , 1876 . 1877 </li> 1878 </ul> 1879 </dd> 1880 <dt> 1881 {@code android.provider.ContactsContract.StreamItemsColumns#COMMENTS} 1882 </dt> 1883 <dd> 1884 . , . 1885 </dd> 1886 <dt> 1887 {@code android.provider.ContactsContract.StreamItemsColumns#TEXT} 1888 </dt> 1889 <dd> 1890 : , , 1891 , . 1892 , 1893 {@link android.text.Html#fromHtml(String) fromHtml()}. 1894 , . 1895 </dd> 1896 <dt> 1897 {@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP} 1898 </dt> 1899 <dd> 1900 1901 <em></em> . , 1902 ; 1903 . 1904 </dd> 1905 </dl> 1906 <p> 1907 1908 {@code android.provider.ContactsContract.StreamItemsColumns#RES_ICON}, 1909 {@code android.provider.ContactsContract.StreamItemsColumns#RES_LABEL} 1910 {@code android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE} 1911 . 1912 </p> 1913 <p> 1914 {@code android.provider.ContactsContract.StreamItems} 1915 {@code android.provider.ContactsContract.StreamItemsColumns#SYNC1}{@code android.provider.ContactsContract.StreamItemsColumns#SYNC4}, 1916 1917 . 1918 </p> 1919 <h3 id="StreamPhotos"> </h3> 1920 <p> 1921 , , 1922 {@code android.provider.ContactsContract.StreamItemPhotos}. 1923 {@code android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID} 1924 {@code android.provider.BaseColumns#_ID} 1925 {@code android.provider.ContactsContract.StreamItems}. 1926 : 1927 </p> 1928 <dl> 1929 <dt> 1930 {@code android.provider.ContactsContract.StreamItemPhotos#PHOTO} ( BLOB). 1931 </dt> 1932 <dd> 1933 . 1934 1935 , . 1936 . 1937 {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} 1938 {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} ( 1939 , ) . 1940 , . 1941 </dd> 1942 <dt> 1943 {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} 1944 </dt> 1945 <dd> 1946 . 1947 {@link android.provider.ContactsContract.DisplayPhoto#CONTENT_URI DisplayPhoto.CONTENT_URI}, 1948 URI , 1949 {@link android.content.ContentResolver#openAssetFileDescriptor(Uri, String) 1950 openAssetFileDescriptor()}, . 1951 </dd> 1952 <dt> 1953 {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} 1954 </dt> 1955 <dd> 1956 URI , , , . 1957 {@link android.content.ContentResolver#openAssetFileDescriptor(Uri, String) 1958 openAssetFileDescriptor()}, URI, . 1959 </dd> 1960 </dl> 1961 <h3 id="SocialStreamTables"> </h3> 1962 <p> 1963 , . 1964 </p> 1965 <ul> 1966 <li> 1967 . 1968 {@code android.Manifest.permission#READ_SOCIAL_STREAM}. 1969 1970 {@code android.Manifest.permission#WRITE_SOCIAL_STREAM}. 1971 </li> 1972 <li> 1973 {@code android.provider.ContactsContract.StreamItems} , 1974 . 1975 1976 1977 {@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP}. , 1978 URI 1979 {@code android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI}. , 1980 URI , <code>null</code>. 1981 Cursor, 1982 {@code android.provider.ContactsContract.StreamItems#MAX_ITEMS}. 1983 </li> 1984 </ul> 1985 1986 <p> 1987 {@code android.provider.ContactsContract.StreamItems.StreamItemPhotos} 1988 {@code android.provider.ContactsContract.StreamItemPhotos}, 1989 . 1990 </p> 1991 <h3 id="SocialStreamInteraction"> </h3> 1992 <p> 1993 , . 1994 1995 . . 1996 </p> 1997 <ul> 1998 <li> 1999 2000 , 2001 ,{@code android.provider.ContactsContract.StreamItems} 2002 {@code android.provider.ContactsContract.StreamItemPhotos} . 2003 </li> 2004 <li> 2005 , 2006 . 2007 . 2008 </li> 2009 <li> 2010 2011 , <em></em> 2012 . 2013 , . 2014 </li> 2015 <li> 2016 , 2017 , . , 2018 , 2019 , XML, 2020 . 2021 </li> 2022 </ul> 2023 <p> 2024 , 2025 . 2026 <a href="#SyncAdapters"> </a>. 2027 . 2028 </p> 2029 <h4> </h4> 2030 <p> 2031 , 2032 , . 2033 </p> 2034 <ol> 2035 <li> 2036 <code>res/xml/</code> 2037 <code>contacts.xml</code>. , . 2038 </li> 2039 <li> 2040 2041 <code><ContactsAccountType xmlns:android="http://schemas.android.com/apk/res/android"></code>. 2042 , . 2043 </li> 2044 <li> 2045 , 2046 , , 2047 <code>viewContactNotifyService="<em>serviceclass</em>"</code> , 2048 <code><em>serviceclass</em></code> , 2049 . - 2050 , {@link android.app.IntentService}, 2051 . URI 2052 , . - , 2053 . 2054 </li> 2055 </ol> 2056 <p> 2057 , ( ), . 2058 </p> 2059 <ol> 2060 <li> 2061 <code>res/xml/</code> 2062 <code>contacts.xml</code>. , . 2063 </li> 2064 <li> 2065 2066 <code><ContactsAccountType xmlns:android="http://schemas.android.com/apk/res/android"></code>. 2067 , . 2068 </li> 2069 <li> 2070 2071 , , 2072 <code>viewStreamItemActivity="<em>activityclass</em>"</code> , 2073 <code><em>activityclass</em></code> , 2074 . 2075 </li> 2076 <li> 2077 2078 , , 2079 <code>viewStreamItemPhotoActivity="<em>activityclass</em>"</code> , 2080 <code><em>activityclass</em></code> , 2081 . 2082 </li> 2083 </ol> 2084 <p> 2085 <code><ContactsAccountType></code> 2086 <a href="#SocialStreamAcctType"> <ContactsAccountType></a>. 2087 </p> 2088 <p> 2089 URI , . 2090 , . 2091 </p> 2092 <h4> </h4> 2093 <p> 2094 , , 2095 . 2096 . . 2097 </p> 2098 <ol> 2099 <li> 2100 <code>res/xml/</code> 2101 <code>contacts.xml</code>. , . 2102 </li> 2103 <li> 2104 2105 <code><ContactsAccountType xmlns:android="http://schemas.android.com/apk/res/android"></code>. 2106 , . 2107 </li> 2108 <li> 2109 : 2110 <ul> 2111 <li><code>inviteContactActivity="<em>activityclass</em>"</code>;</li> 2112 <li> 2113 <code>inviteContactActionLabel="@string/<em>invite_action_label</em>"</code>. 2114 </li> 2115 </ul> 2116 <code><em>activityclass</em></code> , 2117 . <code><em>invite_action_label</em></code> 2118 , <strong> </strong> 2119 . 2120 </li> 2121 </ol> 2122 <p class="note"> 2123 <strong>.</strong> <code>ContactsSource</code> 2124 <code>ContactsAccountType</code>, . 2125 </p> 2126 <h3 id="ContactsFile"> contacts.xml</h3> 2127 <p> 2128 <code>contacts.xml</code> XML, 2129 . 2130 . 2131 </p> 2132 <h4 id="SocialStreamAcctType"> <ContactsAccountType></h4> 2133 <p> 2134 <code><ContactsAccountType></code> 2135 . . 2136 </p> 2137 <pre> 2138 <ContactsAccountType 2139 xmlns:android="http://schemas.android.com/apk/res/android" 2140 inviteContactActivity="<em>activity_name</em>" 2141 inviteContactActionLabel="<em>invite_command_text</em>" 2142 viewContactNotifyService="<em>view_notify_service</em>" 2143 viewGroupActivity="<em>group_view_activity</em>" 2144 viewGroupActionLabel="<em>group_action_text</em>" 2145 viewStreamItemActivity="<em>viewstream_activity_name</em>" 2146 viewStreamItemPhotoActivity="<em>viewphotostream_activity_name</em>"> 2147 </pre> 2148 <p> 2149 <strong> :</strong> 2150 </p> 2151 <p> 2152 <code>res/xml/contacts.xml</code> 2153 </p> 2154 <p> 2155 <strong> :</strong> 2156 </p> 2157 <p> 2158 <strong><code><ContactsDataKind></code></strong> 2159 </p> 2160 <p> 2161 <strong></strong> 2162 </p> 2163 <p> 2164 , 2165 , 2166 . 2167 </p> 2168 <p> 2169 , <code>android:</code> 2170 <code><ContactsAccountType></code>. 2171 </p> 2172 <p> 2173 <strong></strong> 2174 </p> 2175 <dl> 2176 <dt>{@code inviteContactActivity}</dt> 2177 <dd> 2178 , 2179 <strong> </strong> 2180 , . 2181 </dd> 2182 <dt>{@code inviteContactActionLabel}</dt> 2183 <dd> 2184 , , 2185 {@code inviteContactActivity}, <strong> </strong>. 2186 , . 2187 . 2188 </dd> 2189 <dt>{@code viewContactNotifyService}</dt> 2190 <dd> 2191 , 2192 . , 2193 ; , , 2194 , . , 2195 2196 . 2197 <a href="#SocialStreamInteraction"> </a>. 2198 2199 <code>NotifierService.java</code> 2200 <a href="{@docRoot}resources/samples/SampleSyncAdapter/index.html">SampleSyncAdapter</a>. 2201 </dd> 2202 <dt>{@code viewGroupActivity}</dt> 2203 <dd> 2204 , 2205 . , 2206 , . 2207 </dd> 2208 <dt>{@code viewGroupActionLabel}</dt> 2209 <dd> 2210 , , 2211 . 2212 <p> 2213 , Google+ 2214 Google+ , Google+ 2215 <strong></strong>. 2216 Google+ . 2217 Google+; , 2218 Google+. 2219 {@code viewGroupActivity}, Google+ 2220 {@code viewGroupActionLabel}. 2221 </p> 2222 <p> 2223 . 2224 </p> 2225 </dd> 2226 <dt>{@code viewStreamItemActivity}</dt> 2227 <dd> 2228 , 2229 , . 2230 </dd> 2231 <dt>{@code viewStreamItemPhotoActivity}</dt> 2232 <dd> 2233 , 2234 , 2235 . 2236 </dd> 2237 </dl> 2238 <h4 id="SocialStreamDataKind"> <ContactsDataKind></h4> 2239 <p> 2240 <code><ContactsDataKind></code> 2241 , . . 2242 </p> 2243 <pre> 2244 <ContactsDataKind 2245 android:mimeType="<em>MIMEtype</em>" 2246 android:icon="<em>icon_resources</em>" 2247 android:summaryColumn="<em>column_name</em>" 2248 android:detailColumn="<em>column_name</em>"> 2249 </pre> 2250 <p> 2251 <strong> :</strong> 2252 </p> 2253 <code><ContactsAccountType></code> 2254 <p> 2255 <strong></strong> 2256 </p> 2257 <p> 2258 2259 . <code><ContactsDataKind></code> 2260 <code><ContactsAccountType></code> , 2261 {@link android.provider.ContactsContract.Data}. MIME 2262 <code><ContactsDataKind></code>. 2263 , , . 2264 </p> 2265 <p> 2266 <strong></strong> 2267 </p> 2268 <dl> 2269 <dt>{@code android:mimeType}</dt> 2270 <dd> 2271 MIME 2272 {@link android.provider.ContactsContract.Data}. , 2273 <code>vnd.android.cursor.item/vnd.example.locationstatus</code> 2274 MIME , . 2275 </dd> 2276 <dt>{@code android:icon}</dt> 2277 <dd> 2278 <a href="{@docRoot}guide/topics/resources/drawable-resource.html"> </a> 2279 Android, 2280 . , 2281 . 2282 </dd> 2283 <dt>{@code android:summaryColumn}</dt> 2284 <dd> 2285 , . 2286 . 2287 , . . 2288 <a href="#detailColumn">android:detailColumn</a>. 2289 </dd> 2290 <dt>{@code android:detailColumn}</dt> 2291 <dd> 2292 , . 2293 . . 2294 {@code android:summaryColumn}. 2295 </dd> 2296 </dl> 2297 <h2 id="AdditionalFeatures"> </h2> 2298 <p> 2299 , , 2300 . 2301 </p> 2302 <ul> 2303 <li> </li> 2304 <li> </li> 2305 </ul> 2306 <h3 id="Groups"> </h3> 2307 <p> 2308 2309 <strong></strong>. , , 2310 , 2311 . 2312 2313 {@link android.provider.ContactsContract.Groups}. , , 2314 {@link android.provider.ContactsContract.Data} MIME 2315 {@link android.provider.ContactsContract.CommonDataKinds.GroupMembership}. 2316 </p> 2317 <p> 2318 , 2319 , , , 2320 . , 2321 , {@link android.provider.ContactsContract.Settings}, 2322 . 2323 {@link android.provider.ContactsContract.SettingsColumns#UNGROUPED_VISIBLE 2324 Settings.UNGROUPED_VISIBLE} 1. 2325 , . 2326 </p> 2327 <h3 id="Photos"> </h3> 2328 <p> 2329 {@link android.provider.ContactsContract.Data} 2330 {@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE 2331 Photo.CONTENT_ITEM_TYPE} MIME. 2332 {@link android.provider.ContactsContract.RawContactsColumns#CONTACT_ID} 2333 {@code android.provider.BaseColumns#_ID} , . 2334 {@link android.provider.ContactsContract.Contacts.Photo} 2335 {@link android.provider.ContactsContract.Contacts}, 2336 ( ). 2337 {@link android.provider.ContactsContract.RawContacts.DisplayPhoto} 2338 {@link android.provider.ContactsContract.RawContacts}, 2339 . 2340 </p> 2341 <p> 2342 {@link android.provider.ContactsContract.Contacts.Photo} 2343 {@link android.provider.ContactsContract.RawContacts.DisplayPhoto} 2344 . , 2345 , 2346 {@link android.provider.ContactsContract.Data}, 2347 {@code android.provider.BaseColumns#_ID} , 2348 {@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE 2349 Photo.CONTENT_ITEM_TYPE} {@link android.provider.ContactsContract.Data#IS_PRIMARY}, 2350 . 2351 </p> 2352 <p> 2353 . 2354 {@code android.provider.ContactsContract.StreamItemPhotos}, 2355 <a href="#StreamPhotos"> </a>. 2356 </p> 2357
