de.mrapp.android.util

Class AppUtil

java.lang.Object

de.mrapp.android.util.AppUtil

public final class AppUtil
extends java.lang.Object

An utility class, which provides static methods, which allow to start system apps.

Since:

1.3.0

Method Summary

Modifier and Type	Method and Description
static void	startCall(android.app.Activity activity, int phoneNumber) Starts the dialer in order to call a specific phone number.
static void	startCall(android.app.Activity activity, long phoneNumber) Starts the dialer in order to call a specific phone number.
static void	startCall(android.app.Activity activity, java.lang.String phoneNumber) Starts the dialer in order to call a specific phone number.
static void	startCameraApp(android.app.Activity activity, int requestCode, java.io.File file) Starts the camera app in order to capture a picture.
static void	startCameraApp(android.app.Activity activity, int requestCode, android.net.Uri uri) Starts the camera app in order to capture a picture.
static void	startDialer(android.app.Activity activity, int phoneNumber) Starts the dialer in order to call a specific phone number.
static void	startDialer(android.app.Activity activity, long phoneNumber) Starts the dialer in order to call a specific phone number.
static void	startDialer(android.app.Activity activity, java.lang.String phoneNumber) Starts the dialer in order to call a specific phone number.
static void	startGalleryApp(android.app.Activity activity, java.io.File file) Starts the gallery app in order to show a specific image.
static void	startGalleryApp(android.app.Activity activity, int requestCode) Starts the gallery app in order to choose a picture.
static void	startGalleryApp(android.app.Activity activity, android.net.Uri uri) Starts the gallery app in order to show a specific image.
static void	startMailClient(android.app.Activity activity, java.lang.String emailAddress) Starts the mail client in order to send an e-mail to a specific e-mail address.
static void	startMailClient(android.app.Activity activity, java.lang.String[] emailAddresses) Starts the mail client in order to send an e-mail to specific e-mail addresses.
static void	startMailClient(android.app.Activity activity, java.lang.String[] emailAddresses, java.lang.String subject, java.lang.String text) Starts the mail client in order to send an e-mail to specific e-mail addresses.
static void	startMailClient(android.app.Activity activity, java.lang.String emailAddress, java.lang.String subject, java.lang.String text) Starts the mail client in order to send an e-mail to a specific e-mail address.
static void	startWebBrowser(android.app.Activity activity, java.lang.String uri) Starts the web browser in order to show a specific URI.
static void	startWebBrowser(android.app.Activity activity, android.net.Uri uri) Starts the web browser in order to show a specific URI.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

startCameraApp

public static void startCameraApp(android.app.Activity activity,
                                  int requestCode,
                                  java.io.File file)

Starts the camera app in order to capture a picture. If an error occurs while starting the camera app, an ActivityNotFoundException will be thrown.

Parameters:

activity - The activity, the captured picture should be passed to by calling its onActivityResult method, as an instance of the class Activity. The activity may not be null

requestCode - The request code, which should be used to pass the captured picture to the given activity, as an Integer value

file - The file, the captured picture should be saved to, as an instance of the class File. The file may not be null. The file must exist and must not be a directory.

startCameraApp

public static void startCameraApp(android.app.Activity activity,
                                  int requestCode,
                                  android.net.Uri uri)

Starts the camera app in order to capture a picture. If an error occurs while starting the camera app, an ActivityNotFoundException will be thrown.

Parameters:

activity - The activity, the captured picture should be passed to by calling its onActivityResult method, as an instance of the class Activity. The activity may not be null

requestCode - The request code, which should be used to pass the captured picture to the given activity, as an Integer value

uri - The URI of the file, the captured image should be saved to, as an instance of the class Uri. The URI may not be null

startGalleryApp

public static void startGalleryApp(android.app.Activity activity,
                                   int requestCode)

Starts the gallery app in order to choose a picture. In an error occurs while starting the gallery app, an ActivityNotFoundException will be thrown.

Parameters:

activity - The activity, the chosen image should be passed to by calling its onActivityResult method, as an instance of the class Activity. The activity may not be null

requestCode - The request code, which should be used to pass the captured picture to the given activity, as an Integer value

startGalleryApp

public static void startGalleryApp(android.app.Activity activity,
                                   java.io.File file)

Starts the gallery app in order to show a specific image. If an error occurs while starting the gallery app, an ActivityNotFoundException will be thrown.

Parameters:

activity - The activity, the gallery app should be started from, as an instance of the class Activity. The activity may not be null

file - The file, which stores the image, which should be shown, as an instance of the class File. The file may not be null. The file must exist and must not be a directory.

startGalleryApp

public static void startGalleryApp(android.app.Activity activity,
                                   android.net.Uri uri)

Starts the gallery app in order to show a specific image. If an error occurs while starting the gallery app, an ActivityNotFoundException will be thrown.

Parameters:

activity - The activity, the gallery app should be started from, as an instance of the class Activity. The activity may not be null

uri - The URI of the image, which should be shown, as an instance of the class Uri. The URI may not be null and must be valid

startWebBrowser

public static void startWebBrowser(android.app.Activity activity,
                                   java.lang.String uri)

Starts the web browser in order to show a specific URI. If an error occurs while starting the web browser an ActivityNotFoundException will be thrown.

Parameters:

activity - The activity, the web browser should be started from, as an instance of the class Activity. The activity may not be null

uri - The URI, which should be shown, as a String. The URI may neither be null, nor empty

startWebBrowser

public static void startWebBrowser(android.app.Activity activity,
                                   android.net.Uri uri)

