Warning: Library is not maintained anymore. If you want to take care of this library, propose it via Pull Request. It needs adjustmensts for newer versions of Android and Gradle.
ActivityStarter
Android Library that provides simpler way to start the Activities with multiple arguments.
Library bindes fields to Actity, Fragment, Service or Receiver arguments and generates simple starters. Thanks to that you can:
- Eliminate all putExtra and getXXXExtra methods
- Forget about all keys that were used to pass arguments (unless you want to define custom onces)
- Start liking starting flags and intent creation
Media:
Full documentation is located here. Here is TOC:
- Introdution
- Installation
- Usage for Activities
- Usage for Fragments
- Usage for Services
- Usage for BroadcastReceiver
- Usage of custom keys
- Optional annotation usage
- NonSavable annotation usage
- Activity startForResult usage
- Converters usage
- How does it really work?
To stay up-to-date with news about library
Example
With ActivityStarter, to pass arguments to Activity, Fragment, Service or BroadcastReceiver, all you need is @Arg annotation before parameters that needs to be passed:
public class MainActivity extends BaseActivity {
@Arg String name;
@Arg int id;
@Arg char grade;
@Arg boolean passing;
}
And ActivityStarter.fill(this, savedInstanceState); in BaseActivity:
class BaseActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
ActivityStarter.fill(this, savedInstanceState);
}
@Override // This is optional, only when we want to keep arguments changes in case of rotation etc.
protected void onSaveInstanceState(Bundle outState) {
super.onSaveInstanceState(outState);
ActivityStarter.save(this, outState);
}
}
Then, you can start Activity using generated starter:
MainActivityStarter.start(context, name, id, grade, passing);
Similar way, you can take Intent or start activity with flags:
MainActivityStarter.getIntent(context, name, id, grade, passing);
MainActivityStarter.startWithFlags(context, name, id, grade, passing, FLAG_ACTIVITY_SINGLE_TOP);
Arguments can be passed to Activities, Fragments, Services or BroadcastReceiver. Arguments can also be Optional.
Optional
You can make optional arguments:
public class MainActivity extends BaseActivity {
@Arg(optional = true) String name;
@Arg(optional = true) long id = -1;
}
Then additional generators with not all arguments will be created
MainActivityStarter.start(context);
MainActivityStarter.start(context, name);
MainActivityStarter.start(context, id);
MainActivityStarter.start(context, name, id);
Further reading here.
Kotlin
ActivityStarter is supporting Kotlin to allow properties that are not-null and both read-write or read-only:
class StudentDataActivity : BaseActivity() {
@get:Arg(optional = true) var name: String by argExtra(defaultName)
@get:Arg(optional = true) val id: Int by argExtra(defaultId)
@get:Arg var grade: Char by argExtra()
@get:Arg val passing: Boolean by argExtra()
}
Values are taken lazily and kept as fields, but there are still saved if ActivityStarter.save(this) is called inonSaveInstanceState. When all properties are provided by delegate, then there is no need to call ActivityStarter.fill(this, savedInstanceState) in onCreate.
Parceler
Since version 0.70, there is native support for Parceler library. To wrap and unwrap parameter using Parceler, use Arg annotation with parceler property set to true:
@Arg(parceler = true) StudentParcel studentParceler;
See example here.
Installation
For Java project add in build.gradle file:
dependencies {
compile 'com.marcinmoskala.activitystarter:activitystarter:1.10'
apt 'com.marcinmoskala.activitystarter:activitystarter-compiler:1.10'
}
For Kotlin project add in build.gradle file:
apply plugin: 'kotlin-kapt'
dependencies {
compile 'com.marcinmoskala.activitystarter:activitystarter:1.10'
kapt 'com.marcinmoskala.activitystarter:activitystarter-compiler:1.10'
}
If you want to use Kotlin-specific elements (property delegate argExtra), then add in build.gradle file:
apply plugin: 'kotlin-kapt'
dependencies {
compile 'com.marcinmoskala.activitystarter:activitystarter:1.10'
compile 'com.marcinmoskala.activitystarter:activitystarter-kotlin:1.10'
kapt 'com.marcinmoskala.activitystarter:activitystarter-compiler:1.10'
}
And while library is located on JitPack, remember to add on module build.gradle (unless you already have it):
repositories {
maven { url 'https://jitpack.io' }
}
More information on Installation page.
Other libraries
If you like it, remember to leave the star and check out my other libraries:
- PreferenceHolder - Library for simple SharedPreference management in Kotlin
- ArcSeekBar - Good looking curved Android SeekBar
- VideoPlayView - Custom Android view with video player, loader and placeholder image
- KotlinAndroidViewBindings - Bindings for properties with simple Kotlin types (Boolean, String) to layout traits (visibility, text).
License
Copyright 2017 Marcin Moskała
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
264 Dec 27, 2022
56 Sep 16, 2022
0 Oct 16, 2021
88 Nov 21, 2022
479 Dec 25, 2022
0 Apr 24, 2022
3 Jul 25, 2022
5 Dec 8, 2022
22 Oct 3, 2022
119 Dec 27, 2022
124 Nov 21, 2022
13 Oct 7, 2022
12 Apr 5, 2022
76 Oct 26, 2022
31 Jun 10, 2022
1 Dec 23, 2022