Deprecated API

Contents

• Deprecated Packages
• Deprecated Interfaces
• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors
• Deprecated Annotation Type Elements

Deprecated Packages

Package and Description
org.robolectric.shadows.httpclient

Deprecated Interfaces

Interface and Description
org.robolectric.res.FsFile Use Path instead.
org.robolectric.Robolectric.AttributeSetBuilder Use AttributeSetBuilder instead.

Deprecated Classes

Class and Description
org.robolectric.ConfigMerger Provide an implementation of javax.inject.Provider instead. See Migration Notes for details. This class will be removed in Robolectric 4.3.
org.robolectric.android.controller.FragmentController Native Fragments have been deprecated in Android P. Android encourages developers to use androidx fragments, to test these use FragmentScenario.
org.robolectric.util.FragmentTestUtil Please use Robolectric.buildFragment(Class) instead. This will be removed in a forthcoming release,
org.robolectric.internal.MavenManifestFactory This method of configuration will be removed in a forthcoming release. Build systems should follow http://robolectric.org/build-system-integration/ to provide integration with Robolectric.
org.robolectric.MavenRoboSettings Don’t put more stuff here.
org.robolectric.RobolectricTestRunner.DeprecatedTestRunnerDefaultConfigProvider
org.robolectric.RoboSettings Don’t put more stuff here.
org.robolectric.SdkPicker use DefaultSdkPicker instead.
org.robolectric.shadows.ShadowHandler
org.robolectric.util.SimpleFuture
org.robolectric.shadows.support.v4.SupportFragmentTestUtil Android encourages developers to use androidx fragments, to test these use androidx.fragment.app.testing.FragmentScenario.

Deprecated Fields

Field and Description
org.robolectric.res.android.AConfiguration.ACONFIGURATION_ORIENTATION_SQUARE Not currently supported or used.
org.robolectric.res.android.AConfiguration.ACONFIGURATION_TOUCHSCREEN_STYLUS Not currently supported or used.
org.robolectric.RuntimeEnvironment.application Please migrate to androidx.test.core.app.ApplicationProvider#getApplicationContext

Deprecated Methods

