Aspose.Email for Android via Java Installation

System Requirements

Aspose.Email for Android via Java is platform independent and can be used on any platform where Android Runtime environment is installed and will run on Android systems running Android OS 2.0 or greater. At present, the component has been tested with:

  • Android 4.2 v 17

Install Aspose.Email for Android via Java from Maven Repository

  1. Add maven repository into your build.gradle
  2. Add ‘Aspose.Email for Android via Java’ JAR as a dependency

 // 1. Add maven repository into your build.gradle 

repositories {

    mavenCentral()

    maven { url "http://repository.aspose.com/repo/" }

}



// 2. Add 'Aspose.Email for Android via Java' JAR as a dependency

dependencies {

    ...

    ...

    compile (

		group: 'com.aspose', 

		name: 'aspose-email', 

		version: '18.4', 

		classifier: 'android.via.java'

	)

}

How to use Aspose.Emil for Android via Java

This topic will guide you through the necessary steps by setup Aspose.Email for Android via Java in Android Studio IDE, assuming that you already have the latest version of Android Studio installed on your machine and you have also acquired the latest version of Aspose.Email for Android via Java package.

Getting Started with Aspose.Email for Android via Java in Android Studio

Once the Android Studio IDE loads, click on File > New > New Project as shown below.

todo:image_alt_text

You can also create a new project from the Android Studio’s Welcome Screen as shown below.

todo:image_alt_text

Next, you will be prompt to specify the application name, domain & location to store the project files. You can choose to change the default values as per your your choice or let them as they are, and click Next.

todo:image_alt_text

In next step, you have to specify the Android Device you wish to host/run your application. Once selected, click on Next button.

todo:image_alt_text

Now you need to select the Activity from a predefined list of templates. In order to keep the demonstration simple, we have selected the Empty Activity template as shown below.

todo:image_alt_text

Click on Finish button on the Customize the Activity dialog as we will keep all the default settings as they are.

todo:image_alt_text

As soon as you click on the Finish button on the previous step, the IDE will start building the project as shown below. Let it finish or click Cancel button.

todo:image_alt_text

Now the project has been loaded in the IDE, however, you may wish to change the view to Project so that you can view the complete hierarchy of the project files. In order to change the view, please check the following snapshot.

todo:image_alt_text

After changing the view to Project, find & load the build.gradle file in the editor and paste the following snippet as shown below.


 dexOptions{

    javaMaxHeapSize "4g"

}

todo:image_alt_text

Next, we will add the Aspose.Email for Android via Java Jar to the project. There are 2 important steps as detailed below.

  • Manually copy the Aspose.Email for Android via Java Jar to the \app\libs folder.
  • Add Aspose.Email for Android via Java Jar as Library to the module as shown below.

todo:image_alt_text

You will be prompt to select the module to which you wish to add the Aspose.Email for Java.Android Jar as library. Please choose appropriately and click OK.

todo:image_alt_text

You also need to add the APK file to the project. You have to copy the APK to the \app\src\main\assets folder. If you do not have the assets folder under the main folder, you can create one by right clicking the main node in the Project view. Select New > Folder > Asset Folder.

todo:image_alt_text

Once the APK has been added to the project, it needs to be loaded by the project. There are 2 ways to load the APK as follow.

  • Load the APK in a custom application class using the snippet provided below, and register the custom application class to the AndroidManifest.xml.

 LibsLoadHelper.loadLibs(this);

  • Load the APK in the OnCreate method of MainActivity.

 LibsLoadHelper.loadLibs(getApplicationContext());

Now we are ready to write the code. In order to keep the demonstration easy to understand, we have added a Button widget to the layout and going to handle its click event as follow.


 private class TestEmail extends AsyncTask<Void, String, Boolean> 

{



    @Override

    protected Boolean doInBackground(Void... params) 

    {

        Boolean result = false;

        try 

        {

            //Create an instance of PersonalStorage

            com.aspose.email.PersonalStorage pst = com.aspose.email.PersonalStorage.create("newSample_out.pst", 0);

            //Create a folder at root of PST

            pst.getRootFolder().addSubFolder("myInbox");

            //Add message to newly created folder

            pst.getRootFolder().getSubFolder("myInbox").addMessage(com.aspose.email.MapiMessage.fromFile("message.msg"));

        } 

        catch (Exception e) 

        {

            e.printStackTrace();

        }

        return result;

    }

}

When you run the application using the play button on IDE interface (or using SHIFT + F10) the emulator will load the application as shown below.

todo:image_alt_text

Clicking the button on the emulator will execute the code.