com.google.android.vending.expansion.downloader

Class Helpers

java.lang.Object

com.google.android.vending.expansion.downloader.Helpers

public class Helpers
extends Object

Some helper functions for the download manager

Field Summary

Fields

Modifier and Type	Field and Description
static Random	sRandom

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	doesFileExist(android.content.Context c, String fileName, long fileSize, boolean deleteFileOnMismatch) Helper function to ascertain the existence of a file and return true/false appropriately
static String	generateSaveFileName(android.content.Context c, String fileName) Returns the filename (where the file should be saved) from info about a download
static long	getAvailableBytes(File root)
static int	getDownloaderStringResourceIDFromState(int state) Converts download states that are returned by the IDownloaderClient.onDownloadStateChanged(int) callback into usable strings.
static String	getDownloadProgressPercent(long overallProgress, long overallTotal)
static String	getDownloadProgressString(long overallProgress, long overallTotal) Showing progress in MB here.
static String	getDownloadProgressStringNotification(long overallProgress, long overallTotal) Adds a percentile to getDownloadProgressString.
static String	getExpansionAPKFileName(android.content.Context c, boolean mainFile, int versionCode) Returns the file name (without full path) for an Expansion APK file from the given context.
static File	getFilesystemRoot(String path)
static String	getSaveFilePath(android.content.Context c)
static String	getSpeedString(float bytesPerMillisecond)
static String	getTimeRemaining(long durationInMilliseconds)
static boolean	isExternalMediaMounted()
static boolean	isFilenameValid(String filename) Checks whether the filename looks legitimate

Methods inherited from class java.lang.Object

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

Field Detail

sRandom

public static Random sRandom

Method Detail

getFilesystemRoot

public static File getFilesystemRoot(String path)

Returns:

the root of the filesystem containing the given path

isExternalMediaMounted

public static boolean isExternalMediaMounted()

getAvailableBytes

public static long getAvailableBytes(File root)

Returns:

the number of bytes available on the filesystem rooted at the given File

isFilenameValid

public static boolean isFilenameValid(String filename)

Checks whether the filename looks legitimate

getDownloadProgressString

public static String getDownloadProgressString(long overallProgress,
                               long overallTotal)

Showing progress in MB here. It would be nice to choose the unit (KB, MB, GB) based on total file size, but given what we know about the expected ranges of file sizes for APK expansion files, it's probably not necessary.

Parameters:

overallProgress -

overallTotal -

Returns:

getDownloadProgressStringNotification

public static String getDownloadProgressStringNotification(long overallProgress,
                                           long overallTotal)

Adds a percentile to getDownloadProgressString.

Parameters:

overallProgress -

overallTotal -

Returns:

getDownloadProgressPercent

public static String getDownloadProgressPercent(long overallProgress,
                                long overallTotal)

getSpeedString

public static String getSpeedString(float bytesPerMillisecond)

getTimeRemaining

public static String getTimeRemaining(long durationInMilliseconds)

getExpansionAPKFileName

public static String getExpansionAPKFileName(android.content.Context c,
                             boolean mainFile,
                             int versionCode)

Returns the file name (without full path) for an Expansion APK file from the given context.

Parameters:

c - the context

mainFile - true for main file, false for patch file

versionCode - the version of the file

Returns:

String the file name of the expansion file

generateSaveFileName

public static String generateSaveFileName(android.content.Context c,
                          String fileName)

Returns the filename (where the file should be saved) from info about a download

getSaveFilePath

public static String getSaveFilePath(android.content.Context c)

doesFileExist

public static boolean doesFileExist(android.content.Context c,
                    String fileName,
                    long fileSize,
                    boolean deleteFileOnMismatch)

Helper function to ascertain the existence of a file and return true/false appropriately

Parameters:

c - the app/activity/service context

fileName - the name (sans path) of the file to query

fileSize - the size that the file must match

deleteFileOnMismatch - if the file sizes do not match, delete the file

Returns:

true if it does exist, false otherwise

getDownloaderStringResourceIDFromState

public static int getDownloaderStringResourceIDFromState(int state)

Converts download states that are returned by the IDownloaderClient.onDownloadStateChanged(int) callback into usable strings. This is useful if using the state strings built into the library to display user messages.

Parameters:

state - One of the STATE_* constants from IDownloaderClient.

Returns:

string resource ID for the corresponding string.