Method and Description
org.robolectric.shadows.ShadowUsageStatsManager.addEvent(String, long, int) Use #addEvent(Event) and ShadowUsageStatsManager.EventBuilder instead.
org.robolectric.shadows.ShadowPackageManager.addPackage(PackageInfo)
org.robolectric.shadows.ShadowPackageManager.addPackage(String) Use ShadowPackageManager.installPackage(PackageInfo) instead.
org.robolectric.shadows.httpclient.FakeHttp.addPendingHttpResponseWithContentType(int, String, Header) use FakeHttp.addPendingHttpResponse(int, String, org.apache.http.Header...) instead
org.robolectric.res.Qualifiers.addPlatformVersion(String, int) Figure something else out.
org.robolectric.shadows.ShadowPackageManager.addResolveInfoForIntent(Intent, List<ResolveInfo>) see note on ShadowPackageManager.addResolveInfoForIntent(Intent, ResolveInfo).
org.robolectric.shadows.ShadowPackageManager.addResolveInfoForIntent(Intent, ResolveInfo) use ShadowPackageManager.addIntentFilterForComponent(android.content.ComponentName, android.content.IntentFilter, java.util.Map<android.content.ComponentName, java.util.List<android.content.IntentFilter>>) instead and if the component doesn’t exist add it using any of ShadowPackageManager.installPackage(android.content.pm.PackageInfo), ShadowPackageManager.addOrUpdateActivity(android.content.pm.ActivityInfo), ShadowPackageManager.addActivityIfNotPresent(android.content.ComponentName) or their counterparts for other types of components.
org.robolectric.shadows.ShadowPackageManager.addResolveInfoForIntentNoDefaults(Intent, ResolveInfo) see the note on ShadowPackageManager.addResolveInfoForIntent(Intent, ResolveInfo).
org.robolectric.res.Qualifiers.addScreenWidth(String, int) Use Configuration.screenWidthDp instead.
org.robolectric.shadows.ShadowSensorManager.addSensor(int, Sensor) Use ShadowSensor.newInstance(int) to construct your Sensor and add to the SensorManager using ShadowSensorManager.addSensor(Sensor) instead. This method will be removed at some point allowing us to use more of the real SensorManager code.
org.robolectric.res.Qualifiers.addSmallestScreenWidth(String, int) Use Configuration.smallestScreenWidthDp instead.
org.robolectric.util.Scheduler.advanceBy(long) Use Scheduler.advanceBy(long, TimeUnit).
org.robolectric.Robolectric.buildFragment(Class<T>) Native Fragments have been deprecated in Android P. Android encourages developers to use androidx fragments, to test these use FragmentScenario.
org.robolectric.Robolectric.buildFragment(Class<T>, Bundle) Native Fragments have been deprecated in Android P. Android encourages developers to use androidx fragments, to test these use FragmentScenario.
org.robolectric.Robolectric.buildFragment(Class<T>, Class<? extends Activity>) Native Fragments have been deprecated in Android P. Android encourages developers to use androidx fragments, to test these use FragmentScenario.
org.robolectric.Robolectric.buildFragment(Class<T>, Class<? extends Activity>, Bundle) Native Fragments have been deprecated in Android P. Android encourages developers to use androidx fragments, to test these use FragmentScenario.
org.robolectric.Robolectric.buildFragment(Class<T>, Class<? extends Activity>, Intent) Native Fragments have been deprecated in Android P. Android encourages developers to use androidx fragments, to test these use FragmentScenario.
org.robolectric.Robolectric.buildFragment(Class<T>, Class<? extends Activity>, Intent, Bundle) Native Fragments have been deprecated in Android P. Android encourages developers to use androidx fragments, to test these use FragmentScenario.
org.robolectric.Robolectric.buildFragment(Class<T>, Intent) Native Fragments have been deprecated in Android P. Android encourages developers to use androidx fragments, to test these use FragmentScenario.
org.robolectric.Robolectric.buildFragment(Class<T>, Intent, Bundle) Native Fragments have been deprecated in Android P. Android encourages developers to use androidx fragments, to test these use FragmentScenario.
org.robolectric.RobolectricTestRunner.buildGlobalConfig() Provide a service implementation of GlobalConfigProvider instead. See Migration Notes for details. This method will be removed in Robolectric 4.3.
org.robolectric.shadows.ShadowAppOpsManager.checkOpNoThrow(String, int, String)
org.robolectric.shadows.ShadowTelecomManager.clearAccounts()
org.robolectric.internal.bytecode.ShadowMap.convertToShadowName(String) do not use
org.robolectric.RobolectricTestRunner.createAndroidManifest(ManifestIdentifier) Do not use.
org.robolectric.res.Fs.fileFromPath(String) Use Fs.fromUrl(String) instead.
org.robolectric.shadows.ShadowAccountManager.get(Context) This method will be removed in Robolectric 3.4 Use AccountManager.get(Context) instead.
org.robolectric.shadows.ShadowApplication.getAppWidgetManager() Please use Context#getSystemService(Context.APPWIDGET_SERVICE) intstead.
org.robolectric.manifest.PackageItemData.getClassName() Use PackageItemData.getName() instead.
org.robolectric.shadows.ShadowAssetManager.ArscBase.getCompileTimeResTable() Avoid use.
org.robolectric.RobolectricTestRunner.getConfig(Method) Provide an implementation of javax.inject.Provider instead. See Migration Notes for details. This method will be removed in Robolectric 4.3.
org.robolectric.RobolectricTestRunner.getConfiguration(Method) Going away before 4.2. DO NOT SHIP.
org.robolectric.shadows.ShadowBitmapDrawable.getCreatedFromResId() use ShadowBitmap#getCreatedFromResId() instead.
org.robolectric.shadows.ShadowTelecomManager.getDefaultPhoneApp()
org.robolectric.shadows.ShadowDisplay.getDisplayId() This behavior is deprecated and will be removed in Robolectric 3.7.
org.robolectric.shadows.ShadowTelephonyManager.getEventFlags() Avoid using.
org.robolectric.shadows.ShadowApplication.getInstance() Use shadowOf(androidx.test.core.app.ApplicationProvider#getApplicationContext) instead.
org.robolectric.shadows.ShadowApplication.getLatestAlertDialog() Use ShadowAlertDialog.getLatestAlertDialog() instead.
org.robolectric.shadows.ShadowApplication.getLatestDialog() Use ShadowDialog.getLatestDialog() instead.
org.robolectric.shadows.ShadowApplication.getLatestPopupMenu() Use ShadowPopupMenu.getLatestPopupMenu() instead.
org.robolectric.shadows.ShadowTelephonyManager.getListener() Avoid using.
org.robolectric.internal.dependency.DependencyResolver.getLocalArtifactUrls(DependencyJar) Robolectric will never ask for a dependency composed of more than one artifact, so this method isn’t necessary.
org.robolectric.shadows.ShadowDisplay.getMetrics(DisplayMetrics) This behavior is deprecated and will be removed in Robolectric 3.7.
org.robolectric.res.android.NativeObjRegistry.getNativeObjectId(T) Use NativeObjRegistry.register(Object) instead.
org.robolectric.res.Qualifiers.getOrientation(String) Use Configuration.orientation instead.
org.robolectric.shadows.ShadowPackageManager.getPackageInfoForTesting(String) Use ShadowPackageManager.getInternalMutablePackageInfo(java.lang.String) instead. It has better name.
org.robolectric.res.FsFile.getPath() use Fs.externalize(Path) instead.
org.robolectric.shadows.ShadowDisplay.getPixelFormat() This behavior is deprecated and will be removed in Robolectric 3.7.
org.robolectric.res.Qualifiers.getPlatformVersion(String) Use Build.VERSION.SDK_INT instead.
org.robolectric.shadows.ShadowDisplay.getRealMetrics(DisplayMetrics) This behavior is deprecated and will be removed in Robolectric 3.7.
org.robolectric.shadows.ShadowApplication.getReceiversForIntent(Intent) use PackageManager.queryBroadcastReceivers instead
org.robolectric.shadows.ShadowDisplay.getRefreshRate() This behavior is deprecated and will be removed in Robolectric 3.7.
org.robolectric.res.Qualifiers.getScreenWidth(String) Use Configuration.screenWidthDp instead.
org.robolectric.shadows.httpclient.ShadowDefaultRequestDirector.getSentHttpRequest(int) Use FakeHttp.getSentHttpRequestInfo(int) instead.)
org.robolectric.shadows.httpclient.ShadowDefaultRequestDirector.getSentHttpRequestInfo(int) Use FakeHttp.getSentHttpRequest(int) instead.)
org.robolectric.shadows.ShadowLooper.getShadowMainLooper() Use shadowOf(Looper.getMainLooper()) instead.
org.robolectric.res.Qualifiers.getSmallestScreenWidth(String) Use Configuration.smallestScreenWidthDp instead.
org.robolectric.shadows.ShadowApplication.hasReceiverForIntent(Intent) use PackageManager.queryBroadcastReceivers instead
org.robolectric.shadows.ShadowLooper.idle(long) Use ShadowLooper.idle(long, TimeUnit).
org.robolectric.util.Scheduler.idleConstantly(boolean) This method is ambiguous in how it should behave when turning off constant idle. Use Scheduler.setIdleState(IdleState) instead to explicitly set the state.
org.robolectric.shadows.ShadowLooper.idleMainLooper(long) Use ShadowLooper.idleMainLooper(long, TimeUnit).
org.robolectric.shadows.ShadowActivity.isFinishing() Use Activity.isFinishing() instead.
org.robolectric.shadows.ShadowActivity.isLockTask() Use ActivityManager.getLockTaskModeState() instead.
org.robolectric.res.FsFile.join(String) use Path.resolve(Path) instead.
org.robolectric.res.Fs.newFile(File) Use File.toPath() instead.
org.robolectric.shadows.ShadowNetworkInfo.newInstance(NetworkInfo.DetailedState, int, int, boolean, boolean) use ShadowNetworkInfo.newInstance(NetworkInfo.DetailedState, int, int, boolean, NetworkInfo.State) instead
org.robolectric.android.AccessibilityUtil.passesAccessibilityChecksIfEnabled(View)
org.robolectric.shadows.ShadowLooper.post(Runnable, long) Use a Handler instance to post to a looper.
org.robolectric.shadows.ShadowLooper.postAtFrontOfQueue(Runnable) Use a Handler instance to post to a looper.
org.robolectric.shadows.ShadowAppWidgetManager.putWidgetInfo(int, AppWidgetProviderInfo)
org.robolectric.shadows.ShadowPackageManager.removeResolveInfosForIntent(Intent, String) see note on ShadowPackageManager.addResolveInfoForIntent(Intent, ResolveInfo).
org.robolectric.shadows.ShadowActivityThread.setApplicationInfo(ApplicationInfo) do not use
org.robolectric.shadows.ShadowWebView.setCanGoBack(boolean) Do not depend on this method as it will be removed in a future update. The preferered method is to populate a fake web history to use for going back.
org.robolectric.shadows.ShadowNetworkInfo.setConnectionStatus(boolean) use ShadowNetworkInfo.setConnectionStatus(NetworkInfo.State) instead
org.robolectric.shadows.ShadowDisplay.setDisplayId(int) This method is deprecated and will be removed in Robolectric 3.7.
org.robolectric.shadows.ShadowFingerprintManager.setHasEnrolledFingerprints(boolean) use ShadowFingerprintManager.setDefaultFingerprints(int) instead.
org.robolectric.shadows.ShadowKeyguardManager.setinRestrictedInputMode(boolean) use ShadowKeyguardManager.setInRestrictedInputMode(boolean) instead
org.robolectric.shadows.ShadowUserManager.setIsDemoUser(boolean) Use ShadowUserManager.addUser(int, String, int) to create a demo user instead of changing default user flags.
org.robolectric.shadows.ShadowUserManager.setIsGuestUser(boolean) Use ShadowUserManager.addUser(int, String, int) to create a guest user instead of changing default user flags.
org.robolectric.shadows.ShadowUserManager.setIsLinkedUser(boolean) Use ShadowUserManager.addUser(int, String, int) to create a linked user instead of changing default user flags.
org.robolectric.shadows.ShadowUserManager.setIsPrimaryUser(boolean) Use ShadowUserManager.addUser(int, String, int) to create a primary user instead of changing default user flags.
org.robolectric.shadows.ShadowUserManager.setIsSystemUser(boolean) Use ShadowUserManager.addUser(int, String, int) to create a system user instead of changing default user flags.
org.robolectric.shadows.ShadowActivity.setLastNonConfigurationInstance(Object) use ActivityController.recreate().
org.robolectric.shadows.ShadowDisplay.setPixelFormat(int) This method is deprecated and will be removed in Robolectric 3.7.
org.robolectric.shadows.ShadowMotionEvent.setPointer2(float, float) use MotionEvent.obtain() or androidx.test.core.view.MotionEventBuilder to create a MotionEvent with desired data.
org.robolectric.shadows.ShadowMotionEvent.setPointerIds(int, int) use MotionEvent.obtain() or MotionEventBuilder to create a MotionEvent with desired data
org.robolectric.shadows.ShadowMotionEvent.setPointerIndex(int) use MotionEvent.obtain() or androidx.test.core.view.MotionEventBuilder#setPointerAction(int, int) to create a MotionEvent with desired data.
org.robolectric.shadows.ShadowPackageManager.setResolveInfosForIntent(Intent, List<ResolveInfo>) see the note on ShadowPackageManager.addResolveInfoForIntent(Intent, ResolveInfo).
org.robolectric.shadows.ShadowDisplay.setScaledDensity(float) This method is deprecated and will be removed in Robolectric 3.7.
org.robolectric.shadows.ShadowUserManager.setSerialNumberForUser(UserHandle, long) prefer ShadowUserManager.addUserProfile(UserHandle) to ensure consistency of profiles known to the UserManager. Furthermore, calling this method for the current user, i.e: Process.myUserHandle() is no longer necessary as this user is always known to UserManager and has a preassigned serial number.
org.robolectric.shadows.ShadowPackageInstaller.setSessionSucceeds(int)
org.robolectric.shadows.ShadowApplication.setSystemService(String, Object) Do not depend on this method to override services as it will be removed in a future update. The preferered method is use the shadow of the corresponding service.
org.robolectric.Robolectric.setupActivity(Class<T>) use androidx.test.core.app.ActivityScenario
org.robolectric.RuntimeEnvironment.setUseLegacyResources(boolean) Do not use.
org.robolectric.Shadows.shadowOf(Handler)
org.robolectric.manifest.AndroidManifest.supportsBinaryResourcesMode() Do not use.
org.robolectric.manifest.AndroidManifest.supportsLegacyResourcesMode() Do not use.
org.robolectric.res.android.NativeObjRegistry.unregister(T) Use NativeObjRegistry.unregister(long) instead.
org.robolectric.shadows.ShadowAssetManager.useLegacy() Avoid use.
org.robolectric.RuntimeEnvironment.useLegacyResources() Do not use.
org.robolectric.android.controller.ServiceController.withIntent(Intent) Use the appropriate builder in Robolectric instead. This method will be removed in Robolectric 3.6.

