Android migration guide: from 0.9.7 to 0.9.1062

This guide will help developers who have existing apps upgrade from the Creative SDK version 0.9.7 to version 0.9.1062. This guide provides checklists (✔) along with links to guides that provide details for each step.

Only the components listed below require migration steps to upgrade to this version of the Creative SDK.

Contents

• Gradle setup
• Image Editor migration
• Send To Desktop API migration

✔ Checklist for your Gradle setup ✔

See the Getting Started guide’s New Project section for details.

1. In your Project build.gradle file, update the Gradle Retrolambda Plugin

   See comment #1 in the code below:

   buildscript {
       // ...
   
       dependencies {
       	// ...
   
           /* 1) Update from beta3 to beta 4 */
           classpath 'me.tatarka:gradle-retrolambda:3.3.0-beta4'
       }
   }
   
   // ...

2. In your Module build.gradle file, update version numbers for all Creative SDK dependencies

   See the Framework Dependencies guide for details on the latest version numbers.

✔ Checklist for Image Editor integrations ✔

See the Image Editor guide for details on all checklist items.

1. In your Project build.gradle file, add the Localytics repo in the repositories object:

   // ...
   
   allprojects {
       repositories {
           // ...
   
           maven {
               url 'http://maven.localytics.com/public'
           }
       }
   }
   
   // ...

2. Update your Module build.gradle file

   See comments #1–2 in the code below:

   android {
       compileSdkVersion 23
       buildToolsVersion "23.0.3"
   
       defaultConfig {
           applicationId "com.adobe.imageeditorui"
           minSdkVersion 16 // Minimum is 16
           targetSdkVersion 23
           versionCode 1
           versionName "1.0"
   
           /* 1) Add the manifest placeholder */
           manifestPlaceholders = [appPackageName: "${applicationId}"]
       }
       
       // ...
   }
   
   dependencies {
   	// ...
   
       compile 'com.adobe.creativesdk.foundation:auth:0.9.1062
       compile "com.adobe.creativesdk:image:4.6.3"
   
       /* 2) Add the Localytics dependency */
       compile "com.localytics.android:library:3.8.0"
   }

3. Remove the CDS provider from `AndroidManifest.xml

   Remove this provider:

       <provider
           android:name="com.adobe.creativesdk.aviary.internal.cds.CdsProvider"
           android:authorities="${applicationId}.CdsProvider"
           android:exported="false" />

   The SDK now handles this for you.

4. Update the Application subclass

   Change the interface from IAviaryClientCredentials to IAdobeAuthClientCredentials:

   public class MainApplication extends Application implements IAdobeAuthClientCredentials {

   Note that this means you will need to remove the getBillingKey() method from the Application subclass.

   If you are using the getBillingKey() method, also implement the IGoogleClientBilling interface.

5. Update your Activity’s onActivityResult() method

   To get the edited image, change data.getData() to data.getParcelableExtra():

   Uri editedImageUri = data.getParcelableExtra(AdobeImageIntent.EXTRA_OUTPUT_URI);

✔ Checklist for Send To Desktop API integrations ✔

See the Send To Desktop API guide for details.

The various AdobeSendToDesktopApplication methods have been deprecated and streamlined into a single sendToDesktop() overloaded method.

The sendToDesktop() method supports the following asset types:

• Uri
• AdobeAssetFile
• Bitmap
• InputStream

Be sure to update to the new sendToDesktop() method, passing in your asset type of choice.

Examples:

/* Uri */
AdobeSendToDesktopApplication.sendToDesktop(mSelectedImageUri, "image/jpeg", creativeCloudApplication, sendToDesktopCallBack);

/* InputStream */
AdobeSendToDesktopApplication.sendToDesktop(inputStream, "Filename", "image/jpeg", creativeCloudApplication, sendToDesktopCallBack);

/* AdobeAssetFile */
AdobeSendToDesktopApplication.sendToDesktop(mAdobeAssetFile, creativeCloudApplication, sendToDesktopCallBack);

/* Bitmap */
AdobeSendToDesktopApplication.sendToDesktop(bitmap, "Filename", creativeCloudApplication, sendToDesktopCallBack);