Estabilidade da API

Um produto é caracterizado pela distribuição periódica de mudanças visando sua evolução e estabilização. Cada uma dessas distribuições é considerada uma nova versão do produto e recebe uma número que as identifique unicamente.

O Lumis Portal pode ser distribuído de várias formas diferentes, de acordo com a natureza das modificações e a necessidade ou agilidade.

Versão: Caracteriza-se pela distribuição do produto completo, com todas as funcionalidades e componentes, com as respectivas documentações e rotinas de instalação e upgrade de versões anteriores.

A versão do Lumis Portal é representada por 4 partes constituintes, separadas por um ponto:

Hotfix: Caracteriza-se por um pacote que contém uma ou mais modificações pontuais, normalmente correção de defeitos. É distribuído para ser aplicado em uma versão imediatamente anterior. Este pacote atualiza o produto para uma versão mais nova, cujo número corresponde a uma "Build".

Service Pack: Caracteriza-se por uma pacote que pode conter alterações em funcionalidades atuais, novas funcionalidades e várias correções de defeitos. É distribuído para ser aplicado em uma versão anterior. Este pacote atualiza o produto para uma versão mais nova, cujo número corresponde a uma "Release".

As API's do framework do Lumis Portal podem estar nos seguintes níveis de estabilidade:

•	"Stable Major": significa que, uma vez que a API pública de um objeto alcança este nível de estabilidade, todas as releases subsequentes do produto, com o mesmo número de versão "Major" são, garantidamente, "backwards compatible";

Este nível de estabilidade está representado na definição da classe do objeto estável, da seguinte forma:

O atributo version informar a versão corrente estável da API; e o atributo sinceVersion informa desde qual versão a API está compatível com a versão corrente (version).

•	"Stable Minor": significa que, uma vez que a API pública de um objeto alcança este nível de estabilidade, todas as releases subsequentes do produto com o mesmo número da versão "Major" e número da versão "Minor" são, garantidamente, "backwards compatible";

Este nível de estabilidade está representado na definição da classe do objeto estável, da seguinte forma:

•	"Volatile": significa que, a API pode ser alterada em alguma build subsequente ou release do produto, e não há garantias de "backwards compatibilidade". Este nível de estabilidade não é representado na definição da classe do objeto não estável.

Se não há anotações referentes ao "StableMajor" ou "StableMinor" na definição da classe do objeto, deve-se assumir que tal objeto não é estável.