Install Aspose.Words for Android via Java

Since 2017 the versioning of Aspose.Words for Android via Java complies with Aspose.Words for Java.

aspose-words-20.2-android.via.java.jar

Installation

Previously, Aspose.Words for Android via Javawas distributed as a single ZIP file that contained the JAR file, demos, and documentation of Aspose.Words for Androidvia Java.

1. If you want to use any version before Aspose.Words for Androidvia Java1.11, you just need to unzip any version of Aspose.Words.Android.zip into a directory of your choice.
2. Include the extracted Jar file in your application using the Build Path configuration for its application.

Versions 1.11 and 1.12 were manually divided into two parts: JAR and APK in order to limit the number of methods in the DEX file.In these versions, we provided our own APK loader to initiate the correct loading of the additional classes.dex file. Starting from version 17.2.0 we support the official workflow describedhere.

How to Use Aspose.Words for Androidvia Java from 1.11 Onward

Previously, a single JAR of Aspose.Words for Androidvia Java contained 47+ thousand methods which made older versions a little impractical to use in huge android applications. Now starting from this release, we have started to reduce the size of Aspose.Words for Androidvia Javalibrary. Our major concern now is to reduce the number of methods without loss of functionality. We are constantly working on improving the quality and usability of Aspose.Words for Android via Java.

Aspose.Words for Androidvia JavaLibrary Divided into Two Parts

We had divided the library into following two archives:

• aspose-words-1.11-android-jdk15.jar:The first one includes public API and its auxiliary methods. Currently, it has 32395 methods.
• aspose-words-1.11-libs-android-jdk15.apk:The second one includes 3rd party jars, basic classes, and resources. Currently, it has 18296 methods.

Using Aspose Words for Androidvia Javasince 1.11

To include Aspose.Words for Androidvia Javainto the project you can use any of the following methods:

• To place “aspose-words-1.11-android-jdk15.jar” in the folder “libs” of your project, and the archive “aspose-words-1.11-libs-android-jdk15.apk” into the folder “assets”. Indicate that you are going to use AsposeWordsApplication as the basic one.

AndroidManifest.xml

...
...
<application        
    android:allowBackup="true"
    android:icon="@drawable/ic_launcher"
    android:name="com.aspose.words.AsposeWordsApplication"
    android:label="@string/app_name"
    android:theme="@style/AppTheme" >
    <activity
...
...

To initiate a load of .apk file in the onCreate() method and if you do not want to useandroid:name=”com.aspose.words.AsposeWordsApplication”in AndroidManifest.xml

Activity Java file

@Override
protected void onCreate(Bundle savedInstanceState) 
{
    super.onCreate(savedInstanceState);

    // load AW manually
    AsposeWordsApplication awapp = new AsposeWordsApplication();
    
    // this context AW uses to find assets/ folder which contains the second part of the library.
    awapp.loadLibs(getApplicationContext()); 
    if (!checkIfAWSetUpCorrectly())
            throw new IllegalStateException();	
    ...
}
public static boolean checkIfAWSetUpCorrectly()
{
    try
    {
        Class.forName("com.aspose.words.Document");
        return true;
    }
    catch (ClassNotFoundException e)
    {
        e.printStackTrace();
        return false;
    }
}

Using Aspose.Words for Androidvia Javain Android Test Applications

To use Aspose.Words for Androidvia Javain test projects, the same approach can be applied:

• Indicate AsposeWordsTestRunner in AndroidManifest.xml of the test project.

AndroidManifest.xml

...
...
<instrumentation
    android:name="com.aspose.words.AsposeWordsTestRunner"    
    android:targetPackage="com.aspose.releaseapp" />
...
...

In IDE it might be necessary to indicate AsposeWordsTestRunner in the configuration window as follows:

• Or to initiate the load of .apk using the getTargetContext() method.

@Override
public void onStart() {
    new AsposeWordsApplication().loadLibs(getTargetContext());
 // <-- Pass getTargetContext() because aspose-words-1.11-libs-android-jdk15.apk is in the main application's asset folder
    super.onStart();
}

How to Use Aspose.Words for Androidvia Javafrom 17.2.0 Onward

1. Download the newest version ofAspose.Wordsfor Android via Java
2. Copyaspose-words-18.3-android.via.java.jar into your project’s*libs/*folder

Install Aspose.Words for Android via Java from Maven Repository

1. Add maven repository into yourbuild.gradle
2. Add ‘Aspose.Words for Android via Java’ JAR as a dependency

   // 1. Add maven repository into your build.gradle 
   repositories {
       mavenCentral()
       maven { url "https://repository.aspose.com/words/" }
   }
   
   // 2. Add 'Aspose.Words for Android via Java' JAR as a dependency
   dependencies {
       ...
       ...
       compile (group: 'com.aspose', name: 'aspose-words', version: '20.2', classifier: 'android.via.java')
   }