Направление пользователя в другое приложение

Одна из наиболее важных возможностей системы Android – способность приложений направлять пользователя в другое приложение в зависимости от желаемого действия. Например, если ваше приложение содержит адрес компании, который нужно показать на карте, вам не нужно встраивать в приложение операцию вывода карты. Вместо этого можно создать запрос на просмотр адреса с помощью Intent. В этом случае система Android запускает приложение, которое показывает адрес на карте.

Как объяснялось в первом уроке Создание первого приложения, объекты Intent нужно использовать для навигации между операциями в собственном приложении. Обычно для этого используются явные объекты Intent, определяющие точное имя класса компонента, который вы хотите запустить. Однако если вы хотите, чтобы действие (например просмотр карты) выполнялось отдельным приложением, следует использовать неявный объект Intent.

На этом уроке вы узнаете, как создать неявный объект Intent для определенного действия и использовать его для запуска операции, выполняющей действие в другом приложении.

Создание неявного объекта Intent

Неявные объекты Intent не декларируют имя класса запускаемого компонента, а декларируют выполняемое действие. Действие указывает задачу, которую вы хотите выполнить, например просмотр, правка, отправка или получение чего-либо. Объекты Intent часто также содержат данные, ассоциируемые с действием, например адрес для просмотра или электронное сообщение для отправки. В зависимости от того, какой объект Intent вы хотите создать, данные могут относиться к типу Uri, одному из нескольких других типов данных, либо объекту могут вообще не требоваться данные.

Если ваши данные относятся к типу Uri, вы можете использовать простой конструктор Intent() для определения действия и данных.

Приведем пример создания объекта Intent для запуска телефонного звонка, в котором данные Uri используются для указания телефонного номера:

Uri number = Uri.parse("tel:5551234");
Intent callIntent = new Intent(Intent.ACTION_DIAL, number);

Когда ваше приложение активирует этот объект Intent посредством вызова startActivity(), приложение "Телефон" инициирует звонок на указанный номер телефона.

Вот еще несколько объектов Intent в сочетании с действиями и Uri парами данных:

  • Просмотр карты:
    // Map point based on address
    Uri location = Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California");
    // Or map point based on latitude/longitude
    // Uri location = Uri.parse("geo:37.422219,-122.08364?z=14"); // z param is zoom level
    Intent mapIntent = new Intent(Intent.ACTION_VIEW, location);
    
  • Просмотр веб-страницы:
    Uri webpage = Uri.parse("http://www.android.com");
    Intent webIntent = new Intent(Intent.ACTION_VIEW, webpage);
    

Другие виды неявных объектов Intent требуют дополнительные данные, предоставляющие разные типы данных, например строки. Вы можете добавить один или несколько элементов дополнительных данных с помощью разных методов putExtra().

Система по умолчанию определяет соответствующий тип MIME, который требует объект Intent на базе включенных данных Uri. Если не включать Uri в объект Intent, обычно нужно использовать setType() для указания типа данных, связанного с объектом Intent. Установка типа MIME также определяет, какие виды действий должен получать объект Intent.

Вот некоторые объекты Intent, добавляющие дополнительные данные для указания желаемого действия:

  • Отправка электронного письма с вложением:
    Intent emailIntent = new Intent(Intent.ACTION_SEND);
    // The intent does not have a URI, so declare the "text/plain" MIME type
    emailIntent.setType(HTTP.PLAIN_TEXT_TYPE);
    emailIntent.putExtra(Intent.EXTRA_EMAIL, new String[] {"jon@example.com"}); // recipients
    emailIntent.putExtra(Intent.EXTRA_SUBJECT, "Email subject");
    emailIntent.putExtra(Intent.EXTRA_TEXT, "Email message text");
    emailIntent.putExtra(Intent.EXTRA_STREAM, Uri.parse("content://path/to/email/attachment"));
    // You can also attach multiple items by passing an ArrayList of Uris
    
  • Создание события в календаре:
    Intent calendarIntent = new Intent(Intent.ACTION_INSERT, Events.CONTENT_URI);
    Calendar beginTime = Calendar.getInstance().set(2012, 0, 19, 7, 30);
    Calendar endTime = Calendar.getInstance().set(2012, 0, 19, 10, 30);
    calendarIntent.putExtra(CalendarContract.EXTRA_EVENT_BEGIN_TIME, beginTime.getTimeInMillis());
    calendarIntent.putExtra(CalendarContract.EXTRA_EVENT_END_TIME, endTime.getTimeInMillis());
    calendarIntent.putExtra(Events.TITLE, "Ninja class");
    calendarIntent.putExtra(Events.EVENT_LOCATION, "Secret dojo");
    

    Примечание. Этот объект Intent для создания события в календаре поддерживается только API-интерфейсами уровня 14 и выше.

