English｜中文
The android-startup library provides a straightforward, performant way to initialize components at application startup. Both library developers and app developers can use android-startup to streamline startup sequences and explicitly set the order of initialization.
At the same time, the android-startup support async await and sync await. And topological ordering is used to ensure the initialization order of dependent components.
Here is a piece of with Google App Startup feature comparison table.
| indicator | App Startup | Android Startup |
|---|---|---|
| Manually Config | ✅ | ✅ |
| Automatic Config | ✅ | ✅ |
| Support Dependencies | ✅ | ✅ |
| Handle Circle | ✅ | ✅ |
| Thread Of Control | ❌ | ✅ |
| Async Await | ❌ | ✅ |
| Callback Dependencies | ❌ | ✅ |
| Manual Notify | ❌ | ✅ |
| Topology Optimization | ❌ | ✅ |
| Time Cost Statistics | ❌ | ✅ |
| Thread Priority | ❌ | ✅ |
| Multiple Processes | ❌ | ✅ |
Open source is not easy, I hope friends shake hands, a star in the upper right corner, thank you🙏
Why I abandoned the Jetpack App Startup?
Add the following dependency to your build.gradle file:
repositories {
mavenCentral()
}
dependencies {
implementation 'io.github.idisfkj:android-startup:1.1.0'
}
Versions update information: Release
There are tow ways of using android-startup in your project,need to be initialized before using android-startup.
You define each component initializer by creating a class that implements the AndroidStartup abstract.
This abstract implements the Startup<T> interface. And this abstract defines four important methods:
-
The
callCreateOnMainThread(): Booleanmethod,which control thecreate()method is in the main thread calls.Othrewise in the other thread. -
The
waitOnMainThread(): Booleanmethod,which control the current component should call waiting in the main thread.If returns true, will block the main thread. -
The
create(): T?method,which contains all of the necessary operations to initialize the component and returns an instance ofT -
The
dependenciesByName(): List<String>?method,which returns a list of typeStringthat the initializer depends on.
For example, Define a SampleFirstStartup class that implements AndroidStartup<String>:
class SampleFirstStartup : AndroidStartup<String>() {
override fun callCreateOnMainThread(): Boolean = true
override fun waitOnMainThread(): Boolean = false
override fun create(context: Context): String? {
// todo something
return this.javaClass.simpleName
}
override fun dependenciesByName(): List<String>? {
return null
}
}
The dependenciesByName() method returns an null list because SampleFirstStartup does not depend on any other libraries.
Suppose that your app also depends on a library called SampleSecondStartup, which in turn depends on SampleFirstStartup. This dependency means that you need to make sure that Android Startup initializes SampleFirstStartup first.
class SampleSecondStartup : AndroidStartup<Boolean>() {
override fun callCreateOnMainThread(): Boolean = false
override fun waitOnMainThread(): Boolean = true
override fun create(context: Context): Boolean {
// Simulation execution time.
Thread.sleep(5000)
return true
}
override fun dependenciesByName(): List<String> {
return listOf("com.rousetime.sample.startup.SampleFirstStartup")
}
}
Because you include com.rousetime.sample.startup.SampleFirstStartup in the dependenciesByName() method, Android Startup initializes SampleFirstStartup before SampleSecondStartup.
For example, you also define a SampleThirdStartup and a SampleFourthStartup
The first one is automatic initializes startup in manifest.
Android Startup includes a special content provider called StartupProvider that it uses to discover and call your component startup.
In order for it to automatically identify, need in StartupProvider defined in the <meta-data> label.The name as defined by the component class, value values corresponding to the android.startup.
<provider
android:name="com.rousetime.android_startup.provider.StartupProvider"
android:authorities="${applicationId}.android_startup"
android:exported="false">
<meta-data
android:name="com.rousetime.sample.startup.SampleFourthStartup"
android:value="android.startup" />
</provider>
You don't need to add a <meta-data> entry for SampleFirstStartup, SampleSecondStartup and SampleThirdStartup, because them are a dependency of SampleFourthStartup. This means that if SampleFourthStartup is discoverable, then are also.
The second one is manually initializes startup in application.
Consider again the example,to make sure Android Startup can initializes,you can use StartupManager.Builder() directly in order to manually initialize components.
For example, the following code calls StartupManager.Builder() and manually initializes them:
class SampleApplication : Application() {
override fun onCreate() {
super.onCreate()
StartupManager.Builder()
.addStartup(SampleFirstStartup())
.addStartup(SampleSecondStartup())
.addStartup(SampleThirdStartup())
.addStartup(SampleFourthStartup())
.build(this)
.start()
.await()
}
}
You can check out the sample app for more code information.
Run the example code, the console will produce the log as follows:
- After the initialization sequence sorting optimization
*****/com.rousetime.sample D/StartupTrack: TopologySort result:
|================================================================
| order | [1]
|----------------------------------------------------------------
| Startup | SampleFirstStartup
|----------------------------------------------------------------
| Dependencies size | 0
|----------------------------------------------------------------
| callCreateOnMainThread | true
|----------------------------------------------------------------
| waitOnMainThread | false
|================================================================
| order | [2]
|----------------------------------------------------------------
| Startup | SampleSecondStartup
|----------------------------------------------------------------
| Dependencies size | 1
|----------------------------------------------------------------
| callCreateOnMainThread | false
|----------------------------------------------------------------
| waitOnMainThread | true
|================================================================
| order | [3]
|----------------------------------------------------------------
| Startup | SampleThirdStartup
|----------------------------------------------------------------
| Dependencies size | 2
|----------------------------------------------------------------
| callCreateOnMainThread | false
|----------------------------------------------------------------
| waitOnMainThread | false
|================================================================
| order | [4]
|----------------------------------------------------------------
| Startup | SampleFourthStartup
|----------------------------------------------------------------
| Dependencies size | 3
|----------------------------------------------------------------
| callCreateOnMainThread | false
|----------------------------------------------------------------
| waitOnMainThread | false
|================================================================
- Consumed components initialization times
*****/com.rousetime.sample D/StartupTrack: startup cost times detail:
|=================================================================
| Startup Name | SampleFirstStartup
| ----------------------- | --------------------------------------
| Call On Main Thread | true
| ----------------------- | --------------------------------------
| Wait On Main Thread | false
| ----------------------- | --------------------------------------
| Cost Times | 0 ms
|=================================================================
| Startup Name | SampleSecondStartup
| ----------------------- | --------------------------------------
| Call On Main Thread | false
| ----------------------- | --------------------------------------
| Wait On Main Thread | true
| ----------------------- | --------------------------------------
| Cost Times | 5001 ms
|=================================================================
| Startup Name | SampleThirdStartup
| ----------------------- | --------------------------------------
| Call On Main Thread | false
| ----------------------- | --------------------------------------
| Wait On Main Thread | false
| ----------------------- | --------------------------------------
| Cost Times | 3007 ms
|=================================================================
| Startup Name | SampleFourthStartup
| ----------------------- | --------------------------------------
| Call On Main Thread | false
| ----------------------- | --------------------------------------
| Wait On Main Thread | false
| ----------------------- | --------------------------------------
| Cost Times | 102 ms
|=================================================================
| Total Main Thread Times | 5008 ms
|=================================================================
-
LoggerLevel: Control Android Startup log level, include
LoggerLevel.NONE,LoggerLevel.ERRORandLoggerLevel.DEBUG. -
AwaitTimeout: Control Android Startup timeout of await on main thread.
-
StartupListener: Android Startup listener, all the component initialization completes the listener will be called.
-
OpenStatistic: Control the elapsed time statistics for each Android Startup task.
To use these config, you must define a class than implements the StartupProviderConfig interface:
class SampleStartupProviderConfig : StartupProviderConfig {
override fun getConfig(): StartupConfig =
StartupConfig.Builder()
.setLoggerLevel(LoggerLevel.DEBUG) // default LoggerLevel.NONE
.setAwaitTimeout(12000L) // default 10000L
.setOpenStatistics(true) // default true
.setListener(object : StartupListener {
override fun onCompleted(totalMainThreadCostTime: Long, costTimesModels: List<CostTimesModel>) {
// can to do cost time statistics.
}
})
.build()
}
At the same time, you need add StartupProviderConfig to manifest file:
<provider
android:name="com.rousetime.android_startup.provider.StartupProvider"
android:authorities="${applicationId}.android_startup"
android:exported="false">
<meta-data
android:name="com.rousetime.sample.startup.SampleStartupProviderConfig"
android:value="android.startup.provider.config" />
</provider>
StartupProvider that it uses to discover and call SampleStartupProviderConfig.
To use these config,you need use StartupManager.Builder() in application.
override fun onCreate() {
super.onCreate()
val config = StartupConfig.Builder()
.setLoggerLevel(LoggerLevel.DEBUG)
.setAwaitTimeout(12000L)
.setListener(object : StartupListener {
override fun onCompleted(totalMainThreadCostTime: Long, costTimesModels: List<CostTimesModel>) {
// can to do cost time statistics.
}
})
.build()
StartupManager.Builder()
.setConfig(config)
...
.build(this)
.start()
.await()
}
-
createExecutor(): Executor: If the startup not create on main thread, them the startup will run in the executor. -
onDependenciesCompleted(startup: Startup<*>, result: Any?): This method is called whenever there is a dependency completion. -
manualDispatch(): Boolean: Returns true that manual to dispatch. but must be callonDispatch(), in order to notify children that dependencies startup completed. -
onDispatch(): Start to dispatch whenmanualDispatch()return true.
-
hadInitialized(zClass: Class<out Startup<*>>): Check whether the corresponding component initialization has been completed. -
obtainInitializedResult(zClass: Class<out Startup<*>>): T?: Obtain corresponding components of has been initialized the returned results. -
remove(zClass: Class<out Startup<*>>): To get rid of the corresponding component initialization cache the results. -
clear(): Remove all the component initialization cache the results.
-
ThreadPriority: Set
Startupto initialize thread priority. -
MultipleProcess: The process on which
Startupis initialized.
-
Sync And Sync: Synchronization and synchronization depend on the scene.
-
Sync And Async: Synchronous and asynchronous depend on the scene.
-
Async And Sync: Asynchronous and synchronous depend on the scene.
-
Async And Async: Asynchronous and asynchronous depend on the scene.
-
Async And Async Await Main Thread: Asynchronous with asynchronous rely on wait in the main thread.
-
Manual Dispatch: Manually inform rely on the complete scene.
-
Thread Priority: Scenarios for changing thread priorities.
-
Multiple Processes: Multi-process initialization scenarios.
Please see LICENSE
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent