PhoneGap Plugin Roundup

Posted on Tuesday, September 20th, 2016 by Ash Ryan
Categories: Android, iOS, Web
Tags: Client Auth, Image Editor UI, PhoneGap, Send To Desktop API, User Auth UI

PhoneGap Logo

We’ve had a lot of PhoneGap news recently, with the release of our first 4 PhoneGap plugins and 2 PhoneGap templates.

PhoneGap makes it possible for Web developers to build apps for iOS and Android using the languages they know and love: HTML, CSS, and JavaScript. Our PhoneGap plugins are also compatible with Cordova and Ionic.

Creative SDK Image Editor PhoneGap template

Image Editor UI PhoneGap plugin

Creative SDK Send To Desktop API PhoneGap plugin

Send To Desktop API PhoneGap plugin

Learn more

For an overview of these new offerings, head over to the PhoneGap blog, where they talk about the Image Editor UI plugin, Send To Desktop API plugin, and more!

To see all of the Creative SDK PhoneGap plugins and templates, also be sure to check out the Plugins section of the Creative SDK GitHub page.

If there’s another Creative SDK PhoneGap plugin you’d like to see, let us know in the comments!

PhoneGap template for the Creative SDK Send To Desktop API

Posted on Wednesday, September 7th, 2016 by Ash Ryan
Categories: Android, iOS, Web
Tags: Client Auth, Image Editor UI, PhoneGap, Send To Desktop API, User Auth UI

PhoneGap Logo

Hi Web developers! We’ve had a lot of PhoneGap + Creative SDK announcements for you recently. We announced our first PhoneGap plugins, a PhoneGap template for the Image Editor, and another batch of PhoneGap plugins.

As a companion to that second batch of plugins, today we are releasing a PhoneGap template for the Creative SDK Send To Desktop API.

A template is a great way to start learning about a PhoneGap plugin. Templates are essentially sample apps that you can download via NPM, build from your command line, and run on your device (these plugins support iOS and Android).

When you try out the Creative SDK Send To Desktop PhoneGap template, without writing any code, you’ll have a sample app for your reference that looks like this:

Creative SDK Send To Desktop API PhoneGap plugin

In the template app, you can:

Try it out

You can get started with the Creative SDK Send To Desktop template for PhoneGap by checking out the repo on GitHub.

The README covers everything you need to get going, including prerequisites, setup steps, and files to check for sample code.

Learn more

After you’ve tried the template and you’re ready to learn more about the plugins that make the template possible, check out these GitHub repos:

The READMEs for the plugin repos on GitHub contain Setup and API guides, as well as sample code, to help you get started quickly.

If there’s another Creative SDK PhoneGap plugin you’d like to see, let us know in the comments!

New PhoneGap plugins: Send To Desktop API and User Auth UI

Posted on Tuesday, August 30th, 2016 by Ash Ryan
Categories: Android, iOS, Web
Tags: Client Auth, Image Editor UI, PhoneGap, Send To Desktop API, User Auth UI

PhoneGap Logo

Hi Web developers! Joining our first two PhoneGap plugins, we’re excited to announce a new batch of plugins that let you use the Creative SDK in your PhoneGap app.

Adobe PhoneGap lets you easily create apps using the web technologies you know and love: HTML, CSS, and JavaScript.

With our growing catalogue of PhoneGap plugins, you can build apps using the Creative SDK native components for iOS and Android without writing a single line of Objective-C, Swift, or Java.

About the plugins

Our newest plugins make available the Creative SDK Send To Desktop API and User Auth UI components.

With the Send To Desktop API plugin, your users can send images from your mobile app and have them open automatically in Photoshop, Illustrator, or InDesign on the desktop.

For the user, this interaction feels like magic; for the developer, it’s a single function call.

Send To Desktop API

Send To Desktop API: Send images from your app to Photoshop, Illustrator, or InDesign

The Send To Desktop workflow makes use of the user’s Adobe Creative Cloud account, which you can access via the User Auth UI plugin.

All of the heavy lifting for User Auth login and logout is handled by the plugin, making the integration quick and simple to set up.

Get the plugins

Check out our PhoneGap plugins on GitHub:

  • Client Auth: The starting point for all Creative SDK integrations
  • Image Editor UI: Powerful photo editing for mobile apps
  • New! User Auth UI: Let users log in to their Adobe Creative Cloud accounts, right from within your app
  • New! Send To Desktop API: Magically send images from mobile to Photoshop, Illustrator, or InDesign

The READMEs for the plugin repos contain Setup and API guides, as well as sample code, to help you get started quickly.

We’ll have more Creative SDK + PhoneGap news for you soon. As always, feel free to reach out if you have any requests related to our PhoneGap plugins.

(Oh, and while you’re digging in, try out our PhoneGap template for the Image Editor!)

PhoneGap plugins for the Creative SDK

Posted on Friday, August 19th, 2016 by Ash Ryan
Categories: Android, iOS, Web
Tags: Client Auth, Image Editor UI, PhoneGap

PhoneGap Logo
(Update: you can also check out our latest batch of plugins after reading this article.)

Hi Web developers! We’re excited to announce our first PhoneGap plugins for the Creative SDK.

PhoneGap lets you easily create apps using the web technologies you know and love: HTML, CSS, and JavaScript.

We’ve been working in collaboration with the Adobe PhoneGap team to bring the power of the Creative SDK to even more developers with PhoneGap. Now, you can take advantage of the Creative SDK native components for iOS and Android without writing a single line of Objective-C, Swift, or Java.

Get the plugins