Deprecated Constructors

Constructor and Description
org.robolectric.internal.ManifestIdentifier(Path, Path, Path, String, List<Path>) Use ManifestIdentifier.ManifestIdentifier(String, Path, Path, Path, List) instead.
org.robolectric.android.XmlResourceParserImpl(Document, String, String, String, ResourceTable) use XmlResourceParserImpl.XmlResourceParserImpl(Document, Path, String, String, ResourceTable) instead.

Deprecated Annotation Type Elements

Annotation Type Element and Description
org.robolectric.annotation.Config.assetDir If you are using at least Android Studio 3.0 alpha 5 or Bazel’s android_local_test please migrate to the preferred way to configure
org.robolectric.annotation.Config.libraries If you are using at least Android Studio 3.0 alpha 5 or Bazel’s android_local_test please migrate to the preferred way to configure
org.robolectric.annotation.Config.manifest If you are using at least Android Studio 3.0 alpha 5 or Bazel’s android_local_test please migrate to the preferred way to configure builds http://robolectric.org/getting-started/
org.robolectric.annotation.Config.packageName To change your package name please override the applicationId in your build system. Changing package name here is broken as the package name will no longer match the package name encoded in the arsc resources file. If you are looking to simulate another application you can create another applications Context using Context.createPackageContext(String, int). Note that you must add this package to ShadowPackageManager.addPackage(android.content.pm.PackageInfo) first.
org.robolectric.annotation.Config.resourceDir If you are using at least Android Studio 3.0 alpha 5 or Bazel’s android_local_test please migrate to the preferred way to configure