TheActivityManager

Additional

Language
Java
Version
N/A
Created
Apr 10, 2015
Updated
Mar 23, 2016 (Retired)
Owner
Yahya Bayramoğlu (yayaa)
Contributor
Yahya Bayramoğlu (yayaa)
1
Activity
Badge
Generate
Download
Source code

TheActivityManager

Tested with Leak Canary

Android OS starts activities up to intents you send as a broadcast, but because it is done privately, you cannot track those activities. You may never know which activity is currently visible, unless you work around somehow. This library will provide you to manage that.

This library uses a singleton class to create a static object and keep instances of your activities. So, you can reach them out whenever you want, and do whatever you wish.

Configuration

To use this library, you need to notify TheActivityManager onCreate, onResume, onPause and onDestroy of activity.

You can call these methods by yourself in every activity that you create

OR

To simplify this step i created a TAMBaseActiviy, which extends from AppCompatActivity, so just extend your activities from this and it will take care of the rest.

OR

if your application's minSdkVersion >= 14 then you can simply call TheActivityManager.getInstance().configure(application) and it will handle all.

CAUTION: If you call configure method, you MUST call it only once, and you MUST NOT extend your activities from TAMBaseActiviy otherwise it will create multiple instance in TheActivityManager array, which may cause crash!

Usage

TheActivityManager.getInstance().getCurrentActivity(); 
  • This method basically return the instance of current activity and you can use it to compare with something or display dialog, popup or whatever you wish, you can call any method on that activity now. This will provide you to access almost every activity.
TheActivityManager.getInstance().isApplicationRunning();  
  • You can check whether application is currently running or it's been paused for some reason. For instance, you have a service to download something and when it is completed you can just check whether user is still using the application or not, you can have different ways to go.
TheActivityManager.getInstance().finishAll();  
  • It doesn't matter how deeply you are in the application, this method will finish all of activities and will quit application.
TheActivityManager.getInstance().toLanding();  
  • It doesn't matter how deeply you were visiting detail pages on application, this method will turn you back to landing page which you should set first by calling `setAsLanding` method otherwise it will just act like `finishAll` method.
TheActivityManager.getInstance().setNextStep(activityTransporter);  
  • Let's assume that you have Activity A and C but before you go to C you need to do something in Activity B. So you tell TheActivityManager that C is your nextStep with the extras if necessary and when you done with B just call moveForward method and TheActivityManager will lead user to that acitivity with already given extras.

Download

Add library dependency to your build.gradle file:

dependencies {    
     compile 'com.yayandroid:TheActivityManager:1.0.6'
}

Name Story

I thought to name it as ActivityManager but didn't want it to be confused with Android's ActivityManager and than my friend remind me John Carmack's tweet and it was just perfect fit, so it became "TheActivityManager".

I have moved to naming global singletons with a The* prefix -- ThePacketServer, TheMasterServer, TheVoip, etc. Feels pretty good.

— John Carmack (@ID_AA_Carmack) 11 Mart 2015
<script async src="//platform.twitter.com/widgets.js" charset="utf-8"></script>

Compatibility

This library works on 2.2+ probably earlier as well, but i didn't even bother to test because i believe at some point we have to stop supporting every version ;)

License

The MIT License (MIT)

Copyright (c) 2015 yayandroid

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.