In this piece we want to look at how several intent operations can be done using a library known as Omega Intent Builder. These are common operations that we need in almost all the apps we create. Omega IntentBuilder abstracts these operations allowing us to perform them using only a minimal amount of code.

Installation

The first step is to install Omega Intent. It’s hosted in jitpack so we have to register jitpack as a repository in our project-level build.gradle file.

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

This library should be installed depending on the language you plan to use.

For Java:

dependencies {
    implementation 'com.github.Omega-R.OmegaIntentBuilder:core:1.1.4'
    // For extras
    implementation 'com.github.Omega-R.OmegaIntentBuilder:annotations:1.1.4'
    annotationProcessor 'com.github.Omega-R.OmegaIntentBuilder:processor:1.1.4'
    
    // AndroidX
    implementation 'com.github.Omega-R.OmegaIntentBuilder:core:1.1.6'
    // For extras
    implementation 'com.github.Omega-R.OmegaIntentBuilder:annotations:1.1.6'
    annotationProcessor 'com.github.Omega-R.OmegaIntentBuilder:processor:1.1.6'
}

For Kotlin:

For Kotlin rather than the annotation processor you use kapt:

apply plugin: 'com.android.application'
apply plugin: 'kotlin-android'
apply plugin: 'kotlin-kapt'

kapt {
    generateStubs = true
}

android {
    ......
}    
    
dependencies {
    implementation 'com.github.Omega-R.OmegaIntentBuilder:core:1.1.4'
    // For extras
    implementation 'com.github.Omega-R.OmegaIntentBuilder:annotations:1.1.4'
    kapt 'com.github.Omega-R.OmegaIntentBuilder:processor:1.1.4'
    
    // AndroidX
    implementation 'com.github.Omega-R.OmegaIntentBuilder:core:1.1.5'
    // For extras
    implementation 'com.github.Omega-R.OmegaIntentBuilder:annotations:1.1.5'
    kapt 'com.github.Omega-R.OmegaIntentBuilder:processor:1.1.5'
}

Lets proceed.

1.Activity

(a). How to Open Another Activity

To open an activity without passing any data:

OmegaIntentBuilder.from(this)
                .activity(PhotoCaptureActivity.class)
                .startActivity();

(b). How to Pass Data to an activity

To pass some extras:

OmegaIntentBuilder.from(this)
                .activity(PhotoCaptureActivity.class)
                .putExtra("Your_key", Integer.MAX_VALUE)
                .putExtra("Your_key2", Integer.MIN_VALUE)
                .startActivity();

To catch an exception while passing data:

       OmegaIntentBuilder.from(this)
                .activity(PhotoCaptureActivity.class)
                .putExtra("Your_key", Integer.MAX_VALUE)
                .putExtra("Your_key2", Integer.MIN_VALUE)
                .createIntentHandler()
                .failCallback(new FailCallback() {
                    @Override
                    public void onActivityStartError(@NotNull Exception exc) {
                        // you can handle error here
                    }
                })
                .failToast("Error")
                .startActivity();

(d). Activity Extras

Simple way to create and put data from one activity to another activity.

• @OmegaActivity – annotation for activity.
• @OmegaExtraModel – annotation for classes, which will be putted to bundle.
• @OmegaExtra – annotation for fields, which will be putted to bundle.

@OmegaExtraModel and @OmegaExtra support prefix for generated method name.
If you wan’t annotate your class with @OmegaExtra – this class should be implements Serializable

First step – annotate your activity with @OmegaActivity

Second step – annotate fields with @OmegaExtraModel or @OmegaExtra

@OmegaActivity
public class ShareFilesActivity extends Activity {

    @OmegaExtra
    protected String url1;

    @OmegaExtraModel(prefix = "model")
    Model model = new Model();

    @OmegaExtra()
    Model modelTwo;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_share_files);
        AppOmegaIntentBuilder.inject(this);
    }
}

Third step – don’t forget write AppOmegaIntentBuilder.inject(this); in onCreate method.

Model class

public class Model implements Serializable {
    @OmegaExtra("Var2")
    String url;

    public String getUrl() {
        return url;
    }
}

Fourth step – fill out your data and start activity.

public class MainActivity extends Acitity {

AppOmegaIntentBuilder.from(context)
                .appActivities()
                .shareFilesActivity()
                .url1("https://developer.android.com/studio/images/hero_image_studio.png")
                .modelVar2("https://avatars1.githubusercontent.com/u/28600571?s=200&v=4")
                .startActivity();

}

Also you cant use @OmegaActivity just for start activity.

AppOmegaIntentBuilder.from(this)
                .appActivities()
                .shareFilesActivity()
                .startActivity();

(d). Fragment Extras Builder

Simple way to create and put data to fragment.

• @OmegaFragment – annotation for fragments.
• @OmegaExtraModel – annotation for classes, which will be putted to bundle.
• @OmegaExtra – annotation for fields, which will be putted to bundle.

@OmegaExtraModel and @OmegaExtra support prefix for generated method name.
If you wan’t annotate your class with @OmegaExtra – this class should be implements Serializable

First step – annotate your fragment with @OmegaFragment

Second step – annotate fields with @OmegaExtraModel or @OmegaExtra

@OmegaFragment
public class FirstFragment extends BaseFragment {

    @OmegaExtra
    String value;
    
    @OmegaExtraModel
    Model model;

    public FirstFragment() {
    }

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        AppOmegaFragmentBuilder.inject(this);
    }

Third step – don’t forget write AppOmegaFragmentBuilder.inject(this) in onCreate method.

Model class

public class Model implements Serializable {
    @OmegaExtra("Var2")
    String url;

    public String getUrl() {
        return url;
    }
}

Fourth step – fill out your data.

AppOmegaFragmentBuilder.secondFragment()
                       .value("Second fragment")
                       .createFragment();