Previously, Aspose.Words for Android via Java was distributed as a single ZIP file which contained the JAR file, demos and documentation of Aspose.Words for Android via Java.
- If you want to use any version before Aspose.Words for Android via Java 1.11, you just need to unzip any version of Aspose.Words.Android.zip into a directory of your choice.
- 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 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 described here.
How to Use Aspose.Words for Android via Java from 1.11 Onward
Previously, a single JAR of Aspose.Words for Android via 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 Android via Java library. 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 Android via Java Library 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 Android via Java since 1.11
To include Aspose.Words for Android via Java into 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.
To initiate the load of .apk file in the onCreate() method and if you do not want to use android:name=”com.aspose.words.AsposeWordsApplication” in AndroidManifest.xml
Using Aspose.Words for Android via Java in Android Test Applications
To use Aspose.Words for Android via Java in test projects, the same approach can be applied:
Indicate AsposeWordsTestRunner in AndroidManifest.xml of the test project.
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.
How to Use Aspose.Words for Android via Java from 17.2.0 Onward
- Download the newest version of Aspose.Words for Android via Java
- Copy aspose-words-18.3-android.via.java.jar into your project’s libs/folder
Install Aspose.Words for Android via Java from Maven Repository
- Add maven repository into your build.gradle
- Add 'Aspose.Words for Android via Java' JAR as a dependency
Your First Application Using Aspose.Words for Android via Java
This article gives you an idea of getting started with Aspose.Words for Android via Java. It will demonstrate how to setup a new Android project from scratch, add a reference to the Aspose.Words JAR and create a new document which is saved to disk in DOCX format. This example uses Android Studio for development and the application is run on the Android Emulator. To get started with Aspose.Words for Android via Java, please follow this step-by-step tutorial to create an app which uses Aspose.Words for Android via Java:
- Download and the Android Studio and install to any location.
- Run the Android Studio.
- Create a new Android Application Project.
- Copy aspose-words-17.5-android.via.java.jar into your project’s libs/folder
- Select Project Section (from file menu and click on Dependencies tab.
- Click on "+" button, select file dependency option.
- Select Aspose.Words library from libs folder and click on OK.
- Sync the project with gradle files if needed
In order to access the SDcard special permissions must be added. Click on the AndroidManifest.xml file and choose XML view. Add the following line to the file <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
Navigate back to the code section of the app and add the following imports:
And then insert the following code in the body of the onCreate method to create a new document from scratch using Aspose.Words,
insert some text and save it to the SDCard in DOCX format.
The full code should look like this:
Now run the application again. This time the Aspose.Words code will run in the background and generate a document which is saved to the SDcard.
- To view the created document navigate to the Tools menu then choose Android and choose Android Device Monitor
- Use the default viewer to open the document. The output generated by the app with just a few lines of code looks like this:
Since 2017 the versioning of Aspose.Words for Android via Java complies with Aspose.Words for Java.