Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Arello-Mobile/Moxy
Moxy is MVP library for Android
https://github.com/Arello-Mobile/Moxy
android architecture moxy mvp mvp-architecture
Last synced: about 6 hours ago
JSON representation
Moxy is MVP library for Android
- Host: GitHub
- URL: https://github.com/Arello-Mobile/Moxy
- Owner: Arello-Mobile
- License: mit
- Created: 2016-02-12T08:35:25.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2020-10-15T15:00:53.000Z (about 4 years ago)
- Last Synced: 2024-01-23T20:11:46.406Z (10 months ago)
- Topics: android, architecture, moxy, mvp, mvp-architecture
- Language: Java
- Homepage: https://github.com/Arello-Mobile/Moxy/wiki
- Size: 1.06 MB
- Stars: 1,609
- Watchers: 68
- Forks: 210
- Open Issues: 51
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-android-ui - https://github.com/Arello-Mobile/Moxy
- awesome-android-ui - https://github.com/Arello-Mobile/Moxy
README
# Moxy
**
This Moxy repository is deprecated and no longer supported.
**
**Please migrate to the actual version of the Moxy framework at [Moxy communuty](https://github.com/moxy-community/Moxy) repo.**
## Description
[](http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.arello-mobile%22%20AND%20(a%3A%22moxy%22%20OR%20a%3A%22moxy-compiler%22%20OR%20a%3A%22moxy-android%22%20OR%20a%3A%22moxy-app-compat%22)) [](https://opensource.org/licenses/MIT)
Moxy is a library that helps to use MVP pattern when you do the Android Application. _Without problems of lifecycle and boilerplate code!_
The main idea of using Moxy:
See what's happening here in the [wiki](https://github.com/Arello-Mobile/Moxy/wiki).
## Capabilities
Moxy has a few killer features in other ways:
- _Presenter_ stay alive when _Activity_ recreated(it simplify work with multithreading)
- Automatically restore all that user see when _Activity_ recreated(including dynamic content is added)
- Capability to changes of many _Views_ from one _Presenter_
## Sample
View interface
```java
public interface HelloWorldView extends MvpView {
void showMessage(int message);
}
```
Presenter
```java
@InjectViewState
public class HelloWorldPresenter extends MvpPresenter {
public HelloWorldPresenter() {
getViewState().showMessage(R.string.hello_world);
}
}
```
View implementation
```java
public class HelloWorldActivity extends MvpAppCompatActivity implements HelloWorldView {
@InjectPresenter
HelloWorldPresenter mHelloWorldPresenter;
private TextView mHelloWorldTextView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_hello_world);
mHelloWorldTextView = ((TextView) findViewById(R.id.activity_hello_world_text_view_message));
}
@Override
public void showMessage(int message) {
mHelloWorldTextView.setText(message);
}
}
```
[Here](https://github.com/Arello-Mobile/Moxy/tree/master/sample-github) you can see "Github" sample application.
## Wiki
For all information check [Moxy Wiki](https://github.com/Arello-Mobile/Moxy/wiki)
## Android studio templates
In order to avoid boilerplate code creating for binding activity, fragments and its presentation part, we propose to use Android Studio templates for Moxy.
Templates located in [/moxy-templates](https://github.com/Arello-Mobile/Moxy/tree/master/moxy-templates)
## Links
[Telegram channel (en)](https://telegram.me/moxy_mvp_library)
[Telegram channel (ru)](https://telegram.me/moxy_ru)
[References](https://github.com/Arello-Mobile/Moxy/wiki#references)
[FAQ](https://github.com/Arello-Mobile/Moxy/wiki/FAQ)
## Integration
Base modules integration:
```groovy
dependencies {
...
compile 'com.arello-mobile:moxy:1.5.5'
annotationProcessor 'com.arello-mobile:moxy-compiler:1.5.5'
}
```
For additional base view classes `MvpActivity` and `MvpFragment` add this:
```groovy
dependencies {
...
compile 'com.arello-mobile:moxy-android:1.5.5'
}
```
If you are planning to use AppCompat, then you can use `MvpAppCompatActivity` and `MvpAppCompatFragment`. Then add this:
```groovy
dependencies {
...
compile 'com.arello-mobile:moxy-app-compat:1.5.5'
compile 'com.android.support:appcompat-v7:$support_version'
}
```
### AndroidX module integration
If you use AndroidX, use `MvpAppCompatActivity` and `MvpAppCompatFragment` add this (thanks to [@jordan1997](https://github.com/jordan1997)):
```groovy
implementation 'tech.schoolhelper:moxy-x-androidx:1.7.0'
```
### AndroidX(Google material) module integration
If you use google material, use `MvpBottomSheetDialogFragment` add this (thanks to [@jordan1997](https://github.com/jordan1997)):
```groovy
implementation 'tech.schoolhelper:moxy-x-material:1.7.0'
```
Note: [@jordan1997](https://github.com/jordan1997) creates [fork](https://github.com/schoolhelper/MoxyX) of Moxy — feel free to use it fully (instead of use only this module dependency) on your opinion.
### Kotlin
If you are using kotlin, use `kapt` instead of `provided`/`apt` dependency type:
```groovy
apply plugin: 'kotlin-kapt'
dependencies {
...
kapt 'com.arello-mobile:moxy-compiler:1.5.5'
}
```
## ProGuard
Moxy is completely without reflection! No special ProGuard rules required.
## License
```
The MIT License (MIT)
Copyright (c) 2016 Arello Mobile
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.
```