RWS Community
RWS Community
  • Site

Trados Studio

Trados Team

Trados Accelerate

Trados Enterprise

Trados GroupShare

Passolo

MultiTerm

RWS AppStore

Connectors

Beta Groups

Managed Translation

MultiTrans

TMS

Trados Enterprise

WorldServer

Language Weaver

Language Weaver Edge

Language Weaver Connectors

Language Weaver in Trados Studio

 

 

Content Champions

Tridion Docs

Tridion Sites

Contenta

LiveContent

XPP

Trados Studio Ideas

Trados GroupShare Ideas

Trados Team Ideas

Trados Team Terminology Ideas

Trados Enterprise & Accelerate Ideas

MultiTerm Ideas

Passolo Ideas

RWS Appstore Ideas

Tridion Docs Ideas

Tridion Sites Ideas

Language Weaver Ideas

Language Weaver Edge Ideas

Managed Translation - Enterprise Ideas

TMS Ideas

WorldServer Ideas

Trados Enterprise Ideas

XPP Ideas

GroupShare Developers

Language Cloud Developers

MultiTerm Developers

Passolo Developers

Trados Studio Developers

Managed Translation Developers

TMS Developers

WorldServer Developers

Tridion Docs Developers

XPP Developers

Language Combinations by Language Services

RWS Training & Certification

Style Guides

LDE Korean Vendor Support

RWS Campus

Trados Approved Trainers

Nordic Tridion Docs User Group

Tridion West Coast User Group

Community Ops

RWS Community Internal Group

AURORA

Internal Trados Ideas

Linguistic Validation

Mercury

QA Tools

RI Operational Excellence

Trados Inspired

XPP Cloud

Recognition & Reward System

RWS Community Platform Related Questions

Community Solutions Hub (Trados)

About RWS

Events

RWS Services: Train AI & others

RWS Training & Certification

To RWS Support

  • Search
  • Translate

    Detecting language please wait for.......


    Powered by
  • User
  • Site
  • Search
  • User
  • Developers
  • Trados Portfolio
  • Trados Studio Developers
  • More
  • Cancel
Trados Studio Developers

Trados Studio Developers > Studio Developers WIKI

03 Plugin manifest file convention
  • Home
  • Trados Studio developers forum
  • Studio Developers WIKI
  • Studio Developers Blog
  • More
  • Cancel
  • New
Show Translation Options

Detecting language please wait for.......


Powered by
Trados Studio Developers requires membership for participation - click to join
  • -Trados Studio API
    • Developer Licences
    • -Getting Started
      • +01 Development Environment
      • 02 Studio APIs Documentation
      • 03 Plugin manifest file convention
      • 04 Developer Webinar Recordings
      • 05 What is Fiddler and how to use it
      • 06 Submitting apps for signing and/or publication
    • +Knowledgebase

03 Plugin manifest file convention

It is possible for users to be notified through Studio of an updated plugin that is made available on the SDL Appstore.  In order for this to work effectively it is important that all developers who list their plugins on the Store follow a particular convention.  The reason for needing an agreed convention is that there is a strong connection between the pluginpackage.manifest information and the plugin plugin record from the Store. In order to have a better user experience (read: for this to work!) on the AppStore website we have put in place some conventions, which will be described bellow.

Description

Is important that the Description from the manifest file is meaningful.  This will be seen in the plugin manager and will be used as we continue to develop the integration of the AppStore into Studio.

Plugin name

The plugin name from the manifest file should match the name of the plugin from the AppStore.  Aside from the obvious inconsistency the notifications will not work if this doesn't match.

Incorrect

Pluginpackage.manifest.xml

AppStore web site

Correct

This change will also make it easier for users to identify the app names in the plugin manager which is important when it comes to knowing which apps to remove.

Plugin version

Because there are multiple versions of Studio available, the plugin version must be different for each Version of Studio otherwise we cannot determine which one to use.  This applies to the version numbering before the Studio version in brackets which is simply text added when you submit the plugin to the AppStore.  So in the AppStore the user sees something like this when downloading their apps.

An Incorrect Versioning as both are 2.0.0.0

Correct Versioning

The Studio version name in brackets helps the user to identify the version they want when downloading from the AppStore manually.  The plugin manifest should only contain the semantic versioning convention described below.:

Version Number ( Studio Version) 

No extra special characters should be added in the App Record.  The version number itself should follow a semantic versioning specification as described below:

  • MAJOR version when you make incompatible API changes,
  • MINOR version when you add functionality in a backwards-compatible manner,
  • PATCH version when you make backwards-compatible bug fixes, and
  • INTERNAL version as the builds are released to testing

This means the following would be unnacceptable for example:

1.0
2.4.1

They should be:

1.0.0.0
2.4.1.0

This may not be the convention used by everyone but in order to ensure the best possible experience for users this is the convention to be followed.  It will mean that users will be notified correctly when there is an update available to a plugin that is currently being used in Studio, for example:

Tags:

AppStoreIntegration
PluginManifestFile
  • Share
  • History
  • More
  • Cancel
Related
Recommended
  • Our Terms of Use
  • Copyright
  • Privacy
  • Security
  • Anti-slavery Statement
  • Cookie Notice
  • YouTube