{"id":3449,"url":"https://github.com/MarcinMoskala/ActivityStarter","last_synced_at":"2025-08-03T14:31:24.130Z","repository":{"id":83821348,"uuid":"80822585","full_name":"MarcinMoskala/ActivityStarter","owner":"MarcinMoskala","description":"Simple Android Library, that provides easy way to start the Activities with arguments.","archived":false,"fork":false,"pushed_at":"2019-01-11T11:21:22.000Z","size":697,"stargazers_count":431,"open_issues_count":5,"forks_count":31,"subscribers_count":15,"default_branch":"master","last_synced_at":"2024-11-24T16:22:38.853Z","etag":null,"topics":["activity","android","android-library","kotlin","kotlin-android"],"latest_commit_sha":null,"homepage":"http://marcinmoskala.com/ActivityStarter/","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MarcinMoskala.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-02-03T11:16:56.000Z","updated_at":"2024-09-03T06:26:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"88aa2f9e-38dd-4330-ba1f-651384b22609","html_url":"https://github.com/MarcinMoskala/ActivityStarter","commit_stats":null,"previous_names":[],"tags_count":36,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MarcinMoskala%2FActivityStarter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MarcinMoskala%2FActivityStarter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MarcinMoskala%2FActivityStarter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MarcinMoskala%2FActivityStarter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MarcinMoskala","download_url":"https://codeload.github.com/MarcinMoskala/ActivityStarter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228548568,"owners_count":17935221,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["activity","android","android-library","kotlin","kotlin-android"],"created_at":"2024-01-05T20:16:41.845Z","updated_at":"2024-12-07T01:31:23.158Z","avatar_url":"https://github.com/MarcinMoskala.png","language":"Kotlin","funding_links":[],"categories":["Libraries","Annotation","开源库","Kotlin","\u003ca name=\"android\"\u003e\u003c/a\u003eAndroid \u003csup\u003e[Back ⇈](#android-category)\u003c/sup\u003e","\u003ca name=\"dependency-injection\"\u003e\u003c/a\u003eDependency Injection \u003csup\u003e[Back ⇈](#contents)\u003c/sup\u003e"],"sub_categories":["Android","依赖注入","Dependency Injection","\u003ca name=\"android-libraries\"\u003e\u003c/a\u003eLibraries \u003csup\u003e[Back ⇈](#android-libraries-subcategory)\u003c/sup\u003e"],"readme":"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.\r\n\r\n# ActivityStarter\r\nAndroid Library that provides simpler way to start the Activities with multiple arguments.\r\n\r\n[![](https://jitpack.io/v/MarcinMoskala/ActivityStarter.svg)](https://jitpack.io/#MarcinMoskala/ActivityStarter)\r\n[![codebeat badge](https://codebeat.co/badges/a1727670-96fe-4c89-9bdb-f1818a6dc066)](https://codebeat.co/projects/github-com-marcinmoskala-activitystarter)\r\n[![Build Status](https://travis-ci.org/MarcinMoskala/ActivityStarter.svg?branch=master)](https://travis-ci.org/MarcinMoskala/ActivityStarter)\r\n[![Stories in Ready](https://badge.waffle.io/MarcinMoskala/ActivityStarter.svg?label=ready\u0026title=Ready)](http://waffle.io/MarcinMoskala/ActivityStarter)\r\n[![Join the chat at https://gitter.im/ActivityStarter/Lobby](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/ActivityStarter/Lobby)\r\n[![Analytics](https://ga-beacon.appspot.com/UA-92159206-2/main-page?pixel)](https://github.com/MarcinMoskala/ActivityStarter)\r\n[![Analytics](https://ga-beacon.appspot.com/UA-92159206-7/main-page?pixel)](https://github.com/MarcinMoskala/ActivityStarter)\r\n\r\nLibrary bindes fields to Actity, Fragment, Service or Receiver arguments and generates simple starters. Thanks to that you can: \r\n * Eliminate all putExtra and getXXXExtra methods\r\n * Forget about all keys that were used to pass arguments (unless you want to define custom onces)\r\n * Start liking starting flags and intent creation\r\n \r\nMedia:\r\n* [Way to ActivityStarter](https://medium.com/@marcinmoskala/way-to-activitystarter-5f9ea239faa8)\r\n\r\nFull documentation is located [here](https://github.com/MarcinMoskala/ActivityStarter/wiki). Here is TOC:\r\n* [Introdution](https://github.com/MarcinMoskala/ActivityStarter/wiki/Introdution)\r\n* [Installation](https://github.com/MarcinMoskala/ActivityStarter/wiki/Installation)\r\n* [Usage for Activities](https://github.com/MarcinMoskala/ActivityStarter/wiki/Usage-for-Activities)\r\n* [Usage for Fragments](https://github.com/MarcinMoskala/ActivityStarter/wiki/Usage-for-Fragments)\r\n* [Usage for Services](https://github.com/MarcinMoskala/ActivityStarter/wiki/Usage-for-Services)\r\n* [Usage for BroadcastReceiver](https://github.com/MarcinMoskala/ActivityStarter/wiki/Usage-for-BroadcastReceiver)\r\n* [Usage of custom keys](https://github.com/MarcinMoskala/ActivityStarter/wiki/Usage-of-custom-keys)\r\n* [Optional annotation usage](https://github.com/MarcinMoskala/ActivityStarter/wiki/Optional-annotation)\r\n* [NonSavable annotation usage](https://github.com/MarcinMoskala/ActivityStarter/wiki/NonSavable-annotation)\r\n* [Activity startForResult usage](https://github.com/MarcinMoskala/ActivityStarter/wiki/Start-Activity-for-result)\r\n* [Converters usage](https://github.com/MarcinMoskala/ActivityStarter/wiki/Converters-usage)\r\n* [How does it really work?](https://github.com/MarcinMoskala/ActivityStarter/wiki/How-does-it-really-work?)\r\n\r\nTo stay up-to-date with news about library [![Twitter URL](https://img.shields.io/twitter/url/https/twitter.com/fold_left.svg?style=social\u0026label=Follow%20%40marcinmoskala)](https://twitter.com/marcinmoskala?ref_src=twsrc%5Etfw)\r\n\r\n# Example\r\n\r\nWith ActivityStarter, to pass arguments to Activity, Fragment, Service or BroadcastReceiver, all you need is `@Arg` annotation before parameters that needs to be passed:\r\n\r\n```java\r\npublic class MainActivity extends BaseActivity {\r\n\r\n    @Arg String name;\r\n    @Arg int id;\r\n    @Arg char grade;\r\n    @Arg boolean passing;\r\n}\r\n```\r\n\r\nAnd `ActivityStarter.fill(this, savedInstanceState);` in BaseActivity:\r\n\r\n```java\r\nclass BaseActivity extends AppCompatActivity {\r\n\r\n    @Override\r\n    protected void onCreate(Bundle savedInstanceState) {\r\n        super.onCreate(savedInstanceState);\r\n        setContentView(R.layout.activity_main);\r\n        ActivityStarter.fill(this, savedInstanceState);\r\n    }\r\n\r\n    @Override // This is optional, only when we want to keep arguments changes in case of rotation etc.\r\n    protected void onSaveInstanceState(Bundle outState) {\r\n        super.onSaveInstanceState(outState);\r\n        ActivityStarter.save(this, outState);\r\n    }\r\n}\r\n```\r\n\r\nThen, you can start Activity using generated starter:\r\n\r\n```java\r\nMainActivityStarter.start(context, name, id, grade, passing);\r\n```\r\n\r\nSimilar way, you can take Intent or start activity with flags:\r\n\r\n```java\r\nMainActivityStarter.getIntent(context, name, id, grade, passing);\r\nMainActivityStarter.startWithFlags(context, name, id, grade, passing, FLAG_ACTIVITY_SINGLE_TOP);\r\n```\r\n\r\nArguments can be passed to [Activities](https://github.com/MarcinMoskala/ActivityStarter/wiki/Usage-for-Activities), [Fragments](https://github.com/MarcinMoskala/ActivityStarter/wiki/Usage-for-Fragments), [Services](https://github.com/MarcinMoskala/ActivityStarter/wiki/Usage-for-Services)\r\nor [BroadcastReceiver](https://github.com/MarcinMoskala/ActivityStarter/wiki/Usage-for-BroadcastReceiver). Arguments can also be [Optional](https://github.com/MarcinMoskala/ActivityStarter/wiki/Optional-annotation). \r\n\r\n## Optional\r\n\r\nYou can make optional arguments:\r\n\r\n```java\r\npublic class MainActivity extends BaseActivity {\r\n\r\n    @Arg(optional = true) String name;\r\n    @Arg(optional = true) long id = -1;\r\n}\r\n```\r\n\r\nThen additional generators with not all arguments will be created\r\n\r\n```java\r\nMainActivityStarter.start(context);\r\nMainActivityStarter.start(context, name);\r\nMainActivityStarter.start(context, id);\r\nMainActivityStarter.start(context, name, id);\r\n```\r\n\r\nFurther reading [here](https://github.com/MarcinMoskala/ActivityStarter/wiki/Optional-argument).\r\n\r\n## Kotlin\r\n\r\nActivityStarter is supporting Kotlin to allow properties that are not-null and both read-write or read-only:\r\n\r\n```kotlin\r\nclass StudentDataActivity : BaseActivity() {\r\n\r\n    @get:Arg(optional = true) var name: String by argExtra(defaultName)\r\n    @get:Arg(optional = true) val id: Int by argExtra(defaultId)\r\n    @get:Arg var grade: Char  by argExtra()\r\n    @get:Arg val passing: Boolean by argExtra()\r\n}\r\n```\r\n\r\nValues are taken lazily and kept as fields, but there are still saved if `ActivityStarter.save(this)` is called in`onSaveInstanceState`. When all properties are provided by delegate, then there is no need to call `ActivityStarter.fill(this, savedInstanceState)` in `onCreate`.\r\n\r\n## Parceler\r\n\r\nSince version 0.70, there is native support for [Parceler library](https://github.com/johncarl81/parceler). To wrap and unwrap parameter using Parceler, use `Arg` annotation with `parceler` property set to `true`:\r\n\r\n```\r\n@Arg(parceler = true) StudentParcel studentParceler;\r\n```\r\n\r\nSee example [here](https://github.com/MarcinMoskala/ActivityStarter/blob/master/sample/app/src/main/java/com/example/activitystarter/parceler/StudentParcelerActivity.java).\r\n\r\n## Installation\r\n\r\nFor Java project add in `build.gradle` file:\r\n\r\n```groovy\r\ndependencies {\r\n    compile 'com.marcinmoskala.activitystarter:activitystarter:1.10'\r\n    apt 'com.marcinmoskala.activitystarter:activitystarter-compiler:1.10'\r\n}\r\n```\r\n\r\nFor Kotlin project add in `build.gradle` file:\r\n\r\n```groovy\r\napply plugin: 'kotlin-kapt'\r\n\r\ndependencies {\r\n    compile 'com.marcinmoskala.activitystarter:activitystarter:1.10'\r\n    kapt 'com.marcinmoskala.activitystarter:activitystarter-compiler:1.10'\r\n}\r\n```\r\n\r\nIf you want to use Kotlin-specific elements (property delegate `argExtra`), then add in `build.gradle` file:\r\n\r\n```groovy\r\napply plugin: 'kotlin-kapt'\r\n\r\ndependencies {\r\n    compile 'com.marcinmoskala.activitystarter:activitystarter:1.10'\r\n    compile 'com.marcinmoskala.activitystarter:activitystarter-kotlin:1.10'\r\n    kapt 'com.marcinmoskala.activitystarter:activitystarter-compiler:1.10'\r\n}\r\n```\r\n\r\nAnd while library is located on JitPack, remember to add on module build.gradle (unless you already have it):\r\n\r\n```groovy\r\nrepositories {\r\n    maven { url 'https://jitpack.io' }\r\n}\r\n```\r\n\r\nMore information on [Installation](https://github.com/MarcinMoskala/ActivityStarter/wiki/Installation) page.\r\n\r\n## Other libraries\r\n\r\nIf you like it, remember to leave the star and check out my other libraries:\r\n * [PreferenceHolder](https://github.com/MarcinMoskala/PreferenceHolder) - Library for simple SharedPreference management in Kotlin\r\n * [ArcSeekBar](https://github.com/MarcinMoskala/ArcSeekBar) - Good looking curved Android SeekBar\r\n * [VideoPlayView](https://github.com/MarcinMoskala/VideoPlayView) - Custom Android view with video player, loader and placeholder image\r\n * [KotlinAndroidViewBindings](https://github.com/MarcinMoskala/KotlinAndroidViewBindings) - Bindings for properties with simple Kotlin types (Boolean, String) to layout traits (visibility, text).\r\n\r\nLicense\r\n-------\r\n\r\n    Copyright 2017 Marcin Moskała\r\n\r\n    Licensed under the Apache License, Version 2.0 (the \"License\");\r\n    you may not use this file except in compliance with the License.\r\n    You may obtain a copy of the License at\r\n\r\n       http://www.apache.org/licenses/LICENSE-2.0\r\n\r\n    Unless required by applicable law or agreed to in writing, software\r\n    distributed under the License is distributed on an \"AS IS\" BASIS,\r\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r\n    See the License for the specific language governing permissions and\r\n    limitations under the License.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMarcinMoskala%2FActivityStarter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMarcinMoskala%2FActivityStarter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMarcinMoskala%2FActivityStarter/lists"}