com.smartdevicelink.util

Class AndroidTools

java.lang.Object

com.smartdevicelink.util.AndroidTools

public class AndroidTools
extends Object

Constructor Summary

Constructors

Constructor and Description
AndroidTools()

Method Summary

Modifier and Type	Method and Description
static Bitmap	downloadImage(String urlStr)
static HashMap<String,ResolveInfo>	getSdlEnabledApps(Context context, String myPackageName) Get all SDL enabled apps.
static Hashtable<String,Object>	getVehicleTypeFromPrefs(Context context, String address) Retrieves the vehicle details by the mac address of the connected vehicle.
static List<VehicleType>	getVehicleTypesFromManifest(Context context, ComponentName component, int manifestFieldId) Retrieves the list of vehicle types that are set in the manifest.
static boolean	isDebugMode(Context context)
static boolean	isServiceExported(Context context, ComponentName name) Check to see if a component is exported
static boolean	isUSBCableConnected(Context context) Checks if the usb cable is physically connected or not Note: the intent here is a sticky intent so registerReceiver is actually a synchronous call and doesn't register a receiver on each call
static List<SdlAppInfo>	querySdlAppInfo(Context context, Comparator<SdlAppInfo> comparator) Deprecated.
static List<SdlAppInfo>	querySdlAppInfo(Context context, Comparator<SdlAppInfo> comparator, VehicleType type) Finds all SDL apps via their SdlRouterService manifest entry.
static void	saveVehicleType(Context context, VehicleType vehicleType, String address) Saves the mac address along with vehicle details into user's shared prefs.
static void	sendExplicitBroadcast(Context context, Intent intent, List<ResolveInfo> apps) Sends the provided intent to the specified destinations making it an explicit intent, rather than an implicit intent.

Methods inherited from class java.lang.Object

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

Constructor Detail

AndroidTools

public AndroidTools()

Method Detail

isServiceExported

public static boolean isServiceExported(Context context,
                                        ComponentName name)

Check to see if a component is exported

Parameters:

context - object used to retrieve the package manager

name - of the component in question

Returns:

true if this component is tagged as exported

getSdlEnabledApps

public static HashMap<String,ResolveInfo> getSdlEnabledApps(Context context,
                                                            String myPackageName)

Get all SDL enabled apps. If the package name is null, it will return all apps. However, if the package name is included, the resulting hash map will not include the app with that package name.

Parameters:

context - a context object used to get an instance of the package manager

myPackageName - the package of the requesting app. This should only be included if the app wants to exclude itself from the map

Returns:

a hash map of SDL apps with the package name as the key, and the ResolveInfo as the value

querySdlAppInfo

@Deprecated
public static List<SdlAppInfo> querySdlAppInfo(Context context,
                                                           Comparator<SdlAppInfo> comparator)

Deprecated.

Finds all SDL apps via their SdlRouterService manifest entry. It will return the metadata associated with that router service.

Parameters:

context - a context instance to obtain the package manager

comparator - the Comparator to sort the resulting list. If null is supplied, they will be returned as they are from the system

Returns:

the sorted list of SdlAppInfo objects that represent SDL apps

querySdlAppInfo

public static List<SdlAppInfo> querySdlAppInfo(Context context,
                                               Comparator<SdlAppInfo> comparator,
                                               VehicleType type)

Finds all SDL apps via their SdlRouterService manifest entry. It will return the metadata associated with that router service.

Parameters:

context - a context instance to obtain the package manager

comparator - the Comparator to sort the resulting list. If null is supplied, they will be returned as they are from the system

Returns:

the sorted list of SdlAppInfo objects that represent SDL apps

sendExplicitBroadcast

public static void sendExplicitBroadcast(Context context,
                                         Intent intent,
                                         List<ResolveInfo> apps)

Sends the provided intent to the specified destinations making it an explicit intent, rather than an implicit intent. A direct replacement of sendBroadcast(Intent). As of Android 8.0 (API 26+) implicit broadcasts are no longer sent to broadcast receivers that are declared via the AndroidManifest. If no apps are found to receive the intent, this method will send the broadcast implicitly if no list of apps is provided.

Parameters:

intent - - the intent to send explicitly

apps - - the list of apps that this broadcast will be sent to. If null is passed in the intent will be sent to all apps that match the provided intent via a query to the package manager; it will also be sent implicitly to mimic sendBroadcast()'s original functionality.

isUSBCableConnected

public static boolean isUSBCableConnected(Context context)

Checks if the usb cable is physically connected or not Note: the intent here is a sticky intent so registerReceiver is actually a synchronous call and doesn't register a receiver on each call

Parameters:

context - a context instance

Returns:

boolean value that represents whether the usb cable is physically connected or not

downloadImage

public static Bitmap downloadImage(String urlStr)
                            throws IOException

Throws:

IOException

isDebugMode

public static boolean isDebugMode(Context context)

saveVehicleType

public static void saveVehicleType(Context context,
                                   VehicleType vehicleType,
                                   String address)

Saves the mac address along with vehicle details into user's shared prefs.

Parameters:

context - a context instance to obtain the shared preferences.

vehicleType - a RPCStruct that describes the type of vehicle the mobile phone is connected with.

address - a string containing the Bluetooth Mac address of the connected vehicle.

getVehicleTypeFromPrefs

@Nullable
public static Hashtable<String,Object> getVehicleTypeFromPrefs(Context context,
                                                                         String address)

Retrieves the vehicle details by the mac address of the connected vehicle.

Parameters:

context - a context instance to obtain the shared preferences.

address - a string containing the Bluetooth Mac address of the connected vehicle.

Returns:

The Hashtable to be used to construct VehicleTyp

getVehicleTypesFromManifest

@Nullable
public static List<VehicleType> getVehicleTypesFromManifest(Context context,
                                                                      ComponentName component,
                                                                      int manifestFieldId)

Retrieves the list of vehicle types that are set in the manifest.

Parameters:

context - a context to access Android system services through.

component - a component name of a LocalRouterService.

manifestFieldId - a string resources id that indicates an unique name for the vehicle data in the manifest.

Returns:

The list of vehicle types, or null if an error occurred or field was not found.