As of today, you can start using these Creative SDK PhoneGap plugins:

(Update: be sure to check out our latest batch of plugins too.)

The READMEs for the plugin repos contain Setup and API guides, as well as sample code, to help you get started quickly.

We have more PhoneGap plugins on the way. In the meantime, if you have a request for a PhoneGap plugin for a specific Creative SDK component, let us know in the comments!

We’ve got GitHub repos

Posted on Thursday, March 24th, 2016 by Ash Ryan
Categories: Android, iOS, Web
Tags: Asset Browser UI, Client Auth, GitHub, Image Editor UI, Repo, Send To Desktop API, User Auth UI

Adobe Creative SDK repos on GitHub

When you start your Creative SDK integration, the best place to learn what the SDK can do for your app is to check out our developer guides for your platform. The guides walk you through step-by-step example integrations for each Creative SDK component, complete with code snippets and screenshots.

But sometimes you just want to see top-to-bottom working code.

If that’s the case for you, go have a look at our GitHub repos for iOS, Android, and Web. These Getting Started repos contain multiple apps that accompany the developer guides on our portal.

For example, if you’re looking to integrate the Asset Browser UI component on Android, see the example app in our Android GitHub repo. The code in this app mirrors what is covered in our Asset Browser UI guide.

Our current developer guide and GitHub repo offerings

We offer GitHub repos and companion developer guides for iOS, Android, and Web.

The lineup will naturally change over time. You can check the latest developer guides on our developer portal, and the latest repos on our GitHub org.

We hope the example GitHub repos make it easy for you to get up and running with the Creative SDK.

Head on over to GitHub to fork a repo and try out our Creative SDK example apps.

Comparing Adobe Client Auth and Aviary Client Auth

Posted on Tuesday, October 27th, 2015 by Ash Ryan
Category: Android
Tags: Client Auth, Image Editor UI

Hi Android developers! When integrating the Creative SDK, client authentication is an essential step to getting your app started. We have details for how to begin with client auth in our Getting Started guide for Android.

But have you noticed that the Creative SDK offers two different interfaces for client auth? When implementing client auth you’ll need to choose either IAdobeAuthClientCredentials or IAviaryClientCredentials.

Let’s have a look at the difference.

Note: This post will assume that you have already obtained your Client ID and Secret from the My Apps page on creativesdk.adobe.com (login required).

Contents

Implementing IAdobeAuthClientCredentials

The standard client auth interface for the Creative SDK is IAdobeAuthClientCredentials.

To implement this interface, create a class that extends Application. You can name the class whatever you want; in this post, we will call it MainApplication.

In the new class be sure to:

  1. Provide your Client ID and Secret
  2. Initialize the Creative SDK Foundation in `onCreate()`
  3. Provide the interface methods that return:
    1. the Client ID
    2. the Client Secret

Here’s an example, with the steps above numbered in the comments:

public class MainApplication extends Application implements IAdobeAuthClientCredentials {

    /* 1 */
    private static final String CREATIVE_SDK_CLIENT_ID = "<YOUR_ID_HERE>";
    private static final String CREATIVE_SDK_CLIENT_SECRET = "<YOUR_SECRET_HERE>";

    /* 2 */
    @Override
    public void onCreate() {
        super.onCreate();
        AdobeCSDKFoundation.initializeCSDKFoundation(
                getApplicationContext(),
                AdobeAuthIMSEnvironment.AdobeAuthIMSEnvironmentProductionUS
        );
    }

    /* 3.A */
    @Override
    public String getClientID() {
        return CREATIVE_SDK_CLIENT_ID;
    }

    /* 3.B */
    @Override
    public String getClientSecret() {
        return CREATIVE_SDK_CLIENT_SECRET;
    }
}

The IAdobeAuthClientCredentials interface is sufficient for most components of the Creative SDK, like the Asset Browser UI, the Send To Desktop API, and more.

The single exception to this is the Image Editor UI component, which we will discuss below.

Implementing IAviaryClientCredentials

For apps that integrate the Creative SDK Image Editor UI component, it is necessary to implement the IAviaryClientCredentials interface.

IAviaryClientCredentials extends IAdobeAuthClientCredentials. This means that you only have to implement the Aviary Client Auth interface and you’re covered for both the Image Editor UI component and any other Creative SDK components your app uses.

To implement IAviaryClientCredentials, we can use the same class from the code example above, but we need to make two changes:

1. Change the interface

    public class MainApplication extends Application implements IAviaryClientCredentials {
        // ...

2. Add the method getBillingKey()
This method should return your billing key:

        // ...

        @Override
        public String getBillingKey() {
            return "";
        }

        // ...

If your Image Editor UI integration will not contain In-app Billing items, the getBillingKey() method should return an empty string, as shown in the code sample above.

If your Image Editor UI integration will contain In-app Billing items, the method should return your Base64-encoded RSA public key. This key can be found in your Google Play console at:
“Google Play Console” -> “All applications” -> (your application) -> “Services & APIs”

You can learn more about In-app Billing on developer.android.com.

Adding the new class to your Android Manifest

Regardless of which client auth interface you use, don’t forget to add the new class to your Android Manifest, using the android:name attribute:

<!-- ... -->

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme"
        android:name=".MainApplication">

<!-- ... -->        

While the Creative SDK offers two client auth interfaces, it’s fairly simple to choose which one you need.

If your app integrates the Image Editor UI component, use IAviaryClientCredentials. Otherwise, go with the standard IAdobeAuthClientCredentials.

To learn more about the Creative SDK for Android, check out the documentation at creativesdk.adobe.com!