Seedroid Application

Seedroid Application is a framework for working together with one design pattern for transfer knowledge, handling bugs, take over project, and reusable function

Getting Started

Must known MVP or MVVM pattern
Android data binding

Installing to Project

Add and configure your gradle project :

add dependencies realm and google services

dependencies {
    ...
    classpath 'com.google.gms:google-services:3.0.0'
    classpath "io.realm:realm-gradle-plugin:3.0.0"
    ...
}

add maven repository

allprojects {
repositories {
    jcenter()
    maven { url 'https://jitpack.io' }
}
}

Add and configure your gradle application :

setting minimum SDK API 15 and setting multidex enable true

defaultConfig {
    ..
    minSdkVersion 15
    multiDexEnabled true
    ..
}

enable data binding and packaging option

android {
...
dataBinding {
        enabled = true
    }
packagingOptions {
        pickFirst 'META-INF/LICENSE'
    }
...
}

add dependencies seedroid application and apply plugin google services under gradle application

dependencies {
...
compile 'com.github.codigo-cyberlin-metadata:seedroid:v0.0.1-SNAP'
...
}
apply plugin: 'com.google.gms.google-services'

Configure new project :

Make sure your application class extend SeedroidApplication

public class ProjectApplication extends SeedroidApplication {
---
}

Create resource style that extending from BaseTheme style.

<resources>
<style name="AppTheme" parent="BaseTheme">
    ---
</style>
</resources>

Configure your manifest file

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
package="YOUR_PACKAGE">
<application
    ---
    android:name=".ProjectApplication"
    android:theme="@style/AppTheme"
    tools:replace="android:name,android:theme">
</application>
</manifest>

Implementation

After installing and build gradle success, now we can implement framework into a new project.

Create SampleModel on pivate mode

public class SampleModel {
--- Setter and Getter
}

Create your view interface that extending from BaseView interface.

public interface SampleView extends BaseView {
void sampleMethod1(SampleModel obj);
void sampleMethod2(String message);
}

Create your presenter class that extending from BasePresenter class and implement onStartUI() method.

public class SamplePresenter extends BasePresenter<SampleView> {
@Override
public void onStartUI() {
    ---
}
}

Create layout use data binding

<?xml version="1.0" encoding="utf-8"?>
<layout>

<data>
    <variable
        name="presenter"
        type="YOUR_PACKAGE.SamplePresenter" />
    <variable
        name="model"
        type="YOUR_PACKAGE.SampleModel" />
</data>

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">
    ---
</LinearLayout>
</layout>

Create BaseActivity and get view binding

public class SampleActivity extends BaseActivity<SampleBinding, SampleView, SamplePresenter> implements SampleView {
    @Override
    public int attachLayout() { return R.layout.sample; }

    @Override
    public SamplePresenter createPresenter() { return new SamplePresenter(); }

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        getViewBinding().setPresenter(getMvpPresenter());
    }

    @Override
    public void sampleMethod1(SampleModel obj) { getViewBinding().setModel(obj); }

    @Override
    public void sampleMethod2(String message) { --- }

---
}

Create BaseRecyclerActivity

public class SampleListFragment extends BaseRecyclerActivity<SampleModel, SampleRecyclerFragmentView, SampleRecyclerPresenter>
    implements SampleRecyclerFragmentView {
@Override
public SampleRecyclerPresenter createPresenter() { return new SampleRecyclerPresenter();  }

@Override
public BaseRecyclerAdapter onInitAdapter() {
   return  SampleRecylerAdapter(customListView.getItems());
}

@Override
public void onLoadItems(int limit, int offset) { … }
}

Create BaseRecyclerFragment

public class SampleListFragment extends BaseRecyclerFragment<SampleModel, SampleRecyclerFragmentView, SampleRecyclerPresenter>
    implements SampleRecyclerFragmentView {
@Override
public SampleRecyclerPresenter createPresenter() { return new SampleRecyclerPresenter();  }

@Override
public BaseRecyclerAdapter onInitAdapter() {
   return  SampleRecylerAdapter(customListView.getItems());
}

@Override
public void onLoadItems(int limit, int offset) { … }
}

Versioning

Version 0.0.8-SNAP for framework is available (framework)

compile 'com.github.codigo-cyberlin-metadata.seedroid:framework:v0.0.8-SNAP'

Version 0.0.8-SNAP for validator is available (seedroid-validator)

compile 'com.github.codigo-cyberlin-metadata.seedroid:seedroid-validator:v0.0.8-SNAP'

Version 0.0.8-SNAP for image picker is available (seedroid-picker)

compile 'com.github.codigo-cyberlin-metadata.seedroid:seedroid-picker:v0.0.8-SNAP'

Authors

codigo-cyberlin-metadata
codigo-android-developer-team

Tips And Guide

google-service.json

if you find issue google-service.json not found you can add inside main folder your project by copy or download from there:

[google-services.json](https://github.com/codigo-cyberlin-metadata/seedroid/blob/master/framework/google-services.json)

dont forget to change package name inside client array on your copy of google-service.json

  ....
  "client": [
    {
      "client_info": {
        "mobilesdk_app_id": "",
        "android_client_info": {
          "package_name": "YOUR_PACKAGE"
        }
      },
      "oauth_client": [
        {
          "client_id": "",
          "client_type": 1,
          "android_info": {
            "package_name": "YOUR_PACKAGE",
            "certificate_hash": "91032F56C31F349C83BDEA0BE379D1DA9BF94811"
          }
        },
        {
          "client_id": "",
          "client_type": 3
        }
      ],
      "api_key": [
        {
          "current_key": ""
        }
      ],
      "services": {
        "analytics_service": {
          "status": 1
        },
        "appinvite_service": {
          "status": 2,
          "other_platform_oauth_client": []
        },
        "ads_service": {
          "status": 2
        }
      }
    }
  ],
  ....

and if you use 2 build variant u can add 2 client inside array client with different package name

Acknowledgments

This framework inspired from there:

com.google.firebase:firebase-core
com.google.gms.google-services
com.android.volley:volley
net.gotev:uploadservice
com.fasterxml.jackson.core:jackson-annotations
com.fasterxml.jackson.core:jackson-databind
com.github.bumptech.glide:glide
jp.wasabeef:glide-transformations
jp.co.cyberagent.android.gpuimage:gpuimage-library
com.github.Ilhasoft:data-binding-validator

codigo-cyberlin-metadata / seedroid

readme