Примечание. Очень важно определять объекты Intent как можно более конкретно. Например, если вы хотите вывести изображение с помощью объекта Intent ACTION_VIEW, вам следует указать тип MIME image/*. Это не даст объекту Intent запускать приложения для просмотра других типов данных (например картографические приложения).

Проверка наличия приложения для получения объекта Intent

Хотя платформа Android гарантирует выполнение объектов Intent во встроенных приложениях (таких как "Телефон", "Электронная почта" или "Календарь"), перед активацией объекта Intent всегда следует добавлять шаг проверки.

Внимание! Если вы активируете объект Intent, а на устройстве не будет приложения, способного его обработать, ваше приложение закроется с ошибкой.

Чтобы убедиться в наличии операции, реагирующей на объект Intent, вызовите метод queryIntentActivities() для получения списка операций, способных обработать ваш Intent. Если полученный в результате список List не пустой, вы можете безопасно использовать данный объект Intent. Например:

PackageManager packageManager = getPackageManager();
List activities = packageManager.queryIntentActivities(intent,
        PackageManager.MATCH_DEFAULT_ONLY);
boolean isIntentSafe = activities.size() > 0;

ЕслиisIntentSafe имеет значение true, то хотя бы одно приложение отреагирует на объект Intent. Если же он имеет значение false, то на устройстве нет приложений для обработки данного объекта Intent.

Примечание. Такую проверку следует выполнять при первом запуске операции на случай, если понадобится отключить функцию, обрабатывающую объект Intent, до того, как пользователь попытается использовать ее. Если вам известно определенное приложение, которое может обработать данный объект Intent, вы можете указать ссылку, по которой пользователь может загрузить приложение (посмотрите, как добавить ссылку на свой продукт в Google Play).

Запуск операции с объектом Intent

Рисунок 1. Пример диалогового окна выбора, которое отображается, если объект Intent могут обработать разные приложения.

После создания Intent и установки дополнительной информации вызовите startActivity() для отправки в систему. Если система идентифицирует несколько операций, способных обработать объект Intent, она выводит для пользователя диалоговое окно выбора приложения, как показано на рисунке 1. Если объект Intent может быть обработан только одной операцией, система сразу же запускает ее.

startActivity(intent);

Вот полный пример, показывающий, как создать объект Intent для просмотра карты, убедиться в наличии приложения для его обработки и запустить это приложение:

// Build the intent
Uri location = Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, location);

// Verify it resolves
PackageManager packageManager = getPackageManager();
List<ResolveInfo> activities = packageManager.queryIntentActivities(mapIntent, 0);
boolean isIntentSafe = activities.size() > 0;

// Start an activity if it's safe
if (isIntentSafe) {
    startActivity(mapIntent);
}

Отображение блока выбора приложения

Рисунок 2. Диалог выбора.

Обратите внимание, что при запуске операции посредством передачи Intent в startActivity() и наличии нескольких приложений, реагирующих на объект Intent, пользователь может выбрать, какое из этих приложений использовать по умолчанию (для этого нужно установить флажок в нижней части диалогового окна; см. рисунок 1). Это удобно при выполнении действия, для которого пользователь обычно хочет всегда использовать одно и то же приложение, например при открытии веб-страницы (пользователи обычно используют один и тот же браузер) или создании снимка (пользователи обычно предпочитают одно и то же приложение камеры).

Однако бывает так, что выполняемое действие может быть обработано несколькими приложениями, и пользователь каждый раз может использовать разные приложения — например, действие "Поделиться", для которого пользователи могут использовать разные приложения, — и в этом случае ваше приложение должно отображать диалоговое окно выбора приложения, как показано на рисунке 2. В диалоговом окне выбора приложения пользователь должен при каждом запуске выбирать, какое приложение использовать для действия (пользователь не может выбрать приложение по умолчанию).

Чтобы отобразить блок выбора приложения, создайте Intent с помощью createChooser() и передайте его startActivity(). Например:

Intent intent = new Intent(Intent.ACTION_SEND);
...

// Always use string resources for UI text.
// This says something like "Share this photo with"
String title = getResources().getString(R.string.chooser_title);
// Create intent to show chooser
Intent chooser = Intent.createChooser(intent, title);

// Verify the intent will resolve to at least one activity
if (intent.resolveActivity(getPackageManager()) != null) {
    startActivity(chooser);
}

В результате отобразится диалоговое окно со списком приложений, которые могут отреагировать на объект Intent, переданный методу createChooser() и используют указанный текст в качестве заголовка диалога.