Starts the web browser in order to show a specific URI. If an error occurs while starting the web browser an ActivityNotFoundException will be thrown.

Parameters:

activity - The activity, the web browser should be started from, as an instance of the class Activity. The activity may not be null

uri - The URI, which should be shown, as an instance of the class Uri. The URI may not be null

startMailClient

public static void startMailClient(android.app.Activity activity,
                                   java.lang.String emailAddress)

Starts the mail client in order to send an e-mail to a specific e-mail address. If an error occurs while starting the mail client, an ActivityNotFoundException will be thrown.

Parameters:

activity - The activity, the mail client should be started from, as an instance of the class Activity. The activity may not be null

emailAddress - The e-mail address, the e-mail should be sent to, as a String. The e-mail address may neither be null, nor empty

startMailClient

public static void startMailClient(android.app.Activity activity,
                                   java.lang.String emailAddress,
                                   java.lang.String subject,
                                   java.lang.String text)

Starts the mail client in order to send an e-mail to a specific e-mail address. If an error occurs while starting the mail client, an ActivityNotFoundException will be thrown.

Parameters:

activity - The activity, the mail client should be started from, as an instance of the class Activity. The activity may not be null

emailAddress - The e-mail address, the e-mail should be sent to, as a String. The e-mail address may neither be null, nor empty

subject - The subject of the e-mail, which should be sent, as a String or null, if the e-mail should not have a subject

text - The text of the e-mail, which should be sent, as a String or null, if the e-mail should not have a text

startMailClient

public static void startMailClient(android.app.Activity activity,
                                   java.lang.String[] emailAddresses)

Starts the mail client in order to send an e-mail to specific e-mail addresses. If an error occurs while starting the mail client, an ActivityNotFoundException will be thrown.

Parameters:

activity - The activity, the mail client should be started from, as an instance of the class Activity. The activity may not be null

emailAddresses - An array, which contains the e-mail addresses, the e-mail should be sent to, as a String array. The array may neither be null, nor empty

startMailClient

public static void startMailClient(android.app.Activity activity,
                                   java.lang.String[] emailAddresses,
                                   java.lang.String subject,
                                   java.lang.String text)

Starts the mail client in order to send an e-mail to specific e-mail addresses. If an error occurs while starting the mail client, an ActivityNotFoundException will be thrown.

Parameters:

activity - The activity, the mail client should be started from, as an instance of the class Activity. The activity may not be null

emailAddresses - An array, which contains the e-mail addresses, the e-mail should be sent to, as a String array. The array may neither be null, nor empty

subject - The subject of the e-mail, which should be sent, as a String or null, if the e-mail should not have a subject

text - The text of the e-mail, which should be sent, as a String or null, if the e-mail should not have a text

startDialer

public static void startDialer(android.app.Activity activity,
                               int phoneNumber)

Starts the dialer in order to call a specific phone number. The call has to be manually started by the user. If an error occurs while starting the dialer, an ActivityNotFoundException will be thrown.

Parameters:

activity - The activity, the dialer should be started from, as an instance of the class Activity. The activity may not be null

phoneNumber - The phone number, which should be dialed, as an Integer value

startDialer

public static void startDialer(android.app.Activity activity,
                               long phoneNumber)

Starts the dialer in order to call a specific phone number. The call has to be manually started by the user. If an error occurs while starting the dialer, an ActivityNotFoundException will be thrown.

Parameters:

activity - The activity, the dialer should be started from, as an instance of the class Activity. The activity may not be null

phoneNumber - The phone number, which should be dialed, as a Long value

startDialer

public static void startDialer(android.app.Activity activity,
                               java.lang.String phoneNumber)

Starts the dialer in order to call a specific phone number. The call has to be manually started by the user. If an error occurs while starting the dialer, an ActivityNotFoundException will be thrown.

Parameters:

activity - The activity, the dialer should be started from, as an instance of the class Activity. The activity may not be null

phoneNumber - The phone number, which should be dialed, as a String. The phone number may neither be null, nor empty

startCall

public static void startCall(android.app.Activity activity,
                             int phoneNumber)

Starts the dialer in order to call a specific phone number. The call is immediately started, requiring the invoking app to have the permission android.permission.CALL_PHONE granted, otherwise a SecurityException will be thrown. If an error occurs while starting the dialer, an ActivityNotFoundException will be thrown.

Parameters:

activity - The activity, the dialer should be started from, as an instance of the class Activity. The activity may not be null

phoneNumber - The phone number, which should be called, as an Integer value

startCall

public static void startCall(android.app.Activity activity,
                             long phoneNumber)

Starts the dialer in order to call a specific phone number. The call is immediately started, requiring the invoking app to have the permission android.permission.CALL_PHONE granted, otherwise a SecurityException will be thrown. If an error occurs while starting the dialer, an ActivityNotFoundException will be thrown.

Parameters:

activity - The activity, the dialer should be started from, as an instance of the class Activity. The activity may not be null

phoneNumber - The phone number, which should be called, as a Long value

startCall

public static void startCall(android.app.Activity activity,
                             java.lang.String phoneNumber)

Starts the dialer in order to call a specific phone number. The call is immediately started, requiring the invoking app to have the permission android.permission.CALL_PHONE granted, otherwise a SecurityException will be thrown. If an error occurs while starting the dialer, an ActivityNotFoundException will be thrown.

Parameters:

activity - The activity, the dialer should be started from, as an instance of the class Activity. The activity may not be null

phoneNumber - The phone number, which should be called, as a String. The phone number may neither be null, nor empty