Creating Adobe Launch Extension : Release your Extension

This article is going to be a complement on the one from Adobe public documentation.

On my part, I found the documentation quite restrictive on that part. It seems pretty obvious for the technical writer but it is not for me. Having extra explanation than the ones provided here are always welcome and for that this article come into play.

When you are finish with the development of your extension and it has been uploaded correctly in the launch server, you would need to call the Adobe IO API in order to release your extension.

The documentation provides a a nice example on how this can be done with a curl command :

This implies that you have established a connection to Adobe IO before.
In case you didn’t do it, here are some tips or good to know things for that :

  1. Go to adobe.io
  2. Add a new API connection service
  3. Upload the .CRT required for JWT authentication (my article about JWT)
  4. Relax because you are on my blog and I won’t let you alone now

Once you have your information, you request the token directly in the console through the JWT tab. However we are on a JavaScript and Python blog so it would be a shame to not enjoy this opportunity to provide you with a python script to release your extension. 🙂

The most important part of the token request is that part : “https://ims-na1.adobelogin.com/s/ent_reactor_admin_sdk”:True

This is what is going to link your token to the correct service. If you forget about it, it will not allow you access to the extension creation. So make sure you have this part.

The following part, once you have released your extension, I find it a bit cryptic.

“Once you have released your extension, you can no longer make changes to it and you cannot unrelease it. Once released, bug fixes and feature additions are accomplished by POSTing a new version of your extension package and following the above testing and release steps on that new version.”

You need to make sure that you want to stick with this extension before creating it as it is not possible to unpublish it.
I would imagine that this will be possible in the future.

With the improvement of the Launch API and eco system. It will probably be a necessity at some point in order to clean the extension catalogue.

However, you would need to go through the process of creating a new extension in order to update the one you have released.
Keeping the same name and increasing the versioning is required for the upgrade.

When you are uploading the extension in the production library after your release, you should see a message like this :

“An existing extension package with the name XXX was found on the server, but because its availability is not development, a development version of the extension package will be created.”

This will allow you to test the same way that you did before.

In order to publish it, you will have to publish the extension the same that we did but taking the new ID that has been generated during you last QA process by the @adobe/reactor-uploader method.

I hope this article helped you to understand how to publish and update your extensions and now : “Happy coding!”

On this series, you may want to check those articles :

ArticleContent
Introdcution to Adobe Launch & Extension Creation This posts covers the basic of what you need to know in order to start with this series of articles.
Architecture and dependencies within modules This posts covers the architectures and how the different modules are linked between each others
Global Extension Configuration This article explains how to set up your configuration HTML file. It is the core configuration module of your extension.
Event type module This article will show you how to build an event module. Every module will have a configuration part (HTML) and wrapper(JS).
Condition module
This article will show you how to build a condition module.
Action module This post will be related to the action module and how to build it. We will also see how you can actually import some cool feature of the launch library.
Data Element moduleThis article will be developing the possibilities of the Data Element module
Shared moduleThis article will focus on the shared functionality that you can write and share with other extension developpers to used. We will also used a feature shared from Adobe Analytics to show you how to use it.
Other featuresThe other features that are related to Launch Extension. I will cover additional (and important) information there.
Testing your extensionHow do I debug my Extension ?
Releasing and updating your ExtensionHow do I publish my Extension into Launch ? And after, how do you update it ?

One thought on “Creating Adobe Launch Extension : Release your Extension

  1. Awesome script !
    I tried several methods (Postman, command line etc…), but your Python script has finally been the working solution for me to release my extension.
    Many thanks for your help !
    Guillaume

Leave a Reply to Guillaume Cancel reply

Your email address will not be published. Required fields are marked *