- Основы Contacts API в Android
- Структура поставщика контактов
- Разрешения на доступ к поставщику контактов
- Профиль пользователя
- Пример чтения контактов
- Листинг callback метода запроса разрешений
- Листинг метода чтения контактов
- Листинг класса Contact
- Основы Contacts API в Android
- Введение
- Структура данных
- Работаем с контактами
- Coolmuster Android SMS + Contacts Recovery
- Exclusive SMS & Contacts Recovery Software for Android Smartphones!
- Hassle-free to Recover Lost Android SMS & Contacts
- Backup Both Deleted & Existing Android Data to PC
- Preview and Selectively Choose Data to Recover
- Read-only and Compatible with Multiple Android Handsets
- Comparison: Choose the Right Recovery Tool for Android
- More Features
Основы Contacts API в Android
Интерфейс работы с контактами изменился начиная с 5-ой версии API Android SDK : провайдер Contacts и все его составляющие получили статус @Deprecated. Теперь за работу с контактами отвечает провайдер ContactsContract, который внёс изменения в структуру хранения контактов, более адаптированную для Android устройств, позволяющую хранить контакты из разных источников и предоставлять их пользователю как единую сущность. В настоящее время объект описания контакта на мобильном устройстве включает не только имя и номер телефона, но и Email, Twitter, Facebook и т.д. Новый ContactsContract API позволяет системе агрегировать похожие контакты и выдавать их пользователю в одной записи, а также связывать контакт с разного рода данными.
Пользовательские данные хранятся в центральном репозитории устройства, которым управляет поставщик контактов — эффективный и гибкий компонент Android. Поставщик контактов — это источник данных, которые отображаются в приложении «Контакты» на Вашем устройстве.
Структура поставщика контактов
Поставщик контактов содержит в себе три типа данных о пользователе, как это представлено на рисунке. Каждый тип данных хранится в отдельной таблице :
В качестве наименований таблиц обычно используются названия соответствующих классов-контрактов ContactsContract. Эти классы определяют константы для URI контента, названий столбцов и значений в столбцах этих таблиц :
ContactsContract.Contacts
Строки в таблице Contacts содержат данные о пользователях, полученные путем агрегации строк необработанных контактов.
ContactsContract.RawContacts
Строки в таблице RawContacts содержат сводные данные о пользователях, относящиеся к пользовательским учетным записям и их типам.
ContactsContract.Data
Строки в таблице Data содержат сведения о необработанных контактах, например email или номера телефонов.
Имеются и другие таблицы, представленные классами-контрактами ContactsContract и представляющие собой вспомогательные таблицы. Эти таблицы поставщик контактов использует для управления своими операциями и поддержки определенных функций, имеющихся в приложении устройства «Контакты» или приложениях для телефонной связи.
Разрешения на доступ к поставщику контактов
Приложения, которым требуется доступ к поставщику контактов для чтения или записи, должны определить разрешения в файле манифеста приложения :
Профиль пользователя
Разрешения на доступ к данным поставщика контактов не распространяются на работу с профилями пользователя.
Примечание : данные о контактах пользователя являются личными и конфиденциальными. Владельцы мобильных устройств заботятся о своей конфиденциальности и часто не проявляют желания предоставлять приложениям возможности сбора данных о них самих и/или их контактах. Если владельцам не до конца ясно, для чего требуется предоставить приложению разрешение на доступ к данным контактов, они могут присвоить Вашему приложению низкий рейтинг, или вообще откажутся его устанавливать.
Строка контактов профиля связана со строкой необработанных контактов в каждой из систем, в которой используется профиль. В каждой строке необработанного контакта профиля может содержаться несколько строк данных. Константы для доступа к профилю пользователя представлены в классе ContactsContract.Profile.
Для доступа к профилю пользователя требуются отдельные разрешения. Наряду с разрешениями READ_CONTACTS и WRITE_CONTACTS (чтение и запись контакта) для доступа к профилю пользователя необходимы разрешения android.Manifest.permission#READ_PROFILE и android.Manifest.permission#WRITE_PROFILE на чтение и запись соответственно.
Помните, что профиль пользователя представляет собой конфиденциальную информацию. При запросе доступа к личной информации на устройстве пользователя обязательно укажите, для чего вам требуется доступ к профилю пользователя.
Примечание : если при получении нескольких строк контактов необходимо определить, какая из них является профилем пользователя, анализируйте значение столбца IS_USER_PROFILE этой строки. Для профиля пользователя значение должно быть «1».
Пример чтения контактов
Рассмотрим простой пример чтения списка контактов и вывода их в журнал Log. Ниже представлен листинг метода onCreate главного модуля приложения MainActivity.
Перед выполнением запроса проверим, имеются ли у нас необходимые разрешения на доступ к контактам. Для этого используем метод ContextCompat.checkSelfPermission, которому в качестве параметров передадим контекст модуля и идентификатор разрешений списка контактов. Если приложение имеет разрешения (permission), то метод вернет значение PERMISSION_GRANTED, в противном случае PERMISSION_DENIED.
При наличии необходимых разрешений вызываем метод чтения контактов readContacts, представленный ниже. В противном случае запросим необходимые разрешения методом ActivityCompat.requestPermissions, которому в качестве параметров необходимо передать контекст модуля, список запрашиваемых разрешений и «определенную в модуле константу» (PERMISSIONS_REQUEST_READ_CONTACTS).
Примечание : при запросе приложением «разрешения» методом requestPermissions(), система открывает стандартное диалоговое окно подтверждения доступа. Приложение не может изменить интерфейс диалогового окна. Если имеется необходимость представить пользователю дополнительную информацию, то это желательно сделать перед открытием окна запроса подтверждения. После запроса первого подтверждения и получения положительного ответа система запоминает результат ответа и больше не открывает окно подтверждения доступа.
Результат выполнения запроса на получение разрешений система возвращает вызовом callback метода onRequestPermissionsResult, листинг которого представлен ниже.
Листинг callback метода запроса разрешений
Система вызывает callback метод onRequestPermissionsResult при запросе разрешений методом requestPermissions. В качестве параметров методу передается массив запрошенных permissions и массив разрешений grantResults.
В примере проверяем результат полученного от системы ответа. При наличии необходимых разрешений вызывается метод readContacts.
Листинг метода чтения контактов
Метод чтения контактов readContacts в качестве параметра получает контекст приложения, используемый для вызова метода getContentResolver().query и получения результата в виде курсора. Если курсор содержит список контактов, то метод в цикле перебирает этот список и выводит в Log параметры контактов (id, name, phone). Метод можно доработать, чтобы он возвращал список контактов в виде List .
Листинг класса Contact
Класс описания контакта, используемого в методе чтения контактов устройства.
Источник
Основы Contacts API в Android
Введение
Начиная с версии 5 API Android SDK интерфейс работы с контактами изменился, а основной контент провайдер Contacts и все его составляющие получили черную метку @Deprecated. Теперь за работу с контактами отвечает провайдер ContactsContract. Эти изменения связаны с изменением структуры хранения контактов, более адаптированной для Android устройств, которым требуется хранить контакты из множества разных источников и предоставлять их пользователю как единую сущность. Ведь сегодня, определенный контакт на нашем мобильном устройстве это не только имя и номер телефона, мы можем захотеть сохранить eMail, Im, Twitter, Facebook аккаунт определенного человека, и при этом, мы не хотим чтобы у нас нас появилось миллион непонятных записей. Поэтому новый Contacts API позволяет Android агрегировать похожие контакты и представлять их пользователю в одной записи, а также связывать контакт с разного рода данными.
Структура данных
На устройстве основная информация о контактах хранится в трех таблицах, на деле их там конечно больше, но мы рассмотрим основные три: contacts, raw_contacts и data. Чтобы было более наглядно я набросал простую схему в Dia.
В таблице contacts хранятся агрегированные контакты, каждая запись в этой таблице представляет собой пользовательский контакт (единую сущность) – объединение одного или нескольких сырых (необработанных) контактов из таблицы raw_contacts. Как видно на схеме, связь между этими таблицами один ко многим (1-N). Одна запись в таблице raw_contacts представляет собой так называемый сырой контакт. Сырой контакт, на языке Android, означает какой-то конкретный набор данных для определенного контакта. Но сами основные данные в этой таблице не хранятся, они хранятся в таблице data, и связь между raw_contacts и data также один ко многим. В таблице data хранятся непосредственно данные. Причем каждая строка этой таблицы это набор данных определенного типа для контакта. Какого именно типа данные хранятся в строке определяется столбцом mimetype_id, в котором содержится id типов данных определенных в таблице mimetype(например vnd.android.cursor.item/name, vnd.android.cursor.item/photo). Теперь разберемся во всем по подробней и с примерами.
Работаем с контактами
Хорошо, допустим мы хотим добавить контакт (Robert Smith, моб.тел. 11-22-33), как нам это сделать? В таблицу contacts мы сами, явно, не можем добавить контакт, так как система сама формирует эту таблицу агрегируя похожие raw_contacts. Идентичность контактов система определяет в основном по имени (одинаковые имена, фамилии и т.п.), но и по другим критериям, каким именно и как ими управлять можно посмотреть в документации. То есть, если мы добавим raw_contact нашего Роберта (Robert Smith) и свяжем его с данными типа vnd.cursor.android.item/phone, а потом у нас появится “похожий”, для системы, Robert Smith связанный с данными типа vnd.cursor.android.item/email и еще один с данными типа vnd.cursor.android.item/photo, то у нас в контактах будет один Robert Smith с фотографией, мобильным и email’ом.
Теперь попробуем переложить это на код. За таблицы и их поля отвечает, как я уже говорил, класс ContactsContract и его внутренние классы и интерфейсы. Например интерфейсом к таблице raw_contacts является класс ContactsContract.RawContacts, а за таблицу data класс ContactsContract.Data. Будьте внимательны когда изучаете их константы – интерфейсы к столбцам – обращайте внимание на метки read/write и read only.
Из написанного выше следует, что для начала, мы должны добавить сырой контакт, а потом связывать его с данными. Добавить пустой контакт можно так:
В контактах у вас должен появиться пустой (Unknown) контакт, ни с чем не связанный. Добавим ему имя. Чтобы это сделать, мы должны связать наш новый контакт с новыми данными используя его id, который можно достать из прошлого запроса. Основные интерфейсы к полям таблицы данных содержаться в классе-контейнере ContactsContract.CommonDataKinds и его внутренних классах и интерфейсах. Например, сейчас нам понадобиться
класс ContactsContract.CommonDataKinds.StrucruredName содержащий нужные нам константы для добавления имени, а также константу MIME типа, которой мы пометим наше поле в таблице данных.
Если мы добавим контакт таким образом, то в списке контактов у нас появиться Robert Smith. Теперь идем дальше, добавим нашему контакту еще и телефон. Для этого нам понадобиться класс ContactsContract.CommonDataKinds.Phone, который является интерфейсом к данным телефонного номера.
Теперь в контактах у нас есть Robert Smith которому можно позвонить. Но вот так добавлять контакт и данные к нему, в несколько запросов, дорого и накладно. Поэтому существует класс ContentProviderOperation, который позволяет построить запрос, который выполнит все наши операции за одну транзакцию. Именно им и рекомендуют пользоваться. Вот так можно добавить нашего Роберта используя ContentProviderOperation.
Вот таким образом в Android можно добавлять контакты. Будьте осторожны используя ContentProviderOperation, так как слишком большой запрос может долго выполняться. Вообще все операции лучше производить в отдельном потоке, потому, что у пользователя, например, может быть слабый телефон и много контактов.
В остальном все другие операции выполняются обычным образом, используя те провайдеры, которые вам необходимы, с некоторыми оговорками. Например, удаление контакта из таблицы contacts удалит все raw_contacts с ним связанные и т.д.
Вот так можно попробовать найти нашего Роберта в контактах:
На этом хотелось бы завершить статью, все же это были только основные сведения о Contacts API в Andoid. Я надеюсь мне удалось описать здесь основные принципы, а вся конкретика зависит от того, что вам необходимо сделать в процессе работы. Можно просто руководствоваться этими принципами и находить в официальной документации интерфейсы которые вам нужны для работы. Успехов!
Источник
Coolmuster Android SMS + Contacts Recovery
Exclusive SMS & Contacts Recovery Software for Android Smartphones!
Ferret about a way to retrieve your lost or deleted text messages or contacts from your Android phone? Just look no further than Coolmuster Android SMS + Contacts Recovery, which is fully capable of it with ease.
* Recover lost or deleted messages and contacts from Android internal memory and SIM card.
* Preview details of SMS and contacts before recovery, including address, company, email, etc.
* Back up both existing and deleted text messages and contacts info on your computer.
* Save text messages and contacts in HTML or XML format for easy reading and printing.
* Support almost all Android phones, like Samsung, Huawei, Sony, HTC, Motorola, ZTE, LG, etc.
Tips: For iPhone users, you can take Coolmuster iPhone SMS + Contacts Recovery into consideration.
- Recover deleted or lost SMS messages and contacts from Android mobile phones directly without quality loss.
- Preview recoverable messages and contacts before recovery.
- Support almost all Android phones: Samsung, Huawei, HTC, Motorola, LG, Sony, Motorola, ZTE, etc.
Supported OS:
Mac OS X 10.7 or later
My little son accidentally deleted the phone number of my friend that I stored in my Galaxy note 2 internal phone memory and I tried this software, it helped me. thanks. — Reviewed by Annie
Even though the program are not powerful as the similar tool on the market, but it is enough for me! The program have helped me find back my lost contacts, but the scanning process is a little bit long. If you can fix this bug, the program can works well maybe. Thanks guys! — Reviewed by Lina
Hassle-free to Recover Lost Android SMS & Contacts
Contacts and text messages are the two basic compositions of an Android phone, which helps users easily communicate and pass on information with each other. But due to various unpredictable reasons, you may get your important text messages or contact person data lost or deleted. Luckily, Coolmuster Android SMS + Contacts Recovery empowers you to retrieve all lost text messages and contacts from Android.
Recover deleted contacts and text messages from Android internal memory card and SIM card, getting back all your needed data from Android.
Support to recover Android SMS and contacts lost owing to accidental deletion, virus attack, hardware or software failure, etc.
Recover not only lost phone numbers and text messages, but also the attached info like contact name, address, job title, company, email, SMS attachments, etc. (Tips: It is required to root your Android device before the software gets the permission to access and recover deleted contacts and SMS from Android.)
Backup Both Deleted & Existing Android Data to PC
It is always more important to take precautions than rack your brains to find a way to solve the problem that has already gone wrong. With this Android SMS Recovery and Android Contacts Recovery, you can also backup them to your computer for further record.
The deleted Android text messages and contacts will be exported and saved on your Windows PC for backup or future use.
The existing Android messages and contacts can also be backed up and saved as HTML or XML format for easy reading and printing.
Preview and Selectively Choose Data to Recover
To let you enjoy a more accurate and quicker data recovery process, this software provides you with considerate preview feature that allows you to preview all the scanned out text messages and contacts information before recovery.
With the deep scan, quick scan feature of the software, all SMS messages and contacts can be scanned out and previewed with details, including contact person data.
With the permission of previewing the scanned out messages and phone numbers, you can freely choose and confirm which one is indeed the one you really need to recover or backup.
Read-only and Compatible with Multiple Android Handsets
Coolmuster Android SMS + Contacts Recovery works well with almost all Android-based mobile phones. It only reads data on your device and will not damage, delete or modify your original data at all.
Support almost all Android smartphones available in the market, such as Samsung, Huawei, HTC, LG, Sony, Motorola, ZTE, etc. and compatible with various Android OS versions from Android 2.0 to 9.0 (or up). (See specific supported phone models >>)
There is no need to worry about your private information revealing thanks to the 100% read-only and risk-free features of this SMS & Contact recovery software.
Comparison: Choose the Right Recovery Tool for Android
Android SMS + Contacts Recovery
for Windows $35.95
Lab.Fone for Android
for Windows $45.95
Recover deleted and back up existing SMS and contacts on Android
Restore deleted and back up existing call logs on Android
Back up existing media files from Android internal memory to PC
Recover deleted and back up existing media files from Android SD card
Preview Android files in details before recovery or backup
Recover or back up files one at a time or in batches
Read-only and easy-to-use
Support almost all Android-based phones and tablets
More Features
No spyware, No adware, No viruses. Read-only, and never disclose, overwrite, damage, modify your phone data without permission.
Intuitive and user-friendly interface design makes the whole transferring process just like a piece of cake.
Work well on all Windows system, including Windows 11/10/8/7/XP/Vista/ 2003/2000/NT.
Источник