Package org.robolectric.shadows
Class ShadowEnvironment
- java.lang.Object
-
- org.robolectric.shadows.ShadowEnvironment
-
@Implements(android.os.Environment.class) public class ShadowEnvironment extends Object
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
ShadowEnvironment.ShadowUserEnvironment
-
Constructor Summary
Constructors Constructor Description ShadowEnvironment()
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static File
addExternalDir(String path)
Adds a directory to list returned byShadowEnvironment.ShadowUserEnvironment.getExternalDirs()
.protected static File[]
buildExternalStorageAppCacheDirs(String packageName)
protected static File
getExternalStorageAppCacheDirectory(String packageName)
protected static File
getExternalStorageDirectory()
protected static File
getExternalStoragePublicDirectory(String type)
protected static String
getExternalStorageState()
protected static String
getExternalStorageState(File directory)
protected static String
getStorageState(File directory)
protected static boolean
isExternalStorageEmulated()
protected static boolean
isExternalStorageEmulated(File path)
protected static boolean
isExternalStorageLegacy()
protected static boolean
isExternalStorageLegacy(File path)
protected static boolean
isExternalStorageRemovable()
protected static boolean
isExternalStorageRemovable(File path)
static void
reset()
static void
setExternalStorageDirectory(Path directory)
Sets the return value ofgetExternalStorageDirectory()
.static void
setExternalStorageEmulated(File file, boolean isEmulated)
Sets the "isEmulated" flag of a particular file.static void
setExternalStorageRemovable(File file, boolean isRemovable)
Sets the "isRemovable" flag of a particular file.static void
setExternalStorageState(File directory, String state)
Sets thegetExternalStorageState(File)
for given directory.static void
setExternalStorageState(String externalStorageState)
Sets the return value ofgetExternalStorageState()
.static void
setIsExternalStorageEmulated(boolean emulated)
Sets the return value ofisExternalStorageEmulated()
.static void
setIsExternalStorageLegacy(boolean legacy)
Sets the return value ofisExternalStorageLegacy()
()}.
-
-
-
Method Detail
-
getExternalStorageState
@Implementation protected static String getExternalStorageState()
-
setExternalStorageState
public static void setExternalStorageState(String externalStorageState)
Sets the return value ofgetExternalStorageState()
.- Parameters:
externalStorageState
- Value to return fromgetExternalStorageState()
.
-
setIsExternalStorageEmulated
public static void setIsExternalStorageEmulated(boolean emulated)
Sets the return value ofisExternalStorageEmulated()
.- Parameters:
emulated
- Value to return fromisExternalStorageEmulated()
.
-
setIsExternalStorageLegacy
public static void setIsExternalStorageLegacy(boolean legacy)
Sets the return value ofisExternalStorageLegacy()
()}.- Parameters:
legacy
- Value to return fromisExternalStorageLegacy()
.
-
setExternalStorageDirectory
public static void setExternalStorageDirectory(Path directory)
Sets the return value ofgetExternalStorageDirectory()
. Note that the default value provides a directory that is usable in the test environment. If the test app uses this method to override that default directory, please clean up any files written to that directory, as the Robolectric environment will not purge that directory when the test ends.- Parameters:
directory
- Path to return fromgetExternalStorageDirectory()
.
-
getExternalStorageDirectory
@Implementation protected static File getExternalStorageDirectory()
-
buildExternalStorageAppCacheDirs
@Implementation(minSdk=19) protected static File[] buildExternalStorageAppCacheDirs(String packageName)
-
getExternalStorageAppCacheDirectory
@Implementation(maxSdk=18) protected static File getExternalStorageAppCacheDirectory(String packageName)
-
getExternalStoragePublicDirectory
@Implementation protected static File getExternalStoragePublicDirectory(String type)
-
reset
@Resetter public static void reset()
-
isExternalStorageRemovable
@Implementation protected static boolean isExternalStorageRemovable()
-
getStorageState
@Implementation(minSdk=19) protected static String getStorageState(File directory)
-
getExternalStorageState
@Implementation(minSdk=21) protected static String getExternalStorageState(File directory)
-
isExternalStorageRemovable
@Implementation(minSdk=21) protected static boolean isExternalStorageRemovable(File path)
-
isExternalStorageEmulated
@Implementation(minSdk=21) protected static boolean isExternalStorageEmulated(File path)
-
isExternalStorageEmulated
@Implementation protected static boolean isExternalStorageEmulated()
-
isExternalStorageLegacy
@Implementation(minSdk=29) protected static boolean isExternalStorageLegacy(File path)
-
isExternalStorageLegacy
@Implementation(minSdk=29) protected static boolean isExternalStorageLegacy()
-
setExternalStorageRemovable
public static void setExternalStorageRemovable(File file, boolean isRemovable)
Sets the "isRemovable" flag of a particular file.- Parameters:
file
- Target file.isRemovable
- True if the filesystem is removable.
-
setExternalStorageEmulated
public static void setExternalStorageEmulated(File file, boolean isEmulated)
Sets the "isEmulated" flag of a particular file.- Parameters:
file
- Target file.isEmulated
- True if the filesystem is emulated.
-
addExternalDir
public static File addExternalDir(String path)
Adds a directory to list returned byShadowEnvironment.ShadowUserEnvironment.getExternalDirs()
.- Parameters:
path
- the external dir to add
-
setExternalStorageState
public static void setExternalStorageState(File directory, String state)
Sets thegetExternalStorageState(File)
for given directory.- Parameters:
externalStorageState
- Value to return fromgetExternalStorageState(File)
.
-
-