Directrius sobre els números de versió¶
La plataforma d’Extensions de Blender no requereix cap esquema de numeració de versions concret, de manera que si ja teniu un esquema de versionat que utilitzeu per a la vostra extensió, no dubteu a seguir utilitzant-lo.
No obstant això, si no teniu cap esquema previ de numeració de versions, us recomanem seguir les directrius següents.
Extensions de complements¶
Les extensions haurien de seguir l’esperit del versionat semàntic.
El versionat semàntic va ser dissenyat per a biblioteques de programari amb APIs i això no és ben bé el que són (típicament) els complements. Més aviat, els complements proporcionen funcionalitats de cara a la usuària i, per tant, el versionat semàntic no hi és estrictament d’aplicació.
En tot cas, recomanem de seguir l'esperit del versionat semàntic amb complements de la següent manera:
Els números de versió haurien d’emprar el format MAJOR.MENOR.PEDAÇ, (p. ex. 2.3.1).
El nombre MAJOR hauria d’incrementar-se per als canvis que eliminen o alteren una funcionalitat existent de tal manera que les usuàries ja no poden simplement seguir utilitzant el complement com abans. Regles generals:
Si la nova versió no funciona amb les dades creades per a/per la versió anterior, incrementeu el número MAJOR.
Si la usuària necessita tornar a aprendre alguna cosa no trivial sobre el complement per continuar utilitzant-lo com fins ara, incrementeu el número MAJOR.
El número MENOR s’ha d’incrementar quan s’introdueix una nova funcionalitat, però sense afectar significativament la funcionalitat existent. Regla general:
Si s’ha introduït una nova funcionalitat, però la usuària la pot simplement ignorar (si vol) i continuar treballant amb el complement tal com estava, incrementeu el número MENOR.
El número de PEDAÇ s’hauria d’incrementar per a correccions d’errors i petits canvis que no afectin la funcionalitat prevista del complement. Regla general:
Si la nova versió no és sensiblement diferent des de la perspectiva de la usuària final, correccions d’errors a part, incrementeu el número de PEDAÇ.
Aquestes directrius no preveuran totes les situacions possibles, però és d’esperar que donin una bona idea de com abordar els casos més habituals. Les desenvolupadores d’extensions haurien d’aplicar el seu millor criteri a l’hora de tractar situacions no previstes per aquestes directrius.
Extensions de tema¶
Les extensions de tema no tenen la mateixa consideració que les extensions de complements i, per tant, no cal que segueixin res semblant al versionat semàntic. En comptes d’això, recomanem seguir aquestes pautes:
Els números de versió haurien d’utilitzar un format X.Y.Z (p. ex. 2.3.1).
X s’hauria d’incrementar per a canvis visuals «substancials» o reelaboracions del tema.
Y s’hauria d’utilitzar per a les «branques» del tema de diferents versions de Blender (vegeu més avall).
Z s’hauria d’incrementar en cas de petits retocs visuals o correccions d'»errors» visuals.
Rastreigs¶
Les noves versions de Blender de vegades poden introduir canvis importants a l’API de Python de Blender o fins i tot canviar el funcionament de funcions senceres. Si això afecta la vostra extensió, és possible que vulgueu mantenir dues «branques» de la vostra extensió simultàniament: una per al Blender «antic» i una altra per al Blender «nou».
Podeu utilitzar la numeració de versions per apanyar-ho d’una manera raonablement clara. Per exemple, si la vostra extensió actualment està a la versió 1.2.1 i voleu publicar una nova versió per a canvis importants del Blender «nou», podeu publicar aquesta nova versió com a versió 1.3.0. Aleshores, si necessiteu fer correccions d’errors a la versió «antiga» de l’extensió per al Blender, encara podeu incrementar el número de pedaç a 1.2.2, 1.2.3, etc. De fet, 1.2.x i 1.3.x són dues «branques» diferents de l’extensió, cadascuna de les quals pot continuar acollint noves distribucions.
Alternativament, podeu incrementar el número de versió principal en les branques, sobretot si esteu pensant de fer més que només correccions d’errors de les branques més antigues. Sigui com sigui, us recomanem fermament que no incrementeu només la versió del pegat per a aquest tipus d’actualitzacions: no se sap mai quan us pot sortir la necessitat de publicar una distribució de correcció d’errors.
Nota
Assegureu-vos d’indicar correctament les versions de Blender amb les quals és compatible cada versió de la vostra extensió al seu document de manifest. També podeu actualitzar la compatibilitat de versió de Blender de versions ja carregades del vostre complement des del lloc web d’extensions.