diff options
Diffstat (limited to 'files/es/mozilla/toolkit_version_format/index.html')
| -rw-r--r-- | files/es/mozilla/toolkit_version_format/index.html | 61 |
1 files changed, 61 insertions, 0 deletions
diff --git a/files/es/mozilla/toolkit_version_format/index.html b/files/es/mozilla/toolkit_version_format/index.html new file mode 100644 index 0000000000..9d4de58b0b --- /dev/null +++ b/files/es/mozilla/toolkit_version_format/index.html @@ -0,0 +1,61 @@ +--- +title: Formato para la versión del Toolkit +slug: Mozilla/Toolkit_version_format +tags: + - Toolkit API +translation_of: Mozilla/Toolkit_version_format +--- +<p>Este documento es una referencia para el formato de versión, tal como se usa en Firefox 1.5 (<a href="es/XULRunner">XULRunner</a> 1.8) y posteriores. Este formato se usa por el administrador de extensiones, la actualización de software y otras partes de la plataforma. Las versiones en, al menos, los siguientes lugares deben ser conformes a este formato:</p> +<ul> + <li>La <a href="es/Instalar_el_manifest#version">versión</a> del complemento y la <a href="es/Instalar_el_manifest#targetApplication">aplicación de destino</a> en el manifiesto de <a href="es/Instalar_el_manifest">instalación</a> y de <a href="es/Instalar_el_manifest#updateURL">actualización</a>.</li> + <li>Las siguientes preferencias: <code>app.extensions.version</code>, <code>extensions.lastAppVersion</code>.</li> + <li>Versiones devueltas por <a href="es/NsIXULAppInfo">nsIXULAppInfo</a>.</li> + <li><a href="es/XUL_Application_Packaging"><code>application.ini</code></a> en aplicaciones <a href="es/XULRunner">XULRunner</a>.</li> + <li><a href="es/Chrome_Registration#appversion">Modificador appversion</a> en los <a href="es/Chrome_Registration">manifiestos de chrome</a>.</li> +</ul> +<p>Puede usar <a href="es/NsIVersionComparator">nsIVersionComparator</a> para comparar versiones de su aplicación.</p> +<p>Véase {{ Anch("Formatos de versión previas") }} más abajo para una descripción del formato de versión anterior usado en Firefox/Thunderbird 1.0.</p> +<h3 id="Formato_de_versi.C3.B3n" name="Formato_de_versi.C3.B3n">Formato de versión</h3> +<p>Una <b>cadena de versión</b> consiste en una o más <i>partes de versión</i>, separadas con puntos.</p> +<p>Cada <b>parte de versión</b> es en sí misma interpretada como una secuencia de cuatro partes: <tt><número-a><cadena-b><número-c><cadena-d></tt>. Cada una de las partes es opcional. Los números son enteros en base 10 (pueden ser negativos); las cadenas son ASCII.</p> +<p>Algunos ejemplos de partes de versión válidas:</p> +<ul> + <li><tt>0</tt> (como en <tt>1.0</tt>): <tt><número-a>=0</tt></li> + <li><tt>5a</tt> (como en <tt>1.5a</tt>): <tt><número-a>=5</tt>, <tt><cadena-b>=a</tt></li> + <li><tt>5pre4</tt> (como en <tt>3.5pre4</tt>): <tt><número-a>=5</tt>, <tt><cadena-b>=pre</tt>, <tt><número-c>=4</tt></li> + <li><tt>*</tt> (como en <tt>1.0.*</tt>): <tt><cadena-b>=*</tt></li> +</ul> +<p>Se aplican algunas reglas especiales de interpretación con el fin de proporcionar compatibilidad hacia atrás y legibilidad:</p> +<ul> + <li>si la parte de versión es un solo asterisco, se interpreta como un número infinitamente largo:<br> + <tt>1.5.0.*</tt> es lo mismo que <tt>1.5.0.<i>(infinito)</i></tt></li> + <li>si cadena-b es un signo más, número-a se incrementa para ser compatible con el formato de versión de Firefox 1.0.x:<br> + <tt>1.0+</tt> es lo mismo que <tt>1.1pre</tt></li> +</ul> +<p>La lógica tras el particionado de una parte de versión en una secuencia de cadenas y números es que, cuando se comparan partes de versión, las partes numéricas se comparan como números, por ejemplo: '1.0pre1' < '1.0pre10', mientras que las cadenas se comparan byte a byte. Véase la siguiente sección para obtener detalles sobre cómo se comparan las versiones.</p> +<h3 id="Comparar_versiones" name="Comparar_versiones">Comparar versiones</h3> +<p>Cuando se comparan dos cadenas de versión, sus partes de versión se comparan de izquierda a derecha. Una parte de versión vacía o no presente equivale a <code>0</code>.</p> +<p>Si en algún punto una parte de una cadena de versión es mayor que la parte correspondiente de otra cadena de versión, entonces la primera cadena de versión es mayor que la otra.</p> +<p>En caso contrario, las cadenas de versión son iguales. Observe que, puesto que las partes de versión no presentes se tratan como si fueran <code>0</code>, las siguientes cadenas de versión son iguales: <code>1</code>, <code>1.0</code>, <code>1.0.</code>, <code>1.0.0</code>, e incluso <code>1.0...</code></p> +<h4 id="Comparar_partes_de_versi.C3.B3n" name="Comparar_partes_de_versi.C3.B3n">Comparar partes de versión</h4> +<p>Las partes de versión también se comparan de izquierda a derecha; las partes A y C se comparan como números, mientras que las partes B y D se comparan byte a byte. Una parte de tipo cadena que exista es siempre menor que una parte de tipo cadena no existente (<tt>1.6a</tt> es menor que <tt>1.6</tt>).</p> +<h3 id="Ejemplos" name="Ejemplos">Ejemplos</h3> +<pre class="eval">1.-1 +< 1 == 1. == 1.0 == 1.0.0 +< 1.1a < 1.1aa < 1.1ab < 1.1b < 1.1c +< 1.1whatever +< 1.1pre == 1.1pre0 == 1.0+ +< 1.1pre1a < 1.1pre1aa < 1.1pre1b < 1.1pre1 +< 1.1pre2 +< 1.1pre10 +< 1.1.-1 +< 1.1 == 1.1.0 == 1.1.00 +< 1.10 +< 1.* < 1.*.1 +< 2.0 +</pre> +<h3 id="Formatos_de_versi.C3.B3n_previas" name="Formatos_de_versi.C3.B3n_previas">Formatos de versión previas</h3> +<p>Firefox y Thunderbird 1.0 usaban un formato de versión más simple, en concreto</p> +<pre class="eval">mayor[.menor[.publicación[.compilación]]][+] +</pre> +<p>donde <tt>{{ mediawiki.external('..') }}</tt> designa un componente opcional y <tt>mayor</tt>, <tt>menor</tt>, <tt>publicación</tt> y <tt>compilación</tt> son todos enteros no negativos.